Hava durumu haritalarını kullanma (Deneysel)

mapTypes uç noktası, yağış tahminleri gibi çeşitli hava durumu olaylarını temsil eden raster harita döşemeleri sağlar. Bu harita döşemeleri, standart Google Haritalar'ın üzerine yerleştirilebilir.

Şartlar

Bu şartlar, Google ve sizin tarafınızdan kabul edildiği üzere Google Haritalar Platformu Hizmetine Özgü Şartlar'ın 6. Bölümü (GKST Öncesi Teklif Şartları) uyarınca yayınlanmıştır.

1.1 İlişkilendirme Şartları. Müşteri, Weather API'den Google Haritalar İçeriği kullanıyorsa Google'a Belgeler'e uygun şekilde atıfta bulunmalıdır.

1.2 Kısıtlamalar. Müşteriler, Google hizmeti veya ürünü oluşturmak için Weather API'den alınan Google Haritalar İçeriklerini kullanamaz (ör. Weather API'den alınan verileri, temel amacı hava durumu bilgisi sağlamak olan bir hava durumu uygulamasında veya hava durumu modelinde kullanamaz).

1.3 Önbelleğe Alma. Müşteriler, Tablo 1.3.1'de (Önbelleğe Alma İzinleri) açıklandığı gibi, geçerli Google Haritalar İçeriği'ni Weather API'sinden geçerli Önbelleğe Alma Süresi boyunca geçici olarak önbelleğe alabilir.

Tablo 1.3.1 (Önbelleğe Alma İzinleri)

Bu izinler, Google Haritalar Platformu Hizmetine Özgü Şartlar'ın Tablo 17.2.1'inde açıklanan izinlere ek olarak verilir.

Google Haritalar İçeriği Önbelleğe Alma Süresi
Hava durumu haritası kutuları Bir saat. Bu sürenin sonunda Müşteri, önbelleğe alınmış Google Haritalar İçeriği'ni silmelidir.

Hava durumu haritası istekleri hakkında

Hava durumu haritaları istemek için şu adrese bir HTTP GET isteği gönderin:

https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

Harita türleri

Weather API, farklı hava durumu haritası türlerini destekler. Bu türler, farklı temel hava durumu modellerine ve coğrafi alanlara karşılık gelir:

  • US_PRECIPITATION_CURRENT: ABD'deki yüksek çözünürlüklü yağış anlık hava durumu.
  • EU_PRECIPITATION_CURRENT: Yüksek çözünürlüklü Avrupa anlık yağış tahmini.

Aşağıdaki kapsama haritasında, hava durumu haritası döşemelerinin kullanılabildiği bölgeler gösterilmektedir:

Hava durumu haritası karo kapsamı

Parça koordinatları sistemi

API, standart Web Mercator döşeme koordinat sistemini kullanır. Harita ve parça koordinatları hakkında kapsamlı bir açıklama için Yol haritası parçaları ve Harita ve Parça Koordinatları başlıklı makaleleri inceleyin.

Bu sistemde:

  • zoom: Yakınlaştırma seviyesi (0-16). Yakınlaştırma seviyesi 0, tüm dünyayı tek bir parça halinde gösterir (20 x 20 = 1 parça). Yakınlaştırma seviyesi z, dünyayı 2z x 2z parçalık bir ızgaraya böler.
  • x: Döşemenin X koordinatı (sütun). 0 (en batıdaki) ile 2zoom - 1 (en doğudaki) arasında değişir.
  • y: Döşemenin Y koordinatı (satır). 0 (en kuzeyde) ile 2zoom - 1 (en güneyde) arasında değişir.

Hava durumu haritasını görüntüleme

Bu döşemeleri Google Haritalar JavaScript API'yi kullanarak bir web uygulamasında göstermek için özel bir google.maps.ImageMapType oluşturabilirsiniz:

const weatherMapType = new google.maps.ImageMapType({
  getTileUrl: function(coord, zoom) {
    const mapType = "US_PRECIPITATION_CURRENT";
    return `https://weather.googleapis.com/v1/mapTypes/${mapType}/mapTiles/${zoom}/${coord.x}/${coord.y}`;
  },
  tileSize: new google.maps.Size(256, 256),
  maxZoom: 16,
  minZoom: 0,
  name: "Weather"
});

// Overlay on existing map
map.overlayMapTypes.insertAt(0, weatherMapType);

Hava durumu haritası isteği örneği

Aşağıdaki örnekte, New Orleans için ABD'deki yağış hava durumu haritası döşemeleri istenmektedir:

curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"

Yanıt ikili (binary) olmalıdır. JSON sarmalayıcı yalnızca belirli serileştirme ayarlarında (ör. ?alt=json) görünür.