Isı haritaları

heatmapTiles uç noktası, karo yer paylaşımı aracılığıyla polenle ilgili ısı haritaları sağlar. Karo yer paylaşımı, Google Haritalar'ın üzerinde görüntülenebilecek bir resim karosu koleksiyonudur. Her resim karosu 256 x 256 pikseldir.

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

zoom level, haritadaki içeriğin harita görünümünde ne kadar büyük veya küçük görüneceğini belirler. Kartel ı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, 2 yakınlaştırma düzeyinde dünya haritası 4 x 4 matris kullanılarak temsil edilir ve toplam 16 karodan oluşur.

Aşağıdaki resimde, dünyanın tamamının 2 yakınlaştırma düzeyinde erişilebilen karolara bölünmüş TREE_UPI ısı haritası gösterilmektedir.

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

Daha fazla bilgi için Harita ve karo koordinatları başlıklı makaleyi inceleyin.

Aşağıdaki uç noktaya HTTP GET isteği göndererek heatmapTiles uç noktasını kullanarak mevcut polen sıcaklık haritası karolarını 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 edinme hakkında bilgi edinin.
  • TYPE: Döndürülecek ısı haritası türü. İzin verilen değerler bölümüne bakın.
  • Z: Bir haritanın 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 ile 16 arasındadır. 0 değeri, dünyanın tamamını tek bir karoda gösterir.
  • X,Y: Kuzeydoğu köşesine (0,0) göre karo koordinatları. X değerleri batıdan doğuya doğru, 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 karo isteğinde bulunursanız API bir hata döndürür.

Örnek ısı haritası isteği

Yukarıdaki resimde, 2 yakınlaştırma düzeyine sahip bir TREE_UPI ısı haritası ve her karonun koordinatları gösterilmektedir. Aşağıdaki örnekte, (2,1) koordinatlarındaki karoyu istemek için heatmapTiles uc noktası kullanılır:

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

Kart, haritaya yerleştirilebilecek bir resim olarak görünür:

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

Varsayılan haritanın üzerine karo yerleştirme hakkında daha fazla bilgi için Yer paylaşımlı harita türleri başlıklı makaleyi inceleyin.