Isı haritaları

heatmapTiles uç noktası, döşeme yerleşimi 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ı koleksiyonudur. Her resim bloğu 256 x 256 pikseldir.

Isı haritası kartları hakkında

Yer paylaşımı karo, her birine (X,Y) koordinatları atanmış bir karo koleksiyonundan oluşturulan bir ızgaradır. Koordinatları (0,0) olan kutu 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 görünümünde harita içeriklerinin ne kadar büyük veya küçük görüneceğini belirler. Döşeme ızgarası 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 gösterilir ve toplamda 16 kutu bulunur. Yakınlaştırma, koordinatlar için izin verilen maksimum değeri de belirler.

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

Tüm dünyanın 4x4 ızgara şeklinde ısı haritası.

Daha fazla bilgi için Harita ve Döşeme koordinatları başlıklı makaleyi inceleyin.

Isı haritası uç noktası hakkında

Isı haritası döşemesi, döşeme verilerini PNG resmi olarak içeren bir bayt dizisiyle gösterilir. Aşağıdaki HTTP GET isteğini göndererek heatmapTiles uç noktasını kullanarak mevcut hava kalitesi ısı haritası döşemelerini isteyebilirsiniz:

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

İstek parametrelerinin tümü istekte zorunludur:

  • TYPE: Döndürülecek ısı haritası türü. İzin verilen değerler başlıklı makaleyi inceleyin.

  • Z - Harita içeriklerinin 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'dır. 0 değeri, tüm dünyayı tek bir kutuda gösterir.

  • X,Y: Kuzeybatı köşesine (0,0) göre alınacak kutucuğun koordinatları. X değerleri batıdan doğuya, Y değerleri ise kuzeyden güneye doğru artar.

    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 döşeme isterseniz API 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, her kutucuğun 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 döşemeyi 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

Döşeme şu şekilde görünür:

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

Varsayılan haritanın üzerine döşeme yerleştirme hakkında daha fazla bilgi için Yerleşim Harita Türleri başlıklı makaleyi inceleyin.