Isı Haritası

heatmapTiles uç noktası, karo yer paylaşımı üzerinden hava kalitesiyle ilgili ısı haritaları sunar. Karo yer paylaşımı, Google Haritalar'ın üzerinde görüntülenebilen PNG resim karolarından oluşan bir koleksiyondur. Her bir resim parçası (256 x 256 piksel).

Isı haritası kutuları hakkında

Karo yer paylaşımı, bir dizi karodan derlenen ve her biri (X,Y) koordinat atanmış bir ızgaradır. Koordinatlara sahip karo (0,0) 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 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 katlanarak ölçeklendirilmesiyle belirlenir.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Örneğin, 2 yakınlaştırma düzeyinde, dünya haritası, toplam 16 karo olmak üzere 4 x 4 boyutunda bir matris kullanılarak gösterilir. Yakınlaştırma, koordinatlar için izin verilen maksimum değeri de belirler.

Aşağıdaki resimde, her bir karonun koordinatlarıyla birlikte yakınlaştırma seviyesi 2 olan bir US_AQI ısı haritası gösterilmektedir:

Tüm dünyanın 4'e 4'lük bir ızgara görünümünde ısı haritası.

Ayrıntılı bilgi için Harita ve Parça koordinatları'na bakın.

Isı haritası uç noktası hakkında

Isı haritası parçası, PNG görüntüsü olarak parça verilerini içeren bir bayt dizisiyle temsil edilir. Şu adrese bir HTTP GET isteği göndererek heatmapTiles uç noktasını kullanarak mevcut hava kalitesi ısı haritası karolarını talep edersiniz:

https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

Bir istekte tüm istek parametreleri gereklidir:

  • TYPE - Döndürülecek ısı haritası türü. İzin verilen değerleri inceleyin.

  • Z: 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üzeyidir. İzin verilen değerler 0 ile 16 arasındadır. 0 değeri tüm dünyayı tek bir parçada gösterir.

  • X,Y - Alınacak karonun koordinatları, kuzeybatı köşesine (0,0) göre. X değerleri batıdan doğuya, Y değerleri ise kuzeyden güneye yükseliyor.

    Parça koordinatlarının belirtilen yakınlaştırma düzeyi için geçerli olması gerekir. Örneğin, yakınlaştırma düzeyini 2 olarak ayarlar ve 10,10 koordinatlarında bir blok isterseniz API bir hata döndürür.

  • YOUR_API_KEY - Uygulamanızın API anahtarı. Bu anahtar, uygulamanızı kota yönetimi amacıyla tanımlar. Daha fazla bilgi için anahtar alma bölümünü inceleyin.

Örnek ısı haritası isteği

Yukarıdaki resimde, her bir karonun koordinatlarıyla birlikte yakınlaştırma seviyesi 2 olan US_AQI ısı haritası gösterilmektedir. Aşağıdaki örnekte, karoyu ısı haritasından 0,1 koordinatlarında istemek için heatmapTiles uç noktası kullanılmaktadır:

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

Kutu şu şekilde görünür:

0,1 koordinatlarındaki bir ısı haritası bloku.

Varsayılan haritanın üzerine karoları yer paylaşımlı olarak yerleştirme hakkında daha fazla bilgi için Yer Paylaşımlı Harita Türleri konusuna bakın.