히트맵

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

히트맵 카드 정보

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

zoom level는 지도 뷰에 지도 콘텐츠가 얼마나 크게 표시되는지 결정합니다. 타일 그리드 크기는 확대/축소 수준에 따라 XY 좌표를 지수적으로 조정하여 결정됩니다.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

예를 들어 확대/축소 수준이 2인 경우 세계 지도는 4x4 매트릭스를 사용하여 표시되며 총 16개의 타일이 표시됩니다. 확대/축소는 좌표에 허용되는 최대 값도 결정합니다.

다음 이미지는 확대/축소 수준이 2인 US_AQI 히트맵과 각 카드의 좌표를 보여줍니다.

4x4 그리드로 표시된 전 세계 히트맵

자세한 내용은 지도 및 타일 좌표를 참고하세요.

히트맵 엔드포인트 정보

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

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 키입니다. 이 키는 할당량 관리를 위해 애플리케이션을 식별합니다. 자세한 내용은 키 가져오기를 참고하세요.

히트맵 요청 예시

위 이미지에는 확대/축소 수준이 2인 US_AQI 히트맵과 각 타일의 좌표가 나와 있습니다. 다음 예에서는 heatmapTiles 엔드포인트를 사용하여 히트맵에서 좌표 0,1의 타일을 요청합니다.

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

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

좌표 0,1의 히트맵 타일

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