Version 3.7 야후! 지도 AJAX API – 클래스 참조문서

현재의 지도 타입을 설정

파라미터들:

• YAHOO_MAP_REG,YAHOO_MAP_SAT, YAHOO_MAP_HYB와 같이 getMapTypes()로부터 리턴되는 것과 같은 상수값

Return value: void

Return value: 현재의 지도 타입 상수값

Return value: 지도 타입들의 배열 [YAHOO_MAP_REG, YAHOO_MAP_SAT, YAHOO_MAP_HYB]

기본적으로 3가지 컨트롤들을 오버레이로 추가함

파라미터들:

• 지도 타입 배열은 선택적(Optional)으로 사용할 수 있다.

Return value: void

지도 위에 지정된 특정 위치에 마커를 추가함

파라미터들:

• 지도의 위도/경도 오브젝트인 YGeoPoint
• 마커에 부여될 DOM 엘리먼트 id(선택사항).

Return value: void

지도 위에 오버레이 오브젝트를 추가하며 YGeoPoint와 YCoordPoint타입으로 된 오브젝트(마커,스마트윈도우,컨트롤)를 추가 할 수 있음.

파라미터들:

• YCustomOverlay, YMarker와 같은 오버레이 오브젝트

Return value: void

lat/lon 오브젝트를 x/y 좌표 지점으로 변환

파라미터들:

• 변환하고자 하는 lat/lon 의 YGeoPoint

Return value: YCoordPoint

x/y 좌표 지점을 lat/lon 오브젝트로 변환

파라미터들:

• 변환하고자 하는 YCoordPoint - 오브젝트

Return value: YGeoPoint

지도를 그려주는 메인 메소드.

파라미터들:

• 지역타입 - YGeoPoint나 "서울","New York"과 같은 적합한 주소 문자열
• 1~16사이중 원하는 줌레벨

Return value: void

지도의 좌상단,우하단에 대한 lat/lon지점 값을 리턴해 줌.

Return value: LatMax, LonMax, LatMin, LonMin를 속성으로 하는 오브젝트

지도의 중심에 해당하는 lat/lon 오브젝트를 리턴.

Return value: YGeoPoint 오브젝

MarkerID에 의해 식별된 마커 오브젝트를 리턴함.

파라미터들:

• MarkerID

Return value: YMarker 타입 오브젝트

지정된 줌레벨에서의 각 픽셀 사이의 거리를 리턴함.

파라미터들:

• ZoomLevel1-16사이의 정수 (기본값은 현재의 줌 레벨)

Return value: miles, kilometers 오브젝트

input에 값이 없을 경우 현재의 줌 레벨을 리턴함

파라미터들:

• input 선택사항. 아래와 같은 형식으로 입력 받을 수 있음.
  • 입력값이 YGeoPoint의 배열이라면 가장 적합한 줌 레벨이 리턴 됨.
  • 입력값이 YMapDistance 오브젝트라면 해당 거리에서 가장 적합한 줌 레벨이 리턴 됨.

Return value: 기본값은 1-16사이의 현재 줌 레벨이며, YGeoPoint들이 배열로 입력될 경우는 최적화된 줌레벨을 리턴함.

줌 레벨과 YGeoPoint속성을 가지는 오브젝트를 리턴.

파라미터들:

• input YGeoPoint 오브젝트들의 배열

Return value: 줌 레벨과 YGeoPoint 속성을 가지는 오브젝트

주어진 lat/lon위치로 지도를 이동

파라미터들:

• YGeoPoint - 지도의 경위도 오브젝트

Return value: void

주어진 x/y 지점으로 지도를 이동

파라미터들:

• YCoordPoint -

Return value: void

주어진 ID로 마커를 제거함

파라미터들:

• id - YMarker 오브젝트의 ID

Return value: void

지도에서 지정된 오버레이 오브젝트를 제거함

파라미터들:

• overlayObject - 오버레이 오브젝트

Return value: void

주어진 YSize오브젝트로 지도를 새로운 크기로 리사이즈함

파라미터들:

• YSize - width/height 오브젝트

Return value: void

줌 선택 범위에 제약을 줌

파라미터들:

• minZoomLevel - 적합한 범위 내에서의 정수
• maxZoomLevel - 적합한 범위 내에서의 정수

Return value: void

정의된 YGeoPoint에 새로운 스마트 윈도우를 열게 한다. 스마트 윈도우는 InfoValue를 디스플레이 할 수 있고 InfoValue는 기존에 존재하는 DOM 오브젝트들을 사용 할 수 있음.

파라미터들:

• YGeoPoint
• InfoValue - 문자열 형태. Text, HTML또는 오브젝트로 설정할 수 있다.

정의된 맵 어노테이션 오브젝트를 설정함

파라미터들:

• annotation - 타입의 오브젝트

Return value: void

주어진 맵 인스턴스에서 설정된 어노테이션 오브젝트를 리턴함.

Return value: YMapAnnotation타입의 어노테이션 오브젝트

정의된 타입 포맷으로 현재의 지도에 대한 GEORSS XM을 제공함.

파라미터들:

• type - 적합한 타입은 "GEORSS"

Return value: GeoRSS XML 문자열

YGeoPoint 오브젝트들의 배열을 입력하면 최소, 최대 위치를 리턴함.

