Weather - Get Severe Weather Alerts

Referensi

Service:: Maps

API Version:: 1.1

Gunakan untuk mendapatkan informasi tentang kondisi cuaca buruk seperti badai, badai petir, banjir, petir, gelombang panas atau kebakaran hutan untuk lokasi tertentu.

Fenomena cuaca buruk dapat berdampak signifikan pada kehidupan sehari-hari dan operasi bisnis kita. Misalnya, kondisi cuaca buruk seperti badai tropis, angin kencang atau banjir dapat menutup jalan dan memaksa perusahaan logistik untuk mengalihkan rute armada mereka menyebabkan keterlambatan dalam mencapai tujuan dan memutus rantai dingin produk makanan berpendingin.

Get Severe Weather Alerts API adalah permintaan HTTP GET yang mengembalikan pemberitahuan cuaca buruk yang tersedia di seluruh dunia dari Badan Meteorologi Pemerintah resmi dan penyedia pemberitahuan cuaca global ke regional terkemuka. Layanan ini dapat mengembalikan detail seperti jenis pemberitahuan, kategori, tingkat, dan deskripsi terperinci tentang peringatan parah aktif untuk lokasi yang diminta, seperti badai, badai petir, petir, gelombang panas, atau kebakaran hutan. Untuk informasi selengkapnya, lihat Meminta pemberitahuan cuaca buruk

GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query={query}

With optional parameters:

GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query={query}&language={language}&details={details}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
format	path	True	JsonFormat	Format respons yang diinginkan. Hanya `json` format yang didukung.
api-version	query	True	string	Nomor versi API Azure Maps.
query	query	True	number[]	Kueri yang berlaku ditentukan sebagai string yang dipisahkan koma yang terdiri dari garis lintang diikuti oleh bujur misalnya "47.641268,-122.125679".
details	query		string	Mengembalikan detail lengkap untuk pemberitahuan cuaca buruk. Nilai yang tersedia adalah `true` - Mengembalikan detail lengkap. Secara default semua detail dikembalikan. `false` - Mengembalikan versi terpotong dari data pemberitahuan, yang mengecualikan deskripsi lengkap khusus area dari detail pemberitahuan (`alertDetails`).
language	query		string	Bahasa tempat hasil pencarian harus dikembalikan. Harus menjadi salah satu tag bahasa IETF yang didukung, tidak peka huruf besar/kecil. Saat data dalam bahasa tertentu tidak tersedia untuk bidang tertentu, bahasa default digunakan. Silakan merujuk ke Bahasa yang Didukung untuk detailnya.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
x-ms-client-id		string	Menentukan akun mana yang ditujukan untuk penggunaan bersama dengan model keamanan Microsoft Entra ID. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun bidang manajemen Azure Maps. Untuk menggunakan keamanan Microsoft Entra ID di Azure Maps lihat artikel berikut untuk panduan.

Respons

Nama	Jenis	Deskripsi
200 OK	SevereWeatherAlertsResult	OKE
Other Status Codes	ErrorResponse	Terjadi kesalahan tak terduga.

Keamanan

AADToken

Ini adalah Alur OAuth 2.0 Microsoft Entra. Saat dipasangkan dengan kontrol akses berbasis peran Azure, kontrol akses tersebut dapat digunakan untuk mengontrol akses ke Azure Maps REST API. Kontrol akses berbasis peran Azure digunakan untuk menunjuk akses ke satu atau beberapa Azure Maps akun sumber daya atau sub-sumber daya. Setiap pengguna, grup, atau perwakilan layanan dapat diberikan akses melalui peran bawaan atau peran kustom yang terdiri dari satu atau beberapa izin untuk Azure Maps REST API.

Untuk menerapkan skenario, sebaiknya lihat konsep autentikasi. Singkatnya, definisi keamanan ini menyediakan solusi untuk memodelkan aplikasi melalui objek yang mampu mengontrol akses pada API dan cakupan tertentu.

Catatan

Definisi keamanan ini memerlukan penggunaan x-ms-client-id header untuk menunjukkan sumber daya Azure Maps mana yang diminta akses aplikasi. Ini dapat diperoleh dari API manajemen Maps .

