Weather - Get Minute Forecast

Referensi

Layanan:: Maps

Versi API:: 1.1

Gunakan untuk mendapatkan prakiraan menit demi menit selama 120 menit ke depan dalam interval 1, 5, dan 15 menit.

Get Minute Forecast API adalah permintaan HTTP GET yang mengembalikan perkiraan menit demi menit untuk lokasi tertentu selama 120 menit ke depan. Pengguna dapat meminta prakiraan cuaca dalam interval 1, 5 dan 15 menit. Respons akan mencakup detail seperti jenis curah hujan (termasuk hujan, salju, atau campuran keduanya), waktu mulai, dan nilai intensitas curah hujan (dBZ). Untuk informasi selengkapnya, lihat Meminta data prakiraan cuaca menit demi menit.

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

Dengan parameter opsional:

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query={query}&interval={interval}&language={language}

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 dengan bujur misalnya " 47.641268,-122.125679".
interval	query		integer	Menentukan interval waktu dalam menit untuk prakiraan cuaca yang dikembalikan. Nilai yang didukung adalah `1` - Ambil perkiraan untuk interval 1 menit. Dikembalikan secara default. `5` - Ambil prakiraan untuk interval 5 menit. `15` - Ambil prakiraan untuk interval 15 menit.
language	query		string	Bahasa di mana 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 ID Microsoft Entra. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun bidang manajemen Azure Maps. Untuk menggunakan keamanan ID Microsoft Entra di Azure Maps, lihat artikel berikut ini untuk panduan.

Respons

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

Keamanan

AADToken

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

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 meminta 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 ID Microsoft Entra. * Kontrol akses berbasis peran Azure dikonfigurasi dari bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API. * Penggunaan Azure Maps Web SDK memungkinkan penyiapan aplikasi berbasis konfigurasi untuk beberapa kasus penggunaan.

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

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

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

subscription-key

Ini adalah kunci bersama yang disediakan saat Anda Membuat akun Azure Maps di portal Microsoft 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 REST API Azure Maps sehingga kunci Anda dapat disimpan dengan aman.

Jenis: apiKey
Dalam: 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 Microsoft 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.

Jenis: apiKey
Dalam: header

Contoh

Successfully retrieve minute-by-minute forecasts for a given location

Permintaan sampel

HTTP

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query=47.632346,-122.138874&interval=15

Respon sampel

Kode status:: 200

{
  "summary": {
    "briefPhrase60": "Rain ending in 25 min",
    "shortPhrase": "Rain ending in 25 min",
    "briefPhrase": "Rain ending in 25 min",
    "longPhrase": "Rain ending in 25 min",
    "iconCode": 12
  },
  "intervalSummaries": [
    {
      "startMinute": 0,
      "endMinute": 24,
      "totalMinutes": 25,
      "shortPhrase": "Rain ending in %minute_value min",
      "briefPhrase": "Rain ending in %minute_value min",
      "longPhrase": "Rain ending in %minute_value min",
      "iconCode": 12
    },
    {
      "startMinute": 25,
      "endMinute": 119,
      "totalMinutes": 95,
      "shortPhrase": "No precip for %MINUTE_VALUE min",
      "briefPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "longPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "iconCode": 7
    }
  ],
  "intervals": [
    {
      "startTime": "2019-11-14T15:18:00-08:00",
      "minute": 0,
      "dbz": 23,
      "shortPhrase": "Light Rain",
      "threshold": "LIGHT",
      "color": {
        "red": 8,
        "green": 98,
        "blue": 2,
        "hex": "#086202"
      },
      "simplifiedColor": {
        "red": 35,
        "green": 190,
        "blue": 39,
        "hex": "#23BE27"
      },
      "precipitationType": "Rain",
      "iconCode": 12,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T15:33:00-08:00",
      "minute": 15,
      "dbz": 18,
      "shortPhrase": "Light Rain",
      "threshold": "LIGHT",
      "color": {
        "red": 32,
        "green": 133,
        "blue": 9,
        "hex": "#208509"
      },
      "simplifiedColor": {
        "red": 35,
        "green": 190,
        "blue": 39,
        "hex": "#23BE27"
      },
      "precipitationType": "Rain",
      "iconCode": 12,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T15:48:00-08:00",
      "minute": 30,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:03:00-08:00",
      "minute": 45,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:18:00-08:00",
      "minute": 60,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:33:00-08:00",
      "minute": 75,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:48:00-08:00",
      "minute": 90,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T17:03:00-08:00",
      "minute": 105,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    }
  ]
}

Definisi

Nama	Deskripsi
ColorValue
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
ForecastInterval
IconCode	Nilai numerik yang mewakili gambar yang menampilkan `iconPhrase`. Silakan merujuk ke layanan Cuaca di Azure Maps untuk detailnya.
IntervalSummary
JsonFormat	Format respons yang diinginkan. Hanya `json` format yang didukung.
MinuteForecastResult
MinuteForecastSummary	Ringkasan frasa untuk seluruh periode prakiraan.
PrecipitationType	Menentukan jenis curah hujan ("Hujan" "Salju" "Es" atau "Campuran"). Jika dbz nol, precipitationType tidak ada dalam respons.

