heatmapTiles uç noktası, karo kaplama aracılığıyla polenle ilgili ısı haritaları sağlar. Karo yer paylaşımı, Google Haritalar'ın üzerinde görüntülenebilen resim parçalarından oluşan bir koleksiyondur. Her bir resim karosu 256 x 256 pikseldir.
Karo yer paylaşımı, her birine (X
,Y
) koordinat atanmış olan bir dizi bloktan oluşan bir ızgaradır. Koordinatlı karo (0,0) her zaman haritanın kuzeybatı köşesinde yer alır. X
değerleri batıdan doğuya doğru, Y
değerleri ise kuzeyden güneye doğru artar.
zoom level
, bir harita içeriğinin harita görünümünde ne kadar büyük veya küçük görüneceğini belirler. Karo ızgara boyutu, X
ve Y
koordinatlarının yakınlaştırma düzeyine göre üstel olarak ölçeklendirilmesiyle belirlenir.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
Örneğin, yakınlaştırma seviyesi 2 olduğunda dünya haritası 4 x 4 matris kullanılarak toplam 16 parça olacak şekilde gösterilir.
Aşağıdaki resimde, tüm dünyanın TREE_UPI
ısı haritası, 2 yakınlaştırma düzeyinde erişilebilen karolara ayrılmış olarak gösterilmektedir.
Daha fazla bilgi için Harita ve Parça koordinatları bölümüne bakın.
Şu adrese HTTP GET isteği göndererek ısımapTiles uç noktasını kullanarak mevcut polen ısı haritası bloklarını isteyebilirsiniz:
https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY
Isı haritası uç noktası hakkında
Aşağıda listelenen tüm parametreler, başarılı bir istek için gereklidir:
KEY
: Uygulamanızın API anahtarı. Bu anahtar, kota yönetimi amacıyla uygulamanızı tanımlar. Anahtar almayı öğrenin.TYPE
: Döndürülecek ısı haritasının türü. İzin verilen değerleri inceleyin.Z
: Bir harita içeriğinin harita görünümünde ne kadar büyük veya küçük görüneceğini belirleyen yakınlaştırma düzeyi. İzin verilen değerler 0-16 arasındadır. 0 değeri, tüm dünyayı tek bir parçada gösterir.X
,Y
: Kuzeydoğu köşeye göre karo koordinatlarının koordinatları (0,0).X
değerleri batıdan doğuya veY
değerleri kuzeyden güneye doğru artar. Koordinatlar, belirtilen yakınlaştırma düzeyi için geçerli olmalıdır. Örneğin, yakınlaştırma düzeyini 2 olarak ayarlar ve koordinatlarda (10,10) bir kutucuk isterseniz API bir hata döndürür.
Örnek ısı haritası isteği
Yukarıdaki resimde, yakınlaştırma seviyesi 2 olan bir TREE_UPI
ısı haritası ve her bir karonun koordinatları gösterilmektedir. Aşağıdaki örnekte, parçayı koordinatlarda (2,1) 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
Karo, harita üzerine yerleştirilebilecek bir resim olarak görünür:
Varsayılan haritanın üzerine karolar yerleştirme hakkında daha fazla bilgi için Yer Paylaşımlı Harita Türleri konusuna bakın.