Weather - Get Quarter Day Forecast

Referensi

Layanan:: Maps

Versi API:: 1.1

Gunakan untuk mendapatkan perkiraan Quarter-Day untuk 1, 5, 10, atau 15 hari ke depan.

Get Quarter-Day Forecast API adalah permintaan HTTP GET yang mengembalikan prakiraan cuaca terperinci per seperempat hari untuk 1, 5, 10, atau 15 hari ke depan untuk lokasi tertentu. Data respons disajikan oleh perempat hari - pagi, sore, malam, dan semalam. Detail seperti suhu, kelembaban, angin, curah hujan, dan indeks UV dikembalikan.

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

Dengan parameter opsional:

GET https://atlas.microsoft.com/weather/forecast/quarterDay/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&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 oleh bujur misalnya "47.641268,-122.125679".
duration	query		integer	Menentukan berapa hari respons prakiraan quester-day dikembalikan. Nilai yang didukung adalah: `1` - Mengembalikan data prakiraan untuk hari berikutnya. Dikembalikan secara default. `5` - Mengembalikan data prakiraan selama 5 hari ke depan. `10` - Mengembalikan data prakiraan selama 10 hari ke depan. `15` - Mengembalikan data prakiraan selama 15 hari ke depan.
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		WeatherDataUnit	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 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	QuarterDayForecastResult	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 detailed weather forecast by a given location

Permintaan sampel

HTTP

GET https://atlas.microsoft.com/weather/forecast/quarterDay/json?api-version=1.1&query=47.632346,-122.138874&duration=1

Respon sampel

Kode status:: 200

