new naver.maps.ImageMapType(imageMapTypeOptions)
Parameters
Name | Type | Description |
---|---|---|
imageMapTypeOptions |
ImageMapTypeOptions | 이미지 타일 지도 유형 옵션 |
- Implements
- Tutorials
Methods
-
getMapTypeOptions()
-
이미지 타일 지도 유형의 옵션을 반환합니다.
Returns
Type Description ImageMapTypeOptions
이미지 타일 지도 유형 옵션
-
getMaxZoom()
-
지도 유형의 최대 줌 레벨을 반환합니다.
Returns
Type Description number
최대 줌 레벨
-
getMinZoom()
-
지도 유형의 최소 줌 레벨을 반환합니다.
Returns
Type Description number
최소 줌 레벨
-
getName()
-
지도 유형의 이름을 반환합니다.
Returns
Type Description string
지도 유형의 이름
-
getTile(x, y, z)
-
전달된 타일의 인덱스와 줌 레벨에 해당하는
ImageTile
객체를 반환합니다.새로운 타일이 필요할 때마다 이 메서드를 호출합니다. 이때, 이 메서드는 getTileUrls 메서드를 호출합니다.
Parameters
Name Type Description x
number x 축의 인덱스
y
number y 축의 인덱스
z
number 줌 레벨
- Implements
Returns
Type Description naver.maps.ImageTile
이미지 타일 객체
-
getTileUrls(x, y, z)
-
전달된 타일의 인덱스와 줌 레벨에 해당하는 타일 URL을 반환합니다.
새 타일을 지도에 표시해야 한다고 NAVER 지도 API v3가 판단할 때, getTile의
tileSet
속성을 사용하거나getTileUrl
메서드를 호출합니다.Parameters
Name Type Description x
number x 축의 인덱스
y
number y 축의 인덱스
z
number 줌 레벨
Returns
Type Description Array.<string>
타일 URL 목록
-
setMapTypeOptions(imageMapTypeOptions)
-
이미지 타일 지도 유형의 옵션을 설정합니다.
Parameters
Name Type Description imageMapTypeOptions
ImageMapTypeOptions 이미지 타일 지도 유형 옵션
Type Definitions
-
ImageMapTypeOptions
-
ImageMapTypeOptions
객체는ImageMapType
을 정의하는 옵션을 나타냅니다.Type:
Properties
Name Type Argument Default Description name
string 지도 유형 컨트롤 등에서 표시할 지도 유형의 이름입니다.
maxZoom
number 지도 유형의 최대 줌 레벨입니다.
minZoom
number 지도 유형의 최소 줌 레벨입니다.
projection
naver.maps.Projection 지도 유형의 투영입니다. 자세한 설명은 Projection 객체를 참고합니다.
tileSize
naver.maps.Size | SizeLiteral <optional>
(256,256) 지도 유형의 타일 크기입니다.
tileDuration
number <optional>
타일의 fadeIn 효과 지속 시간 (밀리초 단위)
repeatX
boolean <optional>
false 현재 줌 레벨에서 표현할 수 있는 타일 인덱스의 영역을 벗어나면 수평축으로 타일을 반복할 것인지 여부입니다.
세계 지도 투영을 사용하는 이미지 타일 지도 유형에서 사용하기에 적합합니다.
vendor
string <optional>
지도 유형의 제작자 이름입니다.
provider
MapDataProvider <optional>
지도 유형의 데이터 제공자 정보입니다.
uid
string <optional>
지도 유형을 유일하게 구분할 수 있는 id를 지정할 수 있습니다.
darktheme
boolean <optional>
false 지도 유형이 전체적으로 어두운 이미지를 사용하는지를 지정합니다.
이 값이
true
이면 지도 위 텍스트를 표시하는 기본 컨트롤의 텍스트 색상이 흰색으로 표시됩니다.getTileUrl
function <optional>
전달된 타일의 인덱스와 줌 레벨에 해당하는 타일 URL을 반환합니다.
새 타일을 지도에 표시해야 한다고 NAVER 지도 API v3가 판단할 때마다 이 메서드를 호출합니다.
tileSet
string | Array.<string> <optional>
지도의 타일 이미지 URL 또는 URL의 목록을 지정할 수 있습니다.
URL 문자열 내
{x}
,{y}
,{z}
는 타일 인덱스와 줌 레벨로 치환됩니다. 타일 인덱스는 왼쪽 위 기준이며, 타일 인덱스를 반대로 적용하려면{-x}
,{-y}
와 같이-
를 함께 사용합니다.getTileUrl
메서드가 설정되면 이 속성은 무시됩니다.Example
var imageMapTypeOptions = { minZoom: 0, maxZoom: 22, projection: naver.maps.EPSG3857, name: '세계 지도', tileSize: new naver.maps.Size(256, 256), repeatX: true, vendor: 'MyCorp.', provider: [{ title: "내 지도 ver 1.0" }, { title: "OpenStreetMap", link: "http://www.openstreetmap.org/copyright" }, { title: "/인천광역시", bounds: new naver.maps.LatLngBounds( new naver.maps.LatLng(36.915887, 125.690716), new naver.maps.LatLng(37.687529, 126.853252)) }], tileSet: [ "http://mymap1.com/tiles/world/{z}/{x}/{y}.png", "http://mymap2.com/tiles/world/{z}/{x}/{y}.png", "http://mymap3.com/tiles/world/{z}/{x}/{y}.png", "http://mymap4.com/tiles/world/{z}/{x}/{y}.png" ] }; var imageMapType = new naver.maps.ImageMapType(imageMapTypeOptions);
-
MapDataProvider
-
MapDataProvider
객체는 등록한 지도 유형의 데이터 제공자 정보를 나타냅니다.Type:
Properties
Name Type Description title
string 표시될 텍스트의 내용입니다. 빈 칸/Unicode 모두 허용하나, HTML Entity는 변환되지 않습니다.
link
string 표시될 텍스트를 클릭했을 때 이동할 주소입니다. 이 값이 없으면 클릭할 수 없는 요소로 생성됩니다.
bounds
Bounds | BoundsLiteral | ArrayOfBounds | ArrayOfBoundsLiteral 해당 텍스트를 표시할 좌표 경계입니다. 지도 화면에 해당 좌표 경계가 들어오면 텍스트를 표시합니다. 이 값이 없으면 항상 텍스트를 표시합니다.
Example
var mapTypeOptions = { //... provider: [{ title: " 국토교통부", }, { title: ",OpenStreetMap", link: "http://www.openstreetmap.org/copyright" }, { title: ",Natural Earth", link: "http://www.naturalearthdata.com/", bounds: NLatLngBounds( NLatLng(36.915887, 125.690716), NLatLng(37.687529, 126.853252)) }, { title: " \u2573 \xa9 UNICODE ALSO OK", bounds: [ NLatLngBounds( NLatLng(36.9604682, 126.7654746), NLatLng(38.1834428, 127.8062689)), // 서울,경기 NLatLngBounds( NLatLng(33.1940984, 126.1631646), NLatLng(33.5666617, 126.9448023)) // 제주 ] }] };