Isı Haritası

heatmapTiles uç noktası, karo üzerine düşen hava kalitesiyle ilgili ısı haritaları sunar. Karo yer paylaşımı, Google Haritalar'ın üzerinde görüntülenebilecek bir PNG resim karoları koleksiyonudur. Her bir resim karosu (256 x 256 piksel) olmalıdır.

Isı haritası kartları hakkında

Karo yer paylaşımı, her birine (X,Y) koordinat atanmış olan bir dizi bloktan oluşan bir ızgaradır. Koordinatlı karo (0,0) her zaman haritanın kuzeybatı köşesinde yer alır. X değerleri batıdan doğuya doğru, Y değerleri ise kuzeyden güneye doğru artar.

zoom level, bir 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 üstel olarak ölçeklendirilmesiyle belirlenir.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Örneğin, yakınlaştırma seviyesi 2 olduğunda dünya haritası 4 x 4 matris kullanılarak toplam 16 parça olacak şekilde gösterilir. Yakınlaştırma, koordinatlar için izin verilen maksimum değeri de belirler.

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

4'e 4'lük bir ızgara olarak tüm dünyanın ı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ı parçası, parça verilerini PNG resmi olarak içeren bayt dizisiyle temsil edilir. Şunlara HTTP GET isteği göndererek heatmapTiles uç noktasını kullanarak mevcut hava kalitesi ısı haritası blokları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 - 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üzeyi. İzin verilen değerler 0-16 arasındadır. 0 değeri, tüm dünyayı tek bir parçada 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ının, belirtilen yakınlaştırma düzeyi için geçerli olması gerekir. Örneğin, yakınlaştırma seviyesini 2'ye ayarlar ve 10,10 koordinatlarında bir kutucuk 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, yakınlaştırma seviyesi 2 olan bir US_AQI ısı haritası ve her bir karonun koordinatları 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ı kutusu.

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