Authorization URL khusus untuk instans cloud publik Azure. Sovereign cloud memiliki URL Otorisasi yang unik dan konfigurasi Microsoft Entra ID. * Kontrol akses berbasis peran Azure dikonfigurasi dari bidang manajemen Azure melalui portal Azure, PowerShell, CLI, Azure SDK, atau REST API. * Penggunaan Azure Maps Web SDK memungkinkan penyiapan berbasis konfigurasi aplikasi untuk beberapa kasus penggunaan.

Untuk informasi selengkapnya tentang platform identitas Microsoft, lihat gambaran umum platform identitas Microsoft.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nama	Deskripsi
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Ini adalah kunci bersama yang disediakan saat Anda Create akun Azure Maps di portal Azure atau menggunakan PowerShell, CLI, Azure SDK, atau REST API.

Dengan kunci ini, aplikasi apa pun dapat mengakses semua REST API. Dengan kata lain, kunci ini dapat digunakan sebagai kunci master di akun tempat kunci tersebut dikeluarkan.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah menggunakan pendekatan aplikasi klien rahasia untuk mengakses Azure Maps REST API sehingga kunci Anda dapat disimpan dengan aman.

Type: apiKey
In: query

SAS Token

Ini adalah token tanda tangan akses bersama dibuat dari operasi Daftar SAS pada sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan token ini, aplikasi apa pun berwenang untuk mengakses dengan kontrol akses berbasis peran Azure dan kontrol halus ke kedaluwarsa, laju, dan wilayah penggunaan untuk token tertentu. Dengan kata lain, Token SAS dapat digunakan untuk memungkinkan aplikasi mengontrol akses dengan cara yang lebih aman daripada kunci bersama.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah mengonfigurasi daftar asal tertentu yang diizinkan di sumber daya akun Peta untuk membatasi penyalahgunaan penyalahgunaan dan memperbarui Token SAS secara teratur.

Type: apiKey
In: header

Contoh

Successfully retrieve severe weather alerts

Sample Request

HTTP

GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query=48.057,-81.091

Sample Response

Status code:: 200

{
  "results": [
    {
      "countryCode": "CA",
      "alertId": 242621,
      "description": {
        "localized": "Heat Warning",
        "english": "Heat Warning"
      },
      "category": "NON-PRECIPITATION",
      "priority": 31,
      "source": "Environment Canada",
      "sourceId": 3,
      "alertAreas": [
        {
          "name": "Kirkland Lake - Englehart",
          "summary": "Heat Warning in effect until Thursday, 3:16 AM EDT.  Source: Environment Canada",
          "startTime": "2020-06-29T19:44:00+00:00",
          "endTime": "2020-07-02T07:16:03+00:00",
          "latestStatus": {
            "localized": "Continue",
            "english": "Continue"
          },
          "alertDetails": "\nA heat event continues through Thursday.\n\nDaytime high temperatures in the low thirties with overnight lows near 18 degrees Celsius are expected to continue until Thursday. Humidex values are expected to reach between 36 and 40 today. Cooler air will move into the region Thursday night. \n\nPlease refer to your public forecast for further details on expected temperatures.\n\nHot and humid air can also bring deteriorating air quality and can result in the air quality health index to approach the high risk category.\n\n###\n\nExtreme heat affects everyone.\n\nThe risks are greater for young children, pregnant women, older adults, people with chronic illnesses and people working or exercising outdoors.\n\nWatch for the effects of heat illness: swelling, rash, cramps, fainting, heat exhaustion, heat stroke and the worsening of some health conditions.\n\nPlease continue to monitor alerts and forecasts issued by Environment Canada. To report severe weather, send an email to ONstorm@canada.ca or tweet reports using #ONStorm.\n",
          "alertDetailsLanguageCode": "en-CA"
        }
      ]
    },
    {
      "countryCode": "CA",
      "alertId": 242633,
      "description": {
        "localized": "Heat Warning",
        "english": "Heat Warning"
      },
      "category": "NON-PRECIPITATION",
      "priority": 31,
      "source": "Environment Canada",
      "sourceId": 3,
      "alertAreas": [
        {
          "name": "Kirkland Lake - Englehart",
          "summary": "Heat Warning in effect until 9:25 PM EDT.  Source: Environment Canada",
          "startTime": "2020-07-01T09:25:59+00:00",
          "endTime": "2020-07-02T01:25:59+00:00",
          "latestStatus": {
            "localized": "New",
            "english": "New"
          },
          "alertDetails": "\nA heat event is expected through Thursday.  \n\nDaytime high temperatures in the low thirties on Wednesday and Thursday with overnight lows near 18 degrees Celsius are expected. This heat event may be extended into the weekend with daytime high temperatures near 30 degrees Celsius. \n\nPlease refer to your public forecast for further details on expected temperatures.  \n\nHot and humid air can also bring deteriorating air quality and can result in the Air Quality Health Index to approach the high risk category.\n\n###\n\nExtreme heat affects everyone.\n\nThe risks are greater for young children, pregnant women, older adults, people with chronic illnesses and people working or exercising outdoors.\n\nPlease continue to monitor alerts and forecasts issued by Environment Canada. To report severe weather, send an email to ONstorm@canada.ca or tweet reports using #ONStorm.\n",
          "alertDetailsLanguageCode": "en-CA"
        }
      ]
    }
  ]
}

