heatmapTiles uç noktası, döşeme yerleşimi aracılığıyla polenle ilgili ısı haritaları sağlar. Karo yer paylaşımı, Google Haritalar'ın üzerinde görüntülenebilen bir dizi resim karosudur. Her resim kutucuğu 256 x 256 pikseldir.
Yer paylaşımı karosu, 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 doğru artarken Y
değerleri 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 düzeyine göre üstel olarak ölçeklendirilmesiyle belirlenir.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
Örneğin, 2 yakınlaştırma düzeyinde dünya haritası 4 x 4 matris kullanılarak gösterilir ve toplamda 16 kutu bulunur.
Aşağıdaki resimde, 2 yakınlaştırma düzeyinde erişilebilen kutulara bölünmüş, tüm dünyanın TREE_UPI
ısı haritası gösterilmektedir.
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. Nasıl anahtar alacağınızı öğrenin.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 düzeyi. İ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 döşeme koordinatları.X
değerleri batıdan doğuya,Y
değerleri ise 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 ayarlayıp (10,10) koordinatlarında bir döşeme isterseniz API hata döndürür.
Örnek ısı haritası isteği
Yukarıdaki resimde, her kutucuğun koordinatlarıyla birlikte 2 yakınlaştırma düzeyine 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:
Varsayılan haritanın üzerine döşeme yerleştirme hakkında daha fazla bilgi için Yerleşim Harita Türleri başlıklı makaleyi inceleyin.