Weather - Get Current Conditions

Referensi

Service:: Maps

API Version:: 1.1

Gunakan untuk mendapatkan kondisi cuaca saat ini.

Get Current Conditions API adalah permintaan HTTP GET yang mengembalikan kondisi cuaca terperinci saat ini seperti curah hujan, suhu, dan angin untuk lokasi koordinat tertentu. Juga, pengamatan dari 6 atau 24 jam terakhir untuk lokasi tertentu dapat diambil. Informasi dasar yang dikembalikan dengan Respons mencakup detail seperti tanggal dan waktu pengamatan, deskripsi singkat tentang kondisi cuaca, ikon cuaca, bendera indikator curah hujan, dan suhu. Rincian tambahan seperti RealFeel™ Temperature dan indeks UV juga disampaikan. Untuk informasi selengkapnya, lihat Meminta data cuaca real time

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

With optional parameters:

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&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 dengan bujur misalnya " 47.641268,-122.125679".
details	query		string	Mengembalikan detail lengkap untuk kondisi saat ini. Nilai yang tersedia adalah `true` - Mengembalikan detail lengkap. Secara default semua detail dikembalikan. `false` - Mengembalikan versi terpotong dari data kondisi saat ini, yang mencakup waktu tanggal pengamatan, frasa cuaca, kode ikon, bendera indikator curah hujan, dan suhu.
duration	query		integer	Jangka waktu kondisi cuaca yang dikembalikan. Secara default, kondisi cuaca terbaru akan dikembalikan. Nilai defaultnya adalah 0. Nilai yang didukung adalah: `0` - Mengembalikan kondisi cuaca terbaru. `6` - Mengembalikan kondisi cuaca dari 6 jam terakhir. `24` - Mengembalikan kondisi cuaca dari 24 jam terakhir.
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.
unit	query		WeatherDataUnit	Menentukan untuk mengembalikan data di unit metrik atau unit kekaisaran. Nilai defaultnya 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	CurrentConditionsResult	OK
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 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 untuk Azure Maps REST API.

Untuk menerapkan skenario, sebaiknya lihat konsep autentikasi. Singkatnya, definisi keamanan ini menyediakan solusi untuk pemodelan 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 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 diterbitkan.

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 fine-grain ke kedaluwarsa, tarif, 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 spesifik asal yang diizinkan pada sumber daya akun Peta untuk membatasi penyalahgunaan penyalahgunaan dan memperbarui Token SAS secara teratur.

Type: apiKey
In: header

Contoh

Successfully retrieve detailed current weather conditions for a given coordinate location

Sample Request

HTTP

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Sample Response

Status code:: 200

