Isı Haritası

heatmapTiles uç noktası, karo yer paylaşımı aracılığıyla hava kalitesiyle ilgili ısı haritaları sağlar. Karo yer paylaşımı, Google Haritalar'ın üzerinde 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. 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. 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 fazla bilgi için Harita ve karo koordinatları başlıklı makaleyi inceleyin.

Isı haritası uç noktası hakkında

Isı haritası karoları, 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ğ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 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: Alınacak karonun kuzeybatı köşesine (0,0) göre koordinatları. X değerleri batıdan doğuya doğru, Y değerleri ise kuzeyden güneye doğru artıyor.

    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ındaki 0,1 koordinatlarında karo 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 karo yerleştirme hakkında daha fazla bilgi için Yer paylaşımlı harita türleri başlıklı makaleyi inceleyin.