Hava durumu haritalarını kullanma (Deneysel)

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

Şartlar

Bu şartlar, Google ve sizin tarafınızdan kabul edilen Google Maps Platform Hizmetine Özel Şartlar'ın 6. bölümü (GKST Öncesi Teklif Şartları) uyarınca yayınlanmıştır.

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

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

1.3 Önbelleğe alma. Müşteriler, geçerli Google Haritalar İçeriği'ni Weather API'den geçerli Önbelleğe Alma Süresi boyunca geçici olarak önbelleğe alabilir. Bu süre, Tablo 1.3.1'de (Önbelleğe Alma İzinleri) açıklanmıştır.

Tablo 1.3.1 (Önbelleğe Alma İzinleri)

Bu izinler, Google Haritalar Platformu Hizmetine Özel Şartlar'ın Tablo 17.2.1 bölümünde açıklanan izinlere ek olarak verilmiştir.

Google Haritalar İçeriği Önbelleğe Alma Süresi
Hava durumu haritası karoları 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 modellerine ve coğrafi bölgelere karşılık gelen farklı hava durumu haritası türlerini destekler:

  • US_PRECIPITATION_CURRENT: ABD için yüksek çözünürlüklü yağış anlık tahmini.
  • EU_PRECIPITATION_CURRENT: Avrupa için yüksek çözünürlüklü anlık yağış tahmini.

Aşağıdaki kapsam haritasında, hava durumu haritası parçalarının kullanılabildiği bölgeler gösterilmektedir:

Hava durumu haritası karo kapsamı

Parça koordinatları sistemi

API, standart Web Mercator parça koordinat sistemini kullanır. Harita ve parça koordinatlarının kapsamlı bir açıklaması 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). 0 yakınlaştırma seviyesi, tek bir karoda tüm dünyayı temsil eder (20 x 20 = 1 karo). Yakınlaştırma seviyesi z, dünyayı 2z x 2z karodan oluşan bir ızgaraya böler.
  • x: Karonun X koordinatı (sütun). 0 (en batı) ile 2yakınlaştırma - 1 (en doğu) arasında değişir.
  • y: Karonun Y koordinatı (satır). 0 (en kuzey) ile 2yakınlaştırma - 1 (en güney) arasında değişir.

Hava durumu haritasını göster

Bu karoları Google Maps JavaScript API'yi kullanarak bir web uygulamasında görüntülemek 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 yağış hava durumu haritası karoları 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 ikilidir. JSON sarmalayıcı yalnızca ?alt=json gibi belirli serileştirme ayarlarında görünür.