이 페이지는 Cloud Translation API를 통해 번역되었습니다.

히트맵

이 heatmapTiles 드림 엔드포인트는 타일 오버레이를 통해 공기질 관련 히트맵을 제공합니다. 타일 오버레이는 이미지 위에 표시할 수 있는 PNG 이미지 타일의 Google 지도 각 이미지 타일은 (256x256픽셀)입니다.

히트맵 타일 정보

타일 오버레이는 타일 모음으로 구성된 그리드이며, 할당된 각 (X,Y) 좌표입니다. 좌표가 (0,0)인 타일은 항상 북서쪽 모서리에 있습니다. 정의합니다. X 값이 서쪽에서 동쪽으로 갈수록 증가합니다. Y 값은 북쪽에서 남쪽으로 증가합니다.

zoom level는 지도에 표시되는 콘텐츠의 크기 또는 지도뷰입니다. 타일 그리드 크기는 X와 Y의 배율을 조정하여 결정됩니다. 좌표가 기하급수적으로 증가합니다.

gridSizeX = X^zoomLevel
gridSizeY = Y^zoomLevel

예를 들어 확대/축소 수준이 2일 때 세계 지도는 4 x 4 행렬은 총 16개의 타일이 됩니다. 확대/축소를 통해 입니다.

다음 이미지는 확대/축소 수준이 2인 US_AQI 히트맵을 보여줍니다. 과 함께 각 타일의 좌표:

전 세계의 히트맵이 4x4 그리드로 표시됩니다.

지도 및 타일 좌표를 참고하세요. 를 참조하세요.

히트맵 타일은 타일 데이터가 PNG로 포함된 바이트 배열로 표시됩니다. 이미지 사용자는 다음을 사용하여 현재 공기질 히트맵 타일을 요청합니다. heatmapTiles 드림 HTTP GET 요청을 전송하여 다음을 수행합니다.

https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

모든 요청 매개변수는 요청에 필요합니다.

TYPE - 반환할 히트맵 유형. 허용된 허용 목록 보기 값을 참조하세요.
Z - 지도 콘텐츠의 크기를 결정하는 확대/축소 수준 지도 보기에 표시됩니다. 허용되는 값은 0~16이며, 값 0이 표시됩니다. 표시할 수 있습니다.
X,Y - 북쪽을 기준으로 가져올 타일의 좌표입니다. 서쪽 모서리 (0,0)입니다. X 값이 서쪽에서 동쪽으로 증가하고 있으며 Y 값이 북쪽에서 남쪽으로 증가하고 있습니다.

타일 좌표는 지정된 확대/축소 수준에서 유효해야 합니다. 예를 들어 확대/축소 수준을 2로 설정하고 좌표가 10,10이면 API에서 오류를 반환합니다.
YOUR_API_KEY - 애플리케이션의 API 키입니다. 이 키는 할당량 관리를 목적으로 하는 애플리케이션입니다. 자세한 내용은 get 키를 사용합니다.

위 이미지는 확대/축소 수준이 2인 US_AQI 히트맵을 보여줍니다. 각 타일의 좌표와 함께 표시됩니다. 다음 예에서는 heatmapTiles 엔드포인트를 호출하여 히트맵:

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

타일은 다음과 같이 표시됩니다.

좌표 0,1의 히트맵 타일

기본 지도 위에 타일을 오버레이하는 방법에 대한 자세한 내용은 다음을 참조하세요. 오버레이 지도 유형.