Mendapatkan peta cuaca (Eksperimental)

Produk atau fitur ini bersifat Eksperimental (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Endpoint mapTypes menyediakan ubin peta raster yang mewakili berbagai fenomena cuaca, seperti prakiraan curah hujan. Ubin peta ini dapat ditempatkan di atas Google Maps standar.

Catatan: Ubin peta cuaca mungkin tidak disinkronkan atau selaras dengan data yang disediakan oleh forecast:minute endpoint.

Persyaratan

Persyaratan ini dikeluarkan berdasarkan Pasal 6 (Persyaratan Penawaran Pra-GA) dalam Google Maps Platform Service Specific Terms, sebagaimana disepakati oleh Google dan Anda.

1.1 Persyaratan Atribusi. Pelanggan harus memberikan atribusi kepada Google sesuai dengan Dokumentasi jika Pelanggan menggunakan Konten Google Maps dari Weather API.

1.2 Pembatasan. Pelanggan tidak dapat menggunakan Konten Google Maps yang diambil dari Weather API untuk membuat ulang layanan atau produk Google (misalnya, menggunakan data yang diambil dari Weather API dalam aplikasi cuaca atau model cuaca yang tujuan utamanya adalah untuk memberikan informasi cuaca).

1.3 Penyimpanan dalam Cache. Pelanggan dapat menyimpan sementara Konten Google Maps yang berlaku dari Weather API untuk Periode Penyimpanan dalam Cache yang berlaku, seperti yang dijelaskan dalam Tabel 1.3.1 (Izin Penyimpanan dalam Cache).

Tabel 1.3.1 (Izin Penyimpanan dalam Cache)

Izin ini merupakan tambahan dari izin yang dijelaskan dalam Tabel 17.2.1 Persyaratan Khusus Layanan Google Maps Platform.

Konten Google Maps	Periode Penyimpanan dalam Cache
Ubin peta cuaca	Satu jam, setelah itu Pelanggan harus menghapus Konten Google Maps yang disimpan dalam cache

Tentang permintaan peta cuaca

Untuk meminta peta cuaca, kirim permintaan HTTP GET ke:

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

Jenis peta

Weather API mendukung berbagai jenis peta cuaca, yang sesuai dengan berbagai model cuaca dan area geografis yang mendasarinya:

• US_PRECIPITATION_CURRENT: Prakiraan curah hujan Amerika Serikat beresolusi tinggi.
• EU_PRECIPITATION_CURRENT: Prakiraan curah hujan Eropa beresolusi tinggi.

Peta cakupan di bawah menunjukkan wilayah tempat ubin peta cuaca tersedia:

Sistem koordinat ubin

API menggunakan sistem koordinat ubin Web Mercator standar. Untuk penjelasan lengkap tentang koordinat peta dan ubin, lihat Ubin peta dan Koordinat Peta dan Ubin.

Dalam sistem ini:

• zoom: Tingkat zoom (0 hingga 16). Tingkat zoom 0 mewakili seluruh dunia dalam satu ubin (2⁰ x 2⁰ = 1 ubin). Tingkat zoom z membagi dunia menjadi petak ubin 2^z x 2^z.
• x: Koordinat X (kolom) ubin, mulai dari 0 (paling barat) hingga 2^zoom - 1 (paling timur).
• y: Koordinat Y (baris) ubin, mulai dari 0 (paling utara) hingga 2^zoom - 1 (paling selatan).

Menampilkan peta cuaca

Untuk menampilkan ubin ini di aplikasi web menggunakan Google Maps JavaScript API, Anda dapat membuat google.maps.ImageMapType kustom:

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);

Contoh permintaan peta cuaca

Contoh berikut meminta ubin peta cuaca curah hujan AS untuk New Orleans:

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

Responsnya adalah biner. Wrapper JSON hanya muncul di setelan serialisasi tertentu, seperti ?alt=json.