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österilebilen bir resim karoları koleksiyonudur. Her bir 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. (0,0) koordinatlarına sahip karo 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. Karo ızgara boyutu, X ve Y koordinatlarının yakınlaştırma seviyesine göre katlanarak ö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 toplam 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.

4'e 4'lük bir ızgara olarak tüm dünyanın ısı haritası.

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

Aşağıdaki HTTP GET isteğini 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ğerlere 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 seviyesi. İzin verilen değerler 0-16 arasındadır. 0 değeri, tüm dünyayı tek bir karo içinde gösterir.
  • X,Y: Parça koordinatları, kuzeydoğu köşesine (0,0) göre belirlenir. X değerleri batıdan doğuya, Y değerleri ise 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 karo 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 karoyu 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, haritanın üzerine yerleştirilebilen bir resim olarak görünür:

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

Varsayılan haritanın üzerine karolar yerleştirme hakkında daha fazla bilgi için Yer Paylaşımlı Harita Türleri başlıklı makaleyi inceleyin.