Isı haritaları

heatmapTiles uç noktası, karo yer paylaşımı aracılığıyla hava kalitesiyle ilgili ısı haritaları sağlar. Karo yer paylaşımı, Google Haritalar'ın üst kısmında gösterilebilen PNG resim karolarından oluşan bir koleksiyondur. Her bir görüntü karosu (256 x 256 piksel) boyutundadır.

Isı haritası karoları hakkında

Yer paylaşımlı 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, bir harita görünümünde harita içeriğinin 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 toplam 16 karo ile temsil edilir. Yakınlaştırma, koordinatlar için izin verilen maksimum değeri de belirler.

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

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

Daha fazla 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. Şu adrese bir HTTP GET isteği göndererek heatmapTiles uç noktasını kullanarak mevcut hava kalitesi ısı haritası karolarını isteyebilirsiniz:

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

İsteklerde tüm istek parametreleri zorunludur:

  • TYPE: Döndürülecek ısı haritasının türü. İzin verilen değerlere bakın.

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

    Parça 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 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 başlıklı makaleyi inceleyin.

Ö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

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

0,1 koordinatlarında bir ısı haritası karosu.

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.