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 parçaları, standart Google Haritalar'ın üzerine yerleştirilebilir.

Şartlar

Bu şartlar, Google ile sizin aranızda kabul edilen Google Maps Platform Hizmetine Özel Şartlar'ın Bölüm 6'sı (GKST Öncesi Teklif Koşulları) uyarınca yayınlanmıştır.

1.1 İlişkilendirme Şartları. Müşteri, Hava Durumu API'sinden 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, 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ınan 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: Yüksek çözünürlüklü ABD yağış anlık hava durumu.
  • EU_PRECIPITATION_CURRENT: Yüksek çözünürlüklü Avrupa 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 koordinat sistemi

API, standart Web Mercator döşeme koordinat sistemini kullanır. Harita ve karo koordinatlarının kapsamlı bir açıklaması için Yol haritası karoları ve Harita ve Karo 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 kuzey) ile 2zoom - 1 (en güney) arasında değişir.

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

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 ikili (binary) olmalıdır. JSON sarmalayıcı yalnızca belirli serileştirme ayarlarında (ör. ?alt=json) görünür.