로드맵 타일은 Google 지도 제작 스타일을 적용한 벡터 지형 데이터를 기반으로 하는 이미지 타일입니다. 여기에는 도로, 건물, 관심 장소, 정치적 경계가 포함됩니다.
로드맵 타일 가져오기
세션 토큰을 받은 후에 로드맵 타일을 요청할 수 있습니다. 세션 토큰은 전체 세션에 적용되므로 카드 요청으로 지도 옵션을 지정할 필요가 없습니다.
다음 코드 샘플은 로드맵 타일의 일반적인 세션 토큰 요청을 보여줍니다.
curl -X POST -d '{ "mapType": "roadmap", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
다음 예와 같이 HTTPS GET 요청을 실행하여 로드맵 타일을 가져옵니다.
curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &orientation=0_or_90_or_180_or_270"
이 HTTPS GET 요청에서 z
은 확대/축소 수준(0~22)이고 x
및 y
는 가져오려는 타일의 타일 좌표입니다.
orientation
파라미터는 선택사항입니다. 이 값은 타일 이미지의
시계 반대 방향으로 회전하는 각도를 지정합니다. orientation
는 roadmap
카드에 지원되며, "overlay": true
를 사용하여 기본 이미지를 삭제하고 layerTypes
를 설정한 위성 및 지형 요청에 대해서도 지원됩니다. 유효한 orientation
값은 0 (기본값), 90, 180, 270입니다.
orientation
값을 포함하면 타일 좌표 그리드는 회전되지
않습니다. 예를 들어 orientation
를 90으로 설정해도
x
좌표는 여전히 타일의 왼쪽에서 오른쪽 방향(이 경우
북에서 남으로 이동) 위치를 정의합니다.
0도 방향 | 90도 방향 |
---|---|
타일 요청 예
다음 예에서는 전 세계가 포함된 단일 카드를 요청합니다. 이 예에서 확대/축소 수준은 0이고 x 및 y 좌표는 0, 0입니다.
curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png
이 예에서는 서버의 응답 메시지가 없습니다. 대신 카드는 다음과 같은 통계와 함께 로컬 파일로 다운로드됩니다.
% Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 8335 100 8335 0 0 51471 0 --:--:-- --:--:-- --:--:-- 54835
응답 메시지 헤더에 대한 자세한 내용은 콘텐츠 미리 가져오기, 캐싱 또는 저장을 참조하세요.