ColorValue

Nama	Jenis	Deskripsi
blue	integer	Komponen biru dari nilai RGB
green	integer	Komponen hijau dari nilai RGB.
hex	string	Nilai warna heksadesimal.
red	integer	Komponen merah dari nilai RGB.

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.

ForecastInterval

Nama	Jenis	Deskripsi
cloudCover	integer	Persen yang mewakili penutup cloud.
color	ColorValue	Warna spektrum lengkap yang memetakan ke dBZ (desibel relatif terhadap Z). Jika dbz nol, warna tidak ada dalam respons.
dbz	number	Unit yang mewakili perkiraan intensitas curah hujan.
iconCode	IconCode	Nilai numerik yang mewakili gambar yang menampilkan `iconPhrase`. Silakan merujuk ke layanan Cuaca di Azure Maps untuk detailnya.
minute	integer	Menit pertama untuk interval.
precipitationType	PrecipitationType	Menentukan jenis curah hujan ("Hujan" "Salju" "Es" atau "Campuran"). Jika dbz nol, precipitationType tidak ada dalam respons.
shortPhrase	string	Frasa singkat yang menjelaskan kondisi curah hujan untuk interval.
simplifiedColor	ColorValue	Warna pita yang memetakan ke jenis dan ambang batas curah hujan. Jika dbz nol, tidak ada dalam respons.
startTime	string	Tanggal dan waktu untuk awal interval dalam format ISO 8601, misalnya, 2019-10-27T19:39:57-08:00.
threshold	string	Kunci yang menentukan nilai ambang batas. Seiring dengan precipitationType, dapat digunakan untuk menentukan simplifiedColor. Jika dbz nol, tidak ada dalam respons.

IconCode

Nilai numerik yang mewakili gambar yang menampilkan iconPhrase. Silakan merujuk ke layanan Cuaca di Azure Maps untuk detailnya.

Nama	Jenis	Deskripsi
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
23	Integer
24	Integer
25	Integer
26	Integer
27	Integer
28	Integer
29	Integer
3	Integer
30	Integer
31	Integer
32	Integer
33	Integer
34	Integer
35	Integer
36	Integer
37	Integer
38	Integer
39	Integer
4	Integer
40	Integer
41	Integer
42	Integer
43	Integer
44	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

IntervalSummary

Nama	Jenis	Deskripsi
briefPhrase	string	Frasa ringkasan singkat. Panjang frasa sekitar 60 karakter.
endMinute	integer	Menit terakhir di mana ringkasan berlaku.
iconCode	IconCode	Nilai numerik yang mewakili gambar yang menampilkan `iconPhrase`. Silakan merujuk ke layanan Cuaca di Azure Maps untuk detailnya.
longPhrase	string	Frasa ringkasan panjang. Panjang frasa adalah 60+ karakter.
shortPhrase	string	Frasa ringkasan singkat. Panjang frasa sekitar 25 karakter.
startMinute	integer	Menit pertama di mana ringkasan berlaku.
totalMinutes	integer	Jumlah menit yang ringkasannya berlaku.

JsonFormat

Format respons yang diinginkan. Hanya json format yang didukung.

Nama	Jenis	Deskripsi
json	string	Format Pertukaran Data Notasi Objek JavaScript

MinuteForecastResult

Nama	Jenis	Deskripsi
intervalSummaries	IntervalSummary[]	Informasi ringkasan untuk setiap interval dalam prakiraan. Ringkasan memecah setiap interval potensial di mana curah hujan dimulai dan berhenti.
intervals	ForecastInterval[]	Prakiraan data untuk setiap interval dalam prakiraan.
summary	MinuteForecastSummary	Ringkasan frasa untuk seluruh periode prakiraan.

MinuteForecastSummary

Ringkasan frasa untuk seluruh periode prakiraan.

Nama	Jenis	Deskripsi
briefPhrase	string	Frasa ringkasan selama 120 menit ke depan. Panjang frasa sekitar 60 karakter.
briefPhrase60	string	Frasa ringkasan selama 60 menit ke depan. Panjang frasa sekitar 60 karakter.
iconCode	IconCode	Nilai numerik yang mewakili gambar yang menampilkan `iconPhrase`. Silakan merujuk ke layanan Cuaca di Azure Maps untuk detailnya.
longPhrase	string	Frasa ringkasan panjang selama 120 menit ke depan. Panjang frasa adalah 60+ karakter.
shortPhrase	string	Frasa ringkasan singkat selama 120 menit ke depan. Panjang frasa sekitar 25 karakter.

PrecipitationType

Menentukan jenis curah hujan ("Hujan" "Salju" "Es" atau "Campuran"). Jika dbz nol, precipitationType tidak ada dalam respons.

Nama	Jenis	Deskripsi
Ice	string	Es
Mix	string	Campuran
Rain	string	Hujan
Snow	string	Salju

Bagikan melalui