{
  "forecasts": [
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T07:00:00-08:00",
      "quarter": 0,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Mostly cloudy with a shower in spots",
      "temperature": {
        "minimum": {
          "value": 6.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 11.1,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 7.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 11.2,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 7.5,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 90,
      "wind": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 192,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 2,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 55,
      "thunderstormProbability": 20,
      "totalLiquid": {
        "value": 0.6,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0.6,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T13:00:00-08:00",
      "quarter": 1,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Mostly cloudy with a shower in spots",
      "temperature": {
        "minimum": {
          "value": 11.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 13.7,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 11.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 14.7,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 8.4,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 76,
      "wind": {
        "direction": {
          "degrees": 296,
          "localizedDescription": "WNW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 96,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 50,
      "thunderstormProbability": 20,
      "totalLiquid": {
        "value": 0.3,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0.3,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T19:00:00-08:00",
      "quarter": 2,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "phrase": "Cloudy",
      "temperature": {
        "minimum": {
          "value": 9.8,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 10.4,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 8.5,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 9.8,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 7,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 81,
      "wind": {
        "direction": {
          "degrees": 172,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 174,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 10,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 93,
      "hasPrecipitation": false,
      "precipitationProbability": 25,
      "thunderstormProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-15T01:00:00-08:00",
      "quarter": 3,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Cloudy with a little rain",
      "temperature": {
        "minimum": {
          "value": 8.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 9.9,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 6.2,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 8.6,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 6.9,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 84,
      "wind": {
        "direction": {
          "degrees": 164,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 165,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 14.8,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 9,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 59,
      "thunderstormProbability": 0,
      "totalLiquid": {
        "value": 1.4,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 1.4,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    }
  ]
}

Definisi

Nama	Deskripsi
DayQuarter	Seperempat hari.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
IconCode	Nilai numerik yang mewakili gambar yang menampilkan `iconPhrase`. Silakan merujuk ke layanan Cuaca di Azure Maps untuk detailnya.
JsonFormat	Format respons yang diinginkan. Hanya `json` format yang didukung.
PrecipitationType	Menentukan jenis curah hujan ("Hujan" "Salju" "Es" atau "Campuran"). Jika dbz nol, precipitationType tidak ada dalam respons.
QuarterDayForecast
QuarterDayForecastResult
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.
WeatherDataUnit	Menentukan untuk mengembalikan data dalam unit metrik atau unit kekaisaran. Nilai default adalah metrik.
WeatherUnit	Nilai spesifik unit tertentu yang terkait dengan cuaca.
WeatherUnitRange	Nilai suhu yang dikembalikan.
WindDetails	Detail angin dikembalikan termasuk kecepatan dan arah.
WindDirection	Arah Angin

DayQuarter

Seperempat hari.

Nama	Jenis	Deskripsi
0	Integer
1	Integer
2	Integer
3	Integer

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.

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	Format Pertukaran Data Notasi Objek JavaScript

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

QuarterDayForecast

Nama	Jenis	Deskripsi
cloudCover	integer	Persen yang mewakili penutup cloud.
date	string	Tanggal prakiraan sebagai contoh, 2019-10-27T00:00:00
dewPoint	WeatherUnit	Suhu titik dew dalam unit yang ditentukan. Suhu titik dew adalah suhu udara harus didinginkan untuk mencapai kejenuhan.
effectiveDate	string	Tanggal dan waktu awal kuartal prakiraan ditampilkan dalam format ISO 8601, misalnya, 2019-10-27T19:39:57-08:00.
hasPrecipitation	boolean	Menunjukkan ada atau tidak adanya curah hujan. True menunjukkan adanya curah hujan, salah menunjukkan tidak adanya curah hujan.
ice	WeatherUnit	Es
iconCode	IconCode	Nilai numerik yang mewakili gambar yang menampilkan `iconPhrase`. Silakan merujuk ke layanan Cuaca di Azure Maps untuk detailnya.
iconPhrase	string	Deskripsi frasa ikon. Ditampilkan dalam bahasa yang ditentukan. Misalnya, 'Sunny'.
phrase	string	Ringkasan singkat ringkasan frasa untuk kuartal.
precipitationIntensity	string	Deskripsi intensitas.
precipitationProbability	integer	Persen yang mewakili probabilitas curah hujan. Misalnya, '20'.
precipitationType	PrecipitationType	Menentukan jenis curah hujan ("Hujan" "Salju" "Es" atau "Campuran"). Jika dbz nol, precipitationType tidak ada dalam respons.
quarter	DayQuarter	Seperempat hari.
rain	WeatherUnit	Hujan
realFeelTemperature	WeatherUnitRange	Nilai Suhu RealFeel™ untuk kuartal tersebut.
relativeHumidity	integer	Kelembaban relatif adalah jumlah uap air yang ada di udara yang dinyatakan sebagai persentase dari jumlah yang diperlukan untuk saturasi pada suhu yang sama.
snow	WeatherUnit	Salju
temperature	WeatherUnitRange	Nilai suhu untuk kuartal.
thunderstormProbability	integer	Persen mewakili probabilitas badai petir. Misalnya, '10'.
totalLiquid	WeatherUnit	Total cairan yang setara dengan curah hujan selama periode prakiraan.
visibility	WeatherUnit	Visibilitas dalam unit yang ditentukan. Ukuran jarak di mana objek atau cahaya dapat terlihat dengan jelas.
wind	WindDetails	Detail angin dikembalikan termasuk kecepatan dan arah.
windGust	WindDetails	Embusan angin. Embusan angin tiba-tiba, singkat peningkatan kecepatan angin.

QuarterDayForecastResult

Nama	Jenis	Deskripsi
forecasts	QuarterDayForecast[]	Prakiraan data untuk setiap kuartal dalam respons.

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 dalam unit metrik atau unit kekaisaran. Nilai default 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	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

Nilai suhu yang dikembalikan.

Nama	Jenis	Deskripsi
maximum	WeatherUnit	Suhu maksimum untuk periode waktu
minimum	WeatherUnit	Suhu minimum untuk periode waktu.

WindDetails

Detail angin dikembalikan termasuk kecepatan dan arah.

Nama	Jenis	Deskripsi
direction	WindDirection	Arah Angin
speed	WeatherUnit	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.

Bagikan melalui