{
  "results": [
    {
      "dateTime": "2019-11-14T15:08:00-08:00",
      "phrase": "Cloudy",
      "iconCode": 7,
      "hasPrecipitation": false,
      "isDayTime": true,
      "temperature": {
        "value": 13.7,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperatureShade": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 75,
      "dewPoint": {
        "value": 9.2,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "value": 3.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 4.9,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "obstructionsToVisibility": "",
      "cloudCover": 95,
      "ceiling": {
        "value": 4359,
        "unit": "m",
        "unitType": 5
      },
      "pressure": {
        "value": 1014.9,
        "unit": "mb",
        "unitType": 14
      },
      "pressureTendency": {
        "localizedDescription": "Steady",
        "code": "S"
      },
      "pastTwentyFourHourTemperatureDeparture": {
        "value": 1.8,
        "unit": "C",
        "unitType": 17
      },
      "apparentTemperature": {
        "value": 16.1,
        "unit": "C",
        "unitType": 17
      },
      "windChillTemperature": {
        "value": 13.9,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 11.4,
        "unit": "C",
        "unitType": 17
      },
      "precipitationSummary": {
        "pastHour": {
          "value": 0.5,
          "unit": "mm",
          "unitType": 3
        },
        "pastThreeHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastSixHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastNineHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwelveHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastEighteenHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwentyFourHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        }
      },
      "temperatureSummary": {
        "pastSixHours": {
          "minimum": {
            "value": 8.3,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwelveHours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwentyFourHours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        }
      }
    }
  ]
}

Definisi

Nama	Deskripsi
CurrentConditions
CurrentConditionsResult
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.
PastHoursTemperature	Ringkasan fluktuasi suhu selama jumlah jam terakhir.
PrecipitationSummary
PressureTendency
TemperatureSummary
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.
WindDetails	Detail angin dikembalikan termasuk kecepatan dan arah.
WindDirection	Arah Angin

CurrentConditions

Nama	Jenis	Deskripsi
apparentTemperature	WeatherUnit	Suhu luar ruangan yang dirasakan disebabkan oleh kombinasi suhu udara, kelembaban relatif, dan kecepatan angin dalam unit yang ditentukan.
ceiling	WeatherUnit	Langit-langit cloud dalam unit tertentu. Langit-langit adalah pengukuran ketinggian dasar awan terendah.
cloudCover	integer	Persen yang mewakili penutup cloud.
dateTime	string	Tanggal dan waktu pengamatan saat ini ditampilkan dalam format ISO 8601, misalnya, 2019-10-27T19:39:57-08:00.
dewPoint	WeatherUnit	Suhu titik dew dalam unit yang ditentukan. Suhu titik dew adalah suhu udara harus didinginkan untuk mencapai kejenuhan.
hasPrecipitation	boolean	Menunjukkan ada atau tidak adanya curah hujan. True menunjukkan adanya curah hujan, salah menunjukkan tidak adanya curah hujan.
iconCode	IconCode	Nilai numerik yang mewakili gambar yang menampilkan `iconPhrase`. Silakan merujuk ke layanan Cuaca di Azure Maps untuk detailnya.
isDayTime	boolean	Menunjukkan waktu dalam sehari. True menunjukkan 'day',', false menunjukkan 'malam.
obstructionsToVisibility	string	Penyebab visibilitas terbatas. Nilai yang memungkinkan: A = badai petir/hujan es berat BD = debu bertiup BN = pasir bertiup BS = salju bertiup D = debu F = kabut GF = kabut tanah HZ = kabut I = es IC = kristal es IF = ice fog IP = butiran es IPW = hujan butiran es K = asap L = gerimis R = hujan RS = hujan/salju RW = hujan S = salju SG = butiran salju SP = pelet salju SW = hujan salju T = badai petir UP = curah hujan tidak terdefinisi ZL = gerimis membeku ZR = hujan membeku + = berat - = cahaya
pastTwentyFourHourTemperatureDeparture	WeatherUnit	Keberangkatan dari suhu yang diamati 24 jam yang lalu dalam unit yang ditentukan.
phrase	string	Deskripsi frasa tentang kondisi cuaca saat ini. Ditampilkan dalam bahasa yang ditentukan.
precipitationSummary	PrecipitationSummary	Ringkasan jumlah curah hujan selama 24 jam terakhir.
pressure	WeatherUnit	Tekanan atmosfer dalam unit tertentu.
pressureTendency	PressureTendency	Perubahan tekanan atmosfer.
realFeelTemperature	WeatherUnit	Suhu RealFeel™ dikembalikan.
realFeelTemperatureShade	WeatherUnit	Suhu RealFeel™ dikembalikan. Menjelaskan bagaimana suhu benar-benar terasa seperti di bayangan.
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.
temperature	WeatherUnit	Suhu dikembalikan.
temperatureSummary	TemperatureSummary	Ringkasan fluktuasi suhu selama 6, 12, dan 24 jam terakhir.
uvIndex	integer	Ukuran kekuatan radiasi ultraviolet dari matahari. Nilai yang didukung adalah: `0-2` - Bahaya rendah dari sinar UV matahari atau orang rata-rata. `3-5` - Risiko bahaya sedang dari paparan matahari yang tidak terlindungi. `6-7` - Risiko bahaya tinggi dari paparan matahari yang tidak terlindungi. `8-10` - Risiko bahaya yang sangat tinggi dari paparan matahari yang tidak terlindungi. `11+` - Risiko ekstrim bahaya dari paparan matahari yang tidak terlindungi.
uvIndexPhrase	string	Frasa yang terkait dengan `uvIndex`.
visibility	WeatherUnit	Visibilitas dalam unit yang ditentukan. Ukuran jarak di mana objek atau cahaya dapat terlihat dengan jelas.
wetBulbTemperature	WeatherUnit	Suhu udara yang dapat didinginkan dengan menguapkan air ke dalamnya pada tekanan konstan sampai mencapai saturasi.
wind	WindDetails	Detail angin dikembalikan termasuk kecepatan dan arah.
windChillTemperature	WeatherUnit	Dirasakan suhu udara pada kulit yang terbuka karena angin.
windGust	WindDetails	Embusan angin. Embusan angin tiba-tiba, singkat peningkatan kecepatan angin.

CurrentConditionsResult

Nama	Jenis	Deskripsi
results	CurrentConditions[]	Detail kondisi cuaca saat ini.

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

PastHoursTemperature

Ringkasan fluktuasi suhu selama jumlah jam terakhir.

Nama	Jenis	Deskripsi
maximum	WeatherUnit	maksimum
minimum	WeatherUnit	minimum

PrecipitationSummary

Nama	Jenis	Deskripsi
pastEighteenHours	WeatherUnit	Jumlah curah hujan (setara cair) yang telah turun dalam 18 jam terakhir.
pastHour	WeatherUnit	Jumlah curah hujan (setara cair) yang turun dalam satu jam terakhir.
pastNineHours	WeatherUnit	Jumlah curah hujan (setara cairan) yang telah turun dalam sembilan jam terakhir.
pastSixHours	WeatherUnit	Jumlah curah hujan (setara cairan) yang telah turun dalam enam jam terakhir. Berisi Nilai Metrik dan Imperial.
pastThreeHours	WeatherUnit	Jumlah curah hujan (setara cairan) yang turun dalam tiga jam terakhir.
pastTwelveHours	WeatherUnit	Jumlah curah hujan (setara cair) yang telah turun dalam 12 jam terakhir.
pastTwentyFourHours	WeatherUnit	Jumlah curah hujan (setara cairan) yang telah turun dalam 24 jam terakhir.

PressureTendency

Nama	Jenis	Deskripsi
code	string	Kode kecenderungan tekanan terlepas dari bahasa. Salah satu dari F=Falling, S=Steady, R=Rising.
localizedDescription	string	Deskripsi kecenderungan tekanan dalam bahasa tertentu

TemperatureSummary

Nama	Jenis	Deskripsi
pastSixHours	PastHoursTemperature	Ringkasan fluktuasi suhu selama 6 jam terakhir.
pastTwelveHours	PastHoursTemperature	Ringkasan fluktuasi suhu selama 12 jam terakhir.
pastTwentyFourHours	PastHoursTemperature	Ringkasan fluktuasi suhu selama 24 jam terakhir.

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.

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 ke arah searah jajar. 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