Isı Haritası

heatmapTiles uç noktası, karo üzerine düşen hava kalitesiyle ilgili ısı haritaları sunar. Karo yer paylaşımı, Google Haritalar'ın üstünde görüntülenebilen PNG resim karolarından oluşan bir koleksiyondur. Her resim bloğu (256 x 256 piksel) olmalıdır.

Isı haritası kartları hakkında

Yer paylaşımlı karo, her birine (X,Y) koordinatları atanan 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, 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. Karo ı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. Yakınlaştırma, koordinatlar için izin verilen maksimum değeri de belirler.

Aşağıdaki resimde, 2 yakınlaştırma düzeyine sahip bir US_AQI ısı haritası ve her karonun koordinatları gösterilmektedir:

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

Daha ayrıntılı bilgi için Harita ve Parça koordinatları bölümüne bakın.

Isı haritası uç noktası hakkında

Isı haritası karosu, karo verilerini PNG resmi olarak içeren bir bayt dizisiyle temsil edilir. Aşağıdaki URL'ye bir HTTP GET isteği göndererek heatmapTiles uç noktasını kullanarak mevcut hava kalitesi ısı haritası karolarını istersiniz:

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: 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 - Kuzeybatı köşesine göre (0,0) göre alınacak karonun koordinatları. X değerleri batıdan doğuya doğru artmakta ve Y değerleri kuzeyden güneye doğru artmaktadır.

    Karo 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.

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

Örnek ısı haritası isteği

Yukarıdaki resimde, her karonun koordinatlarıyla birlikte 2 yakınlaştırma düzeyine sahip bir US_AQI ısı haritası gösterilmektedir. Aşağıdaki örnekte, ısı haritasından 0,1 koordinatlarındaki karoyu 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

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

0,1 koordinatlarında bir ısı haritası parçası.

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