파라미터들:

• points - YGeoPoint 오브젝트들의 배열

Return value: 오브젝트 {min:YGeoPoint_MIN,max:YGeoPoint_MAX}

생성된 모든 폴리라인 ID들에 대한 리스트 배열을 리턴.

Return value: ID들의 배열

주어진 ID에 해당되는 폴리라인 오브젝트를 리턴

파라미터들:

• id - 폴리라인 세그먼트의 아이디

Return value: 오브젝트

지도나 마커들에 대한 이벤트 감지.

파라미터들:

• 오브젝트 - Ymap이나 YMarker 오브젝트
• 이벤트 - 감지할 이벤트(아래의 이벤트 리스트 참조)
• 콜백 - 이벤트가 발생하여 감지되었을 때 호출될 함수
• privateObject - 선택적인 private 컨텍스트 오브젝트

Return value: void

이벤트 파라미터는 이벤트리스트 오브젝트의 속성 중 하나여야 한다.(e.g. EventsList.MouseUp):

• endMapDraw
• changeZoom
• startPan
• onPan
• endPan
• endAutoPan
• startAutoPan
• MouseClick
• MouseDown
• MouseDoubleClick
• MouseOut
• MouseOver
• MouseUp
• KeyUp
• KeyDown

YMarker에만 특화된 이벤트

• openExpanded
• closeExpanded
• openSmartWindow
• closeSmartWindow

YGeoRSS에만 특화된 이벤트

• onEndGeoRSS

Ymap에만 특화된 이벤트

• onEndGeoCode
• polylineAdded
• polylineRemoved
• endMapDraw
• onEndLocalSearch
• onEndTrafficSearch

좌표 지점들 사이의 거리를 리턴함.

파라미터들:

• point YCoordPoint 오브젝트

Return value: float

원래의 좌상단 기준점을 다른 기준점으로 변환

파라미터들:

• xcoord 적합한 x 지점 이름 (left, right)
• ycoord 적합한 y 지점 이름 (top, bottom)

Return value: void

두 개의 지점이 같은지 확인함.

파라미터들:

• point YCoordPoint 오브젝트.

Return value: boolean

좌표 지점 사이의 거리를 리턴

파라미터들:

• point YGeoPoint 오브젝트

Return value: 킬로미터, 마일, 픽셀 프라퍼티를 가지는 거리 오브젝트를 리턴한다.

두 좌표 지점간 중간 값을 리턴

파라미터들:

• point YGeoPoint 오브젝트

Return value: YGeoPoint

두 지점이 같은지를 비교.

파라미터들:

• point YGeoPoint 오브젝

Return value: boolean

선택사항 - 마커를 DOM 오브젝트로 식별하는 스트링. 해당 문자열은 숫자 0-9 또는 소문자 a-z 사이의 문자여야 한다. 그리고, ID는 파라미터가 제공되지 않을 경우 자동으로 생성 된다.

추천사항 - 자동으로 API가 생성하는 것을 권장함.

마우스 오버와 클릭 이벤트로 자동으로 닫을 수 있는 자동 확장 윈도우(또는 스마트 윈도우)를 추가 할 수 있다.

파라미터들:

• InfoValue - HTML/Text 문자열. 스마트 윈도우에 사용 될 수 있는 콘텐츠를 보여주는 데 사용할 수 있는 문자열.

제공된 이미지로 마커 이미지를 변경.

자동 확장 윈도우(있다면)를 열게 함.

자동 확장 윈도우(있다면)를 닫음.

지도 위에서 마커들을 숨김.

지도 위에서 숨겨진 마커들을 보이게 함.

현재의 마커가 숨겨져 있는지를 점검.

Return value: boolean

스마트 윈도우 테두리 색상을 정의

파라미터들:

• color 문자열. valid colors: [orange, blue, lightblue, brown, green, lightgreen, grey, black, maroon, ocre, purple]

마커 오브젝트를 (재)설정함.

파라미터들:

• YGeoPoint 오브젝트

마커에 라벨을 추가함.

파라미터들:

• label - 문자열. 마커에대한 HTML또는 Text.

마커에 대한 라벨을 변경

파라미터들:

• label - 문자열. 마커에대한 HTML또는 Text.

마커의 스마트 윈도우를 연다. 스마트 윈도우는 Infovalue를 보여준다. InfoValue파라미터는 기존에 존재하는 DOM 오브젝트일 수도 있다.

파라미터들:

• InfoValue - 문자열. A new text,HTML또는 오브젝트.

스마트 윈도우의 InfoValue를 갱신함.

파라미터들:

• InfoValue - 문자열. A new text,HTML또는 오브젝트.

파라미터들:

• parentId - 부모 객체의 아이디
• childId - 자식 객체의 아이디

Constructor:

YUtility.containerResize(parentId,childId);

내부적으로 사용되는 document.createNode를 캡슐화한 편리한 메소드

파라미터들:

• type - 적합한 HTML 요소 타입 ("div", "img")
• id - HTML 요소 아이디

내부적으로 사용되는 document.appendChild를 캡슐화한 편리한 메소드

파라미터들:

• type - 적합한 HTML 요소 타입 ("div", "img")
• id - HTML 요소 아이디