heatmapTiles 엔드포인트는 타일 오버레이를 통해 꽃가루 관련 히트맵을 제공합니다. 타일 오버레이는 Google 지도 위에 표시할 수 있는 이미지 타일 모음입니다. 각 이미지 타일은 256x256픽셀입니다.
타일 오버레이는 각각 할당된 (X
,Y
) 좌표의 타일 모음으로 구성된 그리드입니다. 좌표가 (0,0)인 타일은
항상 지도의 북서쪽 모서리에 있습니다. X
값은 서쪽에서 동쪽으로 가면서 증가하고 Y
값은 북쪽에서 남쪽으로 갈수록 증가합니다.
zoom level
는 지도 콘텐츠에 표시되는 지도의 콘텐츠 크기를 지도 보기에
표시하는 크기를 결정합니다. 타일 그리드 크기는 X
및 Y
좌표를 확대/축소 수준에 따라 기하급수적으로 조정해 결정됩니다.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
예를 들어 확대/축소 수준이 2이면 세계 지도가 4x4 행렬을 사용하여 총 16개의 타일로 표시됩니다.
다음 이미지는 확대/축소 수준 2에서 액세스할 수 있는 타일로 나누어진 전 세계의 TREE_UPI
히트맵을 보여줍니다.
자세한 내용은 지도 및 타일 좌표를 참고하세요.
HTTP GET 요청을 다음으로 전송하여 heatmapTiles 엔드포인트를 사용하여 현재 꽃가루 히트맵 타일을 요청할 수 있습니다.
https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY
히트맵 엔드포인트 정보
요청이 성공하려면 아래 나열된 모든 매개변수가 필요합니다.
KEY
: 애플리케이션의 API 키입니다. 이 키는 할당량 관리를 위해 애플리케이션을 식별합니다. 키를 가져오는 방법을 알아보세요.TYPE
: 반환할 히트맵 유형입니다. 허용되는 값을 참고하세요.Z
: 지도 콘텐츠에 지도 콘텐츠를 얼마나 크게 또는 작게 표시할지 결정하는 확대/축소 수준입니다. 허용되는 값은 0~16이며, 값 0은 전 세계를 단일 타일에 표시합니다.X
,Y
: 타일 좌표가 북동쪽 모서리 (0,0)를 기준으로 합니다.X
값은 서쪽에서 동쪽으로 증가하고Y
값은 북쪽에서 남쪽으로 증가합니다. 좌표는 지정된 확대/축소 수준에서 유효해야 합니다. 예를 들어 확대/축소 수준을 2로 설정하고 좌표 (10,10)의 타일을 요청하면 API에서 오류를 반환합니다.
히트맵 요청 예시
위 이미지는 확대/축소 수준이 2인 TREE_UPI
히트맵과 각 타일의 좌표를 보여줍니다. 다음 예에서는 heatmapTiles
엔드포인트를 사용하여 (2,1) 좌표에 타일을 요청합니다.
https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY
타일은 지도에 오버레이할 수 있는 이미지로 표시됩니다.
기본 지도 위에 타일을 오버레이하는 방법에 대한 자세한 내용은 오버레이 지도 유형을 참고하세요.