세션 토큰은
UUID)
REST 호출에서
세션:
일련의 관련 메시지 교환을 포함합니다. 모든
2D 타일 및 스트리트 뷰 이미지에 대한 요청을 처리합니다.
모든 요청에 추가된 session
매개변수의 값으로 이 매개변수를 포함합니다.
URL을 클릭합니다.
Map Tiles API에서 세션 토큰은
표시 옵션 즉,
요청을 수행합니다. 여러 클라이언트에서 동일한 세션 토큰을 사용할 수 있습니다.
세션 토큰은 현재
변경될 수 있습니다 언제든지
응답 메시지에서 expiry
필드를 확인하여 세션 토큰을 일치시킵니다.
세션 토큰 요청
세션 토큰을 요청하려면 createSession
에 HTTPS POST 요청을 전송합니다.
엔드포인트에 연결할 수 있습니다 요청을 보낼 때
Content-Type: application/json
헤더.
curl -X POST -d '{ "mapType": "streetview", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
필수 입력란
mapType
기본 지도 유형입니다. 이 값은 다음 중 하나일 수 있습니다.
language
IETF 언어 태그 - 타일에 정보를 표시하는 데 사용되는 언어를 지정합니다. 대상 예를 들어
en-US
는 미국에서 사용되는 영어를 지정합니다.region
가 공통 언어 데이터 저장소 물리적 위치를 나타내는 지역 식별자 (대문자 2개) 정의합니다. 예를 들면
US
입니다.
선택적 필드
imageFormat
- 반환할 파일 형식을 지정합니다. 유효한 값은
jpeg
또는png
입니다. JPEG 파일은 투명도를 지원하지 않기 때문에 오버레이 타일을 사용할 수 있습니다.imageFormat
를 지정하지 않으면 타일이 자동으로 선택됩니다. scale
지도 요소의 크기 (예: 도로 라벨)를 확대하고 기본 타일의 타일 크기 및 커버리지 영역. 또한 배율을 높이면 은 지도의 라벨 수를 줄여 혼잡성을 줄여줍니다. 다음 값은 유효한
scale
값입니다.scaleFactor1x
: 기본값입니다.scaleFactor2x
: 라벨 크기를 두 배로 늘리고 부차적인 지형지물 라벨을 삭제합니다.scaleFactor4x
: 라벨 크기를 네 배로 하고 부차적인 지형지물 라벨을 삭제합니다.
다음 예에서는 지도 요소의 크기 조정 효과를 보여줍니다.
배율 1x | 배율 2x |
---|---|
![]() |
![]() |
highDpi
- 고해상도 타일을 반환할지 지정합니다. 배율이
증가하면
highDpi
를 사용하여 타일의 크기를 늘립니다. 일반적으로 배율을 늘리면 결과 타일이 크기가 같아져 품질이 저하됩니다.highDpi
를 사용하면 결과 크기도 다음과 같습니다. 품질을 유지할 수 있습니다 DPI는 인치당 도트를 의미하며 높은 DPI는 타일이 일반적인 경우보다 인치당 더 많은 도트 수를 사용하여 렌더링됩니다.true
인 경우 각 x 및 y 차원의 픽셀 수에 배율을 곱합니다. 인수 (즉, , 2x 또는 4x)로 계산됩니다. 카드의 커버리지 영역은 변경되지 않습니다. 이 매개변수는scale
값이 2x 또는 4x인 경우에만 작동합니다. Kubernetes는 1x 배율 타일
배율 1x | 배율 2x 높은 DPI |
---|---|
![]() |
![]() |
layerTypes
지도에 추가된 레이어 유형을 지정하는 값의 배열입니다. 유효함 값은 다음과 같습니다.
layerRoadmap
terrain
을 지도 유형으로 지정하는 경우 필수입니다. 선택적으로satellite
지도 유형에 오버레이됨 로드맵 타일에는 영향을 미치지 않습니다.layerStreetview
- 스트리트 뷰가 사용 설정된 거리와 위치가 파란색 윤곽선을 사용하여 있습니다
layerTraffic
- 현재 교통상황을 표시합니다.
styles
객체의 모양과 세부정보 수준을 지정하는 JSON 스타일 객체의 배열 도로, 공원, 시가지와 같은 지도 지형지물 스타일 지정은 표준 Google 기본 지도를 맞춤설정합니다.
styles
매개변수는 다음 경우에만 유효합니다. 지도 유형은roadmap
입니다. 전체 스타일 구문은 스타일 참조.overlay
layerTypes
가 다음과 같아야 하는지 여부를 지정하는 불리언 값입니다. 별도의 오버레이로 렌더링되거나 기본 이미지와 결합됩니다. 날짜true
: 기본 지도가 표시되지 않습니다.layerTypes
를 정의하지 않은 경우 이 값은 무시됩니다.
예를 들어 layerRoadmap
레이어로 satellite
지도 유형을 요청합니다.
overlay
를 false
로 설정하면 hybrid
지도 유형과 동일한 타일이 생성됩니다.
Maps JavaScript API에서 사용됩니다 (왼쪽 이미지). 똑같음
overlay
가 true
로 설정된 지도 및 레이어 유형은 투명한 타일이 됨
위성 이미지 위에 오버레이하기 위해 적절하게 스타일이 지정된 지도 오버레이 사용
(오른쪽 이미지)
overlay : false |
overlay : true |
---|---|
![]() |
![]() |
다음 JSON은 둘 다 포함하는 일반적인 요청 본문의 예입니다. 필수 입력란과 선택 입력란이 있습니다.
{
"mapType": "satellite",
"language": "en-US",
"region": "us",
"layerTypes": [ "layerRoadmap", "layerStreetview" ],
"overlay": true,
"scale": "scaleFactor1x",
"styles": [
{
"stylers": [
{ "hue": "#00ffe6" },
{ "saturation": -20 }
]
},{
"featureType": "road",
"elementType": "geometry",
"stylers": [
{ "lightness": 100 },
{ "visibility": "simplified" }
]
}
]
}
이 예에서는 위성과 결합하기에 적합한 오버레이를 제공합니다. 이미지 예에는 로드맵과 스트리트 뷰 오버레이가 모두 포함되어 있습니다. 이 결과 지도는 영어로 된 이름과 데이터로 렌더링되므로 미국에서 사용되기 때문입니다.
apiOptions
: 적용할 추가 옵션을 지정하는 값의 배열입니다.
지원되는 옵션은 다음과 같습니다.
MCYJ5E517XR2JC
- 새 지도 스타일을 선택합니다. 선택 기간 동안에는 요청에 기존 지정할 수 있습니다.
세션 토큰 응답
다음 JSON은 응답 본문의 예입니다.
{
"session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
"expiry": "1361828036",
"tileWidth": 256,
"tileHeight": 256,
"imageFormat": "png"
}
다음 목록에는 응답 본문의 필드 정의가 포함되어 있습니다.
session
- 모든 Map Tiles API에 포함해야 하는 세션 토큰 값입니다. 제공합니다.
expiry
- 토큰이 발생한 시간 (에포크 이후 초 단위)이 포함된 문자열입니다. 만료되지 않습니다. 세션 토큰은 생성 후 2주간 유효합니다. 이 정책은 예고 없이 변경될 수 있습니다.
tileWidth
- 픽셀 단위로 측정된 타일의 너비입니다.
tileHeight
- 픽셀 단위로 측정된 타일의 높이입니다.
imageFormat
- 이미지 형식으로,
png
또는jpeg
일 수 있습니다.