Definisi

Nama	Deskripsi
AlertArea	Informasi tentang pemberitahuan cuaca buruk yang dikeluarkan dalam area yang terkena dampak. Jika beberapa pemberitahuan aktif untuk lokasi yang sama, pemberitahuan akan dikembalikan dalam urutan `priority` dalam respons API, dengan pemberitahuan prioritas tertinggi dikembalikan di bagian atas respons.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
JsonFormat	Format respons yang diinginkan. Hanya `json` format yang didukung.
LatestStatus	Status terbaru pada pemberitahuan di area saat ini.
LatestStatusKeyword	Kata kunci untuk status terbaru pemberitahuan.
SevereWeatherAlert	Informasi tentang pemberitahuan cuaca buruk.
SevereWeatherAlertDescription	Deskripsi pemberitahuan cuaca buruk.
SevereWeatherAlertsResult	Objek ini dikembalikan dari panggilan Dapatkan Pemberitahuan Cuaca Buruk yang berhasil.

AlertArea

Informasi tentang pemberitahuan cuaca buruk yang dikeluarkan dalam area yang terkena dampak. Jika beberapa pemberitahuan aktif untuk lokasi yang sama, pemberitahuan akan dikembalikan dalam urutan priority dalam respons API, dengan pemberitahuan prioritas tertinggi dikembalikan di bagian atas respons.

Nama	Jenis	Deskripsi
alertDetails	string	Detail lengkap yang terkait dengan pemberitahuan. Dikembalikan jika `details`=True. Bidang ini selalu dikembalikan dalam bahasa pilihan oleh penyedia penerbit dan Azure Maps hanya mengembalikan apa yang dibuat oleh penyedia. Harap dicatat, beberapa negara/wilayah mungkin menawarkan bahasa asli dan bahasa Inggris mereka. Parameter bahasa tidak akan berlaku untuk bidang ini.
alertDetailsLanguageCode	string	Bahasa .`alertDetails` Bidang ini membantu menunjukkan bahwa bahasa yang mungkin berbeda dari `alertDetails` parameter bahasa yang diminta. Dikembalikan jika `details`=True. Kode bahasa telah berasal dari kode ISO 639-1 Alpha-2.
endTime	string	Tanggal dan waktu akhir pemberitahuan dalam format ISO 8601, misalnya, 2019-10-27T19:39:57-08:00. Jika pemberitahuan melintasi beberapa zona waktu, waktu yang dikembalikan dalam respons adalah waktu lokal ke lokasi koordinat yang diminta.
latestStatus	LatestStatus	Status terbaru pemberitahuan di area saat ini.
name	string	Nama area yang dipengaruhi oleh pemberitahuan. Lokasi yang diminta berada di bawah area pemberitahuan.
startTime	string	Tanggal dan waktu mulai pemberitahuan dalam format ISO 8601, misalnya, 2019-10-27T19:39:57-08:00. Jika pemberitahuan melintasi beberapa zona waktu, waktu yang dikembalikan dalam respons adalah waktu lokal ke lokasi koordinat yang diminta.
summary	string	Teks yang meringkas pemberitahuan di area yang dikembalikan.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

JsonFormat

Format respons yang diinginkan. Hanya json format yang didukung.

Nama	Jenis	Deskripsi
json	string	Format Pertukaran Data Notasi Objek JavaScript

LatestStatus

Status terbaru pada pemberitahuan di area saat ini.

