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örüntülenebilen bir resim karoları koleksiyonudur. Her resim kutucuğu 256 x 256 pikseldir.

Karo yer paylaşımı, 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 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.

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

Ek ayrıntılar için Harita ve Döşeme Koordinatları başlıklı makaleyi inceleyin.

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 içeriklerinin 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'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:

TREE_UPI haritasını kullanan bir ısı haritası kutucuğu ö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.