Bagikan melalui

Weather - Get Daily Forecast

  • Referensi
Layanan:
Maps
Versi API:
1.1

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}
Dengan parameter opsional: 
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

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 harian dikembalikan. Nilai yang tersedia 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.
  • 25 - Mengembalikan data prakiraan selama 25 hari ke depan. Hanya tersedia di SKU S1.
  • 45 - Mengembalikan data prakiraan selama 45 hari ke depan. Hanya tersedia di SKU S1.
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

DailyForecastResult

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.

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 daily weather forecast for a given coordinate location

Permintaan sampel

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

Respon sampel

Kode status:
200 
{
  "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
AirAndPollen
DailyForecast
DailyForecastResult
DailyForecastSummary

Ringkasan untuk kondisi utama untuk periode waktu yang diminta. Perhatikan bahwa ringkasan hanya dapat mencakup bagian dari periode waktu.
DayOrNight
DegreeDaySummary
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.
LocalSource

Informasi penyedia data cuaca lokal.
PrecipitationType

Menentukan jenis curah hujan ("Hujan" "Salju" "Es" atau "Campuran"). Jika dbz nol, precipitationType tidak ada 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.
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

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 polutan. Misalnya, rumput, cetakan, 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 cetakan, rumput, gulma, dan pohon berada dalam satuan bagian per meter kubik. Kualitas udara dan UV adalah indeks, sehingga tidak bersatu.

DailyForecast

Nama Jenis Deskripsi
airAndPollen

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

DayOrNight

Detail prakiraan hari
degreeDaySummary

DegreeDaySummary

Ringkasan untuk suhu rata-rata informasi Hari Derajat Pemanasan atau Pendinginan Derajat Informasi
hoursOfSun

number

Berjam-jam berjemur.
night

DayOrNight

Detail prakiraan malam
realFeelTemperature

WeatherUnitRange

Suhu RealFeel™ dikembalikan.
realFeelTemperatureShade

WeatherUnitRange

Suhu RealFeel™ dikembalikan. Menjelaskan bagaimana suhu benar-benar terasa seperti di bayangan.
sources

string[]

Sumber data prakiraan.
temperature

WeatherUnitRange

Nilai suhu untuk hari itu.

DailyForecastResult

Nama Jenis Deskripsi
forecasts

DailyForecast[]

Prakiraan data untuk setiap hari yang diminta.
summary

DailyForecastSummary

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 yang 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

Berjam-jam salju.
ice

WeatherUnit

Es
iceProbability

integer

Persen mewakili probabilitas es. Misalnya, '30'.
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'.
localSource

LocalSource

Informasi penyedia data cuaca lokal.
longPhrase

string

Deskripsi frasa prakiraan dalam bahasa tertentu. Azure Maps mencoba mempertahankan panjang frasa ini di bawah 100 karakter, tetapi beberapa bahasa/peristiwa cuaca dapat mengakibatkan panjang frasa yang lebih panjang, melebihi 100 karakter.
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.
rain

WeatherUnit

Hujan
rainProbability

integer

Persen mewakili kemungkinan hujan. Misalnya, '40'.
shortPhrase

string

Deskripsi frasa prakiraan dalam bahasa tertentu. Azure Maps mencoba mempertahankan panjang frasa ini di bawah 30 karakter, tetapi beberapa bahasa/peristiwa cuaca dapat mengakibatkan panjang frasa yang lebih panjang, melebihi 30 karakter.
snow

WeatherUnit

Salju
snowProbability

integer

Persen mewakili probabilitas salju. Misalnya, '30'.
thunderstormProbability

integer

Persen mewakili probabilitas badai petir. Misalnya, '80'.
totalLiquid

WeatherUnit

Total cairan yang setara dengan curah hujan selama periode prakiraan.
wind

WindDetails

Detail angin dikembalikan termasuk kecepatan dan arah.
windGust

WindDetails

Embusan angin. Embusan angin tiba-tiba, singkat peningkatan kecepatan angin.

DegreeDaySummary

Nama Jenis Deskripsi
cooling

WeatherUnit

Jumlah derajat yang suhu rata-rata di atas 65 derajat F/ 18 derajat C.
heating

WeatherUnit

Jumlah derajat 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

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

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 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.