로드맵 타일

로드맵 카드 개요도로 지도 타일은 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도 방향 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

응답 메시지 헤더에 관한 자세한 내용은 콘텐츠 프리페칭, 캐싱 또는 저장을 참고하세요.