Weather - Get Daily Forecast
Gunakan untuk mendapatkan prakiraan cuaca terperinci harian untuk 1, 5, 10, 15, 25, atau 45 hari ke depan.
Get Daily Forecast
API adalah permintaan HTTP GET
yang mengembalikan prakiraan cuaca terperinci seperti suhu dan angin pada hari untuk 1, 5, 10, 15, 25, atau 45 hari ke depan untuk lokasi koordinat tertentu. Responsnya mencakup detail seperti suhu, angin, curah hujan, kualitas udara, dan indeks UV. Untuk informasi selengkapnya, lihat Meminta data prakiraan cuaca harian.
Jika Anda menggunakan tingkat harga Gen1 S0, Anda dapat meminta prakiraan harian untuk 1, 5, 10, dan 15 hari ke depan. Jika Anda menggunakan tingkat harga Gen1 S1 atau Gen2, Anda juga dapat meminta prakiraan harian selama 25 hari ke depan, dan 45 hari.
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
format
|
path | True |
Format respons yang diinginkan. Hanya |
|
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". |
duration
|
query |
integer |
Menentukan berapa hari respons prakiraan harian dikembalikan. Nilai yang tersedia adalah
|
|
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. |
|
unit
|
query |
Menentukan untuk mengembalikan data dalam unit metrik atau unit kekaisaran. Nilai default adalah metrik. |
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 |
OK |
|
Other Status Codes |
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 detailed daily weather forecast for a given coordinate location
Sample Request
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5
Sample Response
{
"summary": {
"startDate": "2019-11-17T09:00:00-08:00",
"endDate": "2019-11-17T15:00:00-08:00",
"severity": 5,
"phrase": "Rain Sunday evening",
"category": "rain"
},
"forecasts": [
{
"date": "2019-11-13T21:00:00-08:00",
"temperature": {
"minimum": {
"value": 0.8,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 5.3,
"unit": "C",
"unitType": 17
}
},
"realFeelTemperature": {
"minimum": {
"value": -3.4,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 1.3,
"unit": "C",
"unitType": 17
}
},
"realFeelTemperatureShade": {
"minimum": {
"value": -3.4,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 1.6,
"unit": "C",
"unitType": 17
}
},
"hoursOfSun": 1.1,
"degreeDaySummary": {
"heating": {
"value": 15,
"unit": "C",
"unitType": 17
},
"cooling": {
"value": 0,
"unit": "C",
"unitType": 17
}
},
"airAndPollen": [
{
"name": "AirQuality",
"value": 0,
"category": "Good",
"categoryValue": 1,
"type": "Ozone"
},
{
"name": "Grass",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "Mold",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "Ragweed",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "Tree",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "UVIndex",
"value": 0,
"category": "Low",
"categoryValue": 1
}
],
"day": {
"iconCode": 12,
"iconPhrase": "Showers",
"hasPrecipitation": true,
"precipitationType": "Rain",
"precipitationIntensity": "Light",
"shortPhrase": "Cloudy with a few showers",
"longPhrase": "Cloudy with a couple of showers, mainly later",
"precipitationProbability": 75,
"thunderstormProbability": 20,
"rainProbability": 75,
"snowProbability": 40,
"iceProbability": 0,
"wind": {
"direction": {
"degrees": 160,
"localizedDescription": "SSE"
},
"speed": {
"value": 16.7,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"direction": {
"degrees": 160,
"localizedDescription": "SSE"
},
"speed": {
"value": 48.2,
"unit": "km/h",
"unitType": 7
}
},
"totalLiquid": {
"value": 6.1,
"unit": "mm",
"unitType": 3
},
"rain": {
"value": 6.1,
"unit": "mm",
"unitType": 3
},
"snow": {
"value": 0,
"unit": "cm",
"unitType": 4
},
"ice": {
"value": 0,
"unit": "mm",
"unitType": 3
},
"hoursOfPrecipitation": 3.5,
"hoursOfRain": 3.5,
"hoursOfSnow": 0,
"hoursOfIce": 0,
"cloudCover": 100
},
"night": {
"iconCode": 12,
"iconPhrase": "Showers",
"hasPrecipitation": true,
"precipitationType": "Rain",
"precipitationIntensity": "Light",
"shortPhrase": "Breezy early; cloudy",
"longPhrase": "Breezy this evening; otherwise, low clouds",
"precipitationProbability": 65,
"thunderstormProbability": 0,
"rainProbability": 64,
"snowProbability": 40,
"iceProbability": 0,
"wind": {
"direction": {
"degrees": 181,
"localizedDescription": "S"
},
"speed": {
"value": 20.4,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"direction": {
"degrees": 170,
"localizedDescription": "S"
},
"speed": {
"value": 42.6,
"unit": "km/h",
"unitType": 7
}
},
"totalLiquid": {
"value": 4,
"unit": "mm",
"unitType": 3
},
"rain": {
"value": 4,
"unit": "mm",
"unitType": 3
},
"snow": {
"value": 0,
"unit": "cm",
"unitType": 4
},
"ice": {
"value": 0,
"unit": "mm",
"unitType": 3
},
"hoursOfPrecipitation": 2.5,
"hoursOfRain": 2.5,
"hoursOfSnow": 0,
"hoursOfIce": 0,
"cloudCover": 98
},
"sources": [
"AccuWeather"
]
}
]
}
Definisi
Nama | Deskripsi |
---|---|
Air |
|
Daily |
|
Daily |
|
Daily |
Ringkasan untuk kondisi utama untuk periode waktu yang diminta. Perhatikan bahwa ringkasan hanya dapat mencakup bagian dari periode waktu. |
Day |
|
Degree |
|
Error |
Info tambahan kesalahan manajemen sumber daya. |
Error |
Detail kesalahan. |
Error |
Respons kesalahan |
Icon |
Nilai numerik yang mewakili gambar yang menampilkan |
Json |
Format respons yang diinginkan. Hanya |
Local |
Informasi penyedia data cuaca lokal. |
Precipitation |
Menentukan jenis curah hujan ("Hujan" "Salju" "Es" atau "Campuran"). Jika dbz nol, precipitationType tidak ada dalam respons. |
Unit |
Nilai ID numerik yang terkait dengan jenis unit yang ditampilkan. Dapat digunakan untuk terjemahan unit. Silakan merujuk ke layanan Cuaca di Azure Maps untuk detailnya. |
Weather |
Menentukan untuk mengembalikan data di unit metrik atau unit kekaisaran. Nilai defaultnya adalah metrik. |
Weather |
Nilai spesifik unit tertentu yang terkait dengan cuaca. |
Weather |
Mengembalikan nilai suhu. |
Wind |
Detail angin dikembalikan termasuk kecepatan dan arah. |
Wind |
Arah Angin |
AirAndPollen
Nama | Jenis | Deskripsi |
---|---|---|
category |
string |
Kategori kualitas udara atau jenis polusi. Misalnya, rendah, tinggi, baik, sedang, tidak sehat, berbahaya. |
categoryValue |
integer |
Nilai yang terkait dengan kualitas udara atau kategori polusi. Nilai-nilai ini berkisar dari 1 hingga 6. 1 menyiratkan kondisi yang baik, 6 menyiratkan kondisi berbahaya. |
name |
string |
Nama tepungsil atau jaksa. Misalnya, rumput, jamur, gulma, kualitas udara, pohon dan indeks UV. |
type |
string |
Hanya ada untuk kualitas udara. Contohnya termasuk ozon dan polusi partikel. |
value |
integer |
Nilai jenis yang diberikan di atas. Nilai yang terkait dengan jamur, rumput, gulma, dan pohon berada dalam satuan bagian per meter kubik. Baik kualitas udara maupun UV adalah indeks, sehingga tidak bersatu. |
DailyForecast
Nama | Jenis | Deskripsi |
---|---|---|
airAndPollen |
Kualitas udara |
|
date |
string |
Tanggal dan waktu pengamatan saat ini ditampilkan dalam format ISO 8601, misalnya, 2019-10-27T19:39:57-08:00. |
day |
Detail prakiraan hari |
|
degreeDaySummary |
Ringkasan untuk suhu rata-rata informasi Heating Degree Day atau Cooling Degree Day |
|
hoursOfSun |
number |
Berjam-jam matahari. |
night |
Detail prakiraan malam |
|
realFeelTemperature |
Suhu RealFeelâ„¢ dikembalikan. |
|
realFeelTemperatureShade |
Suhu RealFeelâ„¢ dikembalikan. Menjelaskan bagaimana suhu benar-benar terasa seperti di tempat teduh. |
|
sources |
string[] |
Sumber data prakiraan. |
temperature |
Nilai suhu untuk hari itu. |
DailyForecastResult
Nama | Jenis | Deskripsi |
---|---|---|
forecasts |
Memperkirakan data untuk setiap hari yang diminta. |
|
summary |
Ringkasan untuk kondisi utama untuk periode waktu yang diminta. Perhatikan bahwa ringkasan hanya dapat mencakup bagian dari periode waktu. |
DailyForecastSummary
Ringkasan untuk kondisi utama untuk periode waktu yang diminta. Perhatikan bahwa ringkasan hanya dapat mencakup bagian dari periode waktu.
Nama | Jenis | Deskripsi |
---|---|---|
category |
string |
satu atau 2 kata untuk meringkas frasa. |
endDate |
string |
Tanggal dan waktu periode ringkasan berakhir, ditampilkan dalam format ISO 8601, misalnya, 2019-10-27T19:39:57-08:00. |
phrase |
string |
Frasa ringkasan prakiraan harian. Ditampilkan dalam bahasa yang ditentukan. |
severity |
integer |
tingkat keparahan |
startDate |
string |
Tanggal dan waktu ringkasan berlaku, ditampilkan dalam format ISO 8601, misalnya, 2019-10-27T19:39:57-08:00. |
DayOrNight
Nama | Jenis | Deskripsi |
---|---|---|
cloudCover |
integer |
Persen mewakili penutup cloud. |
hasPrecipitation |
boolean |
Menunjukkan ada atau tidak adanya curah hujan. True menunjukkan adanya curah hujan, salah menunjukkan tidak adanya curah hujan. |
hoursOfIce |
number |
Jam es. |
hoursOfPrecipitation |
number |
Jam curah hujan |
hoursOfRain |
number |
Jam hujan. |
hoursOfSnow |
number |
Jam salju. |
ice |
Es |
|
iceProbability |
integer |
Persen mewakili probabilitas es. Misalnya, '30'. |
iconCode |
Nilai numerik yang mewakili gambar yang menampilkan |
|
iconPhrase |
string |
Deskripsi frasa ikon. Ditampilkan dalam bahasa yang ditentukan. Misalnya, 'Sunny'. |
localSource |
Informasi penyedia data cuaca lokal. |
|
longPhrase |
string |
Deskripsi frasa prakiraan dalam bahasa tertentu. Azure Maps mencoba untuk mempertahankan panjang frasa ini di bawah 100 karakter, tetapi beberapa bahasa/peristiwa cuaca dapat menghasilkan panjang frasa yang lebih panjang, melebihi 100 karakter. |
precipitationIntensity |
string |
Deskripsi intensitas. |
precipitationProbability |
integer |
Persen yang mewakili probabilitas curah hujan. Misalnya, '20'. |
precipitationType |
Menentukan jenis curah hujan ("Hujan" "Salju" "Es" atau "Campuran"). Jika dbz nol, precipitationType tidak ada dalam respons. |
|
rain |
Hujan |
|
rainProbability |
integer |
Persen mewakili kemungkinan hujan. Misalnya, '40'. |
shortPhrase |
string |
Deskripsi frasa prakiraan dalam bahasa tertentu. Azure Maps mencoba untuk mempertahankan panjang frasa ini di bawah 30 karakter, tetapi beberapa bahasa/peristiwa cuaca dapat menghasilkan panjang frasa yang lebih panjang, melebihi 30 karakter. |
snow |
Salju |
|
snowProbability |
integer |
Persen mewakili kemungkinan salju. Misalnya, '30'. |
thunderstormProbability |
integer |
Persen mewakili probabilitas badai petir. Misalnya, '80'. |
totalLiquid |
Total cairan yang setara dengan curah hujan selama periode prakiraan. |
|
wind |
Detail angin dikembalikan termasuk kecepatan dan arah. |
|
windGust |
Embusan angin. Embusan angin tiba-tiba, peningkatan singkat dalam kecepatan angin. |
DegreeDaySummary
Nama | Jenis | Deskripsi |
---|---|---|
cooling |
Jumlah derajat suhu rata-rata di atas 65 derajat F/ 18 derajat C. |
|
heating |
Jumlah derajat yang suhu rata-rata di bawah 65 derajat F/ 18 derajat C. |
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 |
Info tambahan kesalahan. |
|
code |
string |
Kode kesalahan. |
details |
Detail kesalahan. |
|
message |
string |
Pesan kesalahan. |
target |
string |
Target kesalahan. |
ErrorResponse
Respons kesalahan
Nama | Jenis | Deskripsi |
---|---|---|
error |
Objek kesalahan. |
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 |
JsonFormat
Format respons yang diinginkan. Hanya json
format yang didukung.
Nama | Jenis | Deskripsi |
---|---|---|
json |
string |
LocalSource
Informasi penyedia data cuaca lokal.
Nama | Jenis | Deskripsi |
---|---|---|
id |
integer |
Pengidentifikasi numerik, unik untuk penyedia data lokal. |
name |
string |
Nama penyedia data lokal. Nama ditampilkan dalam bahasa yang ditentukan oleh kode bahasa di URL, jika tersedia. Jika tidak, Nama ditampilkan dalam bahasa Inggris atau bahasa tempat nama disediakan. |
weatherCode |
string |
Kode cuaca yang disediakan oleh penyedia data lokal. Kode cuaca ini memungkinkan prakiraan dicocokkan dengan ikon yang disediakan oleh penyedia data lokal alih-alih ikon Azure Maps. |
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 |
UnitType
Nilai ID numerik yang terkait dengan jenis unit yang ditampilkan. Dapat digunakan untuk terjemahan unit. Silakan merujuk ke layanan Cuaca di Azure Maps untuk detailnya.
Nama | Jenis | Deskripsi |
---|---|---|
0 |
Integer |
|
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 |
|
3 |
Integer |
|
31 |
Integer |
|
4 |
Integer |
|
5 |
Integer |
|
6 |
Integer |
|
7 |
Integer |
|
8 |
Integer |
|
9 |
Integer |
WeatherDataUnit
Menentukan untuk mengembalikan data di unit metrik atau unit kekaisaran. Nilai defaultnya adalah metrik.
Nama | Jenis | Deskripsi |
---|---|---|
imperial |
string |
Mengembalikan data dalam unit kekaisaran. Beberapa contoh unit sistem kekaisaran adalah Fahrenheit dan mil. |
metric |
string |
Mengembalikan data dalam unit metrik. Beberapa contoh unit sistem metrik adalah Celcius dan kilometer. |
WeatherUnit
Nilai spesifik unit tertentu yang terkait dengan cuaca.
Nama | Jenis | Deskripsi |
---|---|---|
unit |
string |
Jenis unit untuk nilai yang dikembalikan. |
unitType |
Nilai ID numerik yang terkait dengan jenis unit yang ditampilkan. Dapat digunakan untuk terjemahan unit. Silakan merujuk ke layanan Cuaca di Azure Maps untuk detailnya. |
|
value |
number |
Nilai yang dibulatkan. |
WeatherUnitRange
Mengembalikan nilai suhu.
Nama | Jenis | Deskripsi |
---|---|---|
maximum |
Suhu maksimum untuk periode waktu |
|
minimum |
Suhu minimum untuk periode waktu. |
WindDetails
Detail angin dikembalikan termasuk kecepatan dan arah.
Nama | Jenis | Deskripsi |
---|---|---|
direction |
Arah Angin |
|
speed |
Kecepatan angin dalam unit yang ditentukan. |
WindDirection
Arah Angin
Nama | Jenis | Deskripsi |
---|---|---|
degrees |
integer |
Arah angin di Azimuth derajat, mulai dari utara benar dan terus dalam arah searah jajaran. Utara adalah 0 derajat, timur adalah 90 derajat, selatan adalah 180 derajat, barat adalah 270 derajat. Kemungkinan nilai 0-359. |
localizedDescription |
string |
Singkatan arah dalam bahasa yang ditentukan. |