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ülenebilecek bir PNG resim karosu koleksiyonudur. Her bir resim parçası (256 x 256 piksel).

Isı haritası kartları hakkında

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Örneğin, 2 yakınlaştırma düzeyinde, dünya haritası 4 x 4 boyutunda bir matris kullanılarak toplam 16 karo kullanılarak gösterilir. Yakınlaştırma, koordinatlar için izin verilen maksimum değerin de ne olduğunu 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 boyutunda bir ısı haritası.

Ek ayrıntılar 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 bir bayt dizisiyle temsil edilir. Mevcut hava kalitesi ısı haritası karolarını şu adrese bir HTTP GET isteği göndererek heatmapTiles uç noktasını kullanarak 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 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 - Alınacak karonun kuzeybatı köşesine (0,0) göre koordinatları. X değerleri batıdan doğuya ve Y değerleri kuzeyden güneye yükseliyor.

    Parça 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 ayarlarsanız ve 10,10 koordinatı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 bir karonun koordinatlarıyla birlikte yakınlaştırma seviyesi 2 olan bir 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

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

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

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