Nama	Jenis	Deskripsi
english	LatestStatusKeyword	Kata kunci status terbaru untuk pemberitahuan, dalam bahasa Inggris (id-ID).
localized	string	Kata kunci status terbaru untuk pemberitahuan, dalam bahasa yang ditentukan. Secara default, dikembalikan dalam bahasa Inggris (en-US).

LatestStatusKeyword

Kata kunci untuk status terbaru pemberitahuan.

Nama	Jenis	Deskripsi
Cancel	string	"Batal" - pemberitahuan telah dibatalkan sebelum waktu kedaluwarsa aslinya.
Continue	string	"Lanjutkan" - pemberitahuan telah diperbarui sejak penerbitan awalnya, tetapi tidak ada perubahan yang dilakukan pada `alertDetails`, , `endTimestartTime`, atau `class`.
Correct	string	"Benar" - pemberitahuan telah dimodifikasi untuk memperbaiki kesalahan sebelumnya.
Expire	string	"Kedaluwarsa" - pemberitahuan telah kedaluwarsa dan tidak lagi aktif.
Extend	string	"Perluas" - pemberitahuan telah diperpanjang dalam waktu, di area, atau keduanya sejak penerbitan awal.
New	string	"Baru" - status pemberitahuan setelah penerbitan awal.
Update	string	"Perbarui" - pemberitahuan telah diperbarui sejak penerbitan awal.
Upgrade	string	"Tingkatkan" - pemberitahuan telah ditingkatkan ke kelas atau kategori yang lebih tinggi sejak penerbitan awalnya.

SevereWeatherAlert

Informasi tentang pemberitahuan cuaca buruk.

Nama	Jenis	Deskripsi
alertAreas	AlertArea[]	Informasi tentang pemberitahuan khusus untuk area yang terpengaruh.
alertId	integer	Pengidentifikasi numerik unik untuk pemberitahuan cuaca.
category	string	Kategori pemberitahuan.
class	string	Klasifikasi pemberitahuan. Bidang ini tidak tersedia untuk semua negara dan oleh karena itu tidak selalu dikembalikan.
countryCode	string	Kode negara ISO 3166-1 Alpha-2 2 2 karakter, misalnya, "AS".
description	SevereWeatherAlertDescription	Deskripsi pemberitahuan.
disclaimer	string	Sanggahan mengenai sumber informasi pemberitahuan. Bidang ini tidak selalu tersedia. Misalnya, sanggahan dapat mencakup detail tentang penundaan atau potensi masalah yang terkait dengan alarm.
level	string	Tingkat keparahan pemberitahuan. Bidang ini tidak tersedia untuk semua negara dan oleh karena itu tidak selalu dikembalikan.
priority	integer	Angka yang menandakan pentingnya atau urutan peringkat pemberitahuan yang diberikan dalam negara/wilayah asalnya. Angka yang lebih rendah menandakan prioritas yang lebih tinggi. Misalnya, 1 adalah prioritas tertinggi. Jumlahnya bervariasi menurut negara/wilayah dan dapat berubah dari waktu ke waktu karena setiap negara/wilayah mengembangkan sistem pemberitahuan mereka.
source	string	Penyedia informasi pemberitahuan. Secara default sumber dikembalikan dalam bahasa Inggris (en-US). Pemberitahuan tersebut berasal dari Badan Meteorologi Pemerintah resmi dan penyedia peringatan cuaca global terkemuka.
sourceId	integer	Pengidentifikasi numerik yang terkait dengan nama penyedia sumber data pemberitahuan.

SevereWeatherAlertDescription

Deskripsi pemberitahuan cuaca buruk.

Nama	Jenis	Deskripsi
english	string	Deskripsi pemberitahuan dalam bahasa Inggris (id-ID).
localized	string	Deskripsi pemberitahuan dalam bahasa yang ditentukan. Secara default bahasa Inggris (en-US) dikembalikan jika parameter bahasa tidak ditentukan dalam permintaan.

SevereWeatherAlertsResult

Objek ini dikembalikan dari panggilan Dapatkan Pemberitahuan Cuaca Buruk yang berhasil.

Nama	Jenis	Deskripsi
results	SevereWeatherAlert[]	Daftar semua pemberitahuan cuaca buruk untuk lokasi yang dikueri.