Isı haritaları

heatmapTiles uç noktası, döşeme kaplaması aracılığıyla polenle ilgili ısı haritaları sağlar. Karo yer paylaşımı, Google Haritalar'ın üzerinde gösterilebilen bir resim karoları koleksiyonudur. Her resim kutucuğu 256 x 256 pikseldir.

Yer paylaşımı karo, her birine (X,Y) koordinatları atanmış bir karo koleksiyonundan oluşturulan bir ızgaradır. Koordinatları (0,0) olan parça her zaman haritanın kuzeybatı köşesindedir. X değerleri batıdan doğuya, Y değerleri ise kuzeyden güneye doğru artar.

zoom level, harita görünümünde harita içeriklerinin ne kadar büyük veya küçük görüneceğini belirler. Döşeme ızgarası boyutu, X ve Y koordinatlarının yakınlaştırma seviyesine göre üstel olarak ölçeklendirilmesiyle belirlenir.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Örneğin, 2 yakınlaştırma seviyesinde dünya haritası 4 x 4 matris kullanılarak gösterilir ve toplamda 16 parça bulunur.

Aşağıdaki resimde, 2 yakınlaştırma seviyesinde erişilebilen parçalara bölünmüş, tüm dünyanın TREE_UPI ısı haritası gösterilmektedir.

Dünyanın tamamının 4x4 ızgara şeklinde ısı haritası.

Ek ayrıntılar için Harita ve Döşeme Koordinatları bölümüne bakın.

Aşağıdaki adrese bir HTTP GET isteği göndererek heatmapTiles uç noktasını kullanarak mevcut polen ısı haritası döşemelerini isteyebilirsiniz:

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

Isı haritası uç noktası hakkında

Başarılı bir istek için aşağıda listelenen tüm parametreler gereklidir:

  • KEY: Uygulamanızın API anahtarı. Bu anahtar, kota yönetimi amacıyla uygulamanızı tanımlar. Anahtar alma hakkında bilgi edinin.
  • TYPE: Döndürülecek ısı haritasının türü. İzin verilen değerler başlıklı makaleyi inceleyin.
  • Z: Harita görünümünde harita içeriklerinin ne kadar büyük veya küçük görüneceğini belirleyen yakınlaştırma seviyesi. İzin verilen değerler 0-16'dır. 0 değeri, tüm dünyayı tek bir kutuda gösterir.
  • X,Y: Kuzeydoğu köşesine (0,0) göre parça koordinatları. X değerleri batıdan doğuya doğru artar ve Y değerleri kuzeyden güneye doğru artar. Koordinatlar, belirtilen yakınlaştırma seviyesi için geçerli olmalıdır. Örneğin, yakınlaştırma seviyesini 2 olarak ayarlayıp (10,10) koordinatlarında bir parça isterseniz API hata döndürür.

Örnek ısı haritası isteği

Yukarıdaki resimde, her parçanın koordinatlarıyla birlikte 2 yakınlaştırma seviyesine sahip bir TREE_UPI ısı haritası gösterilmektedir. Aşağıdaki örnekte, (2,1) koordinatlarındaki döşemeyi istemek için heatmapTiles uç noktası kullanılmaktadır:

https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY

Kutu, haritanın üzerine yerleştirilebilen bir resim olarak görünür:

TREE_UPI haritasını kullanan bir ısı haritası kutucuğu örneği.

Varsayılan haritanın üzerine döşeme yerleştirme hakkında daha fazla bilgi için Harita Türlerini Yerleştirme başlıklı makaleyi inceleyin.