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şımlı parça, her biri (X,Y) koordinatları atanmış bir parça koleksiyonundan oluşan 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 seviyesine göre üstel olarak ölçeklendirilmesiyle belirlenir.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Örneğin, 2 yakınlaştırma seviyesinde dünya haritası 4 x 4 matris kullanılarak gösterilir ve toplamda 16 parça bulunur. Yakınlaştırma, koordinatlar için izin verilen maksimum değeri de belirler.

Aşağıdaki resimde, her bir parçanın koordinatlarıyla birlikte 2 yakınlaştırma seviyesine sahip bir US_AQI ısı haritası gösterilmektedir:

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

Ek bilgiler için Harita ve parça koordinatları başlıklı makaleyi inceleyin.

Isı haritası uç noktası hakkında

Isı haritası bölümü, bölüm 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 seviyesi. İ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.

    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 parça 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 parçanın koordinatlarıyla birlikte 2 yakınlaştırma seviyesine sahip bir US_AQI ısı haritası gösterilmektedir. Aşağıdaki örnekte, ısı haritasından 0,1 koordinatlarındaki kutucuğu 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 Harita Türlerini Yerleştirme başlıklı makaleyi inceleyin.