Weather - Get Tropical Storm Forecast
Ulusal hava tahmin ajansları tarafından tahmin edilen tropik fırtınaların bir listesini almak için kullanın.
API Get Tropical Storm Forecasts
, devlet tarafından verilen bireysel tropik fırtına tahminlerini döndüren bir HTTP GET
isteğidir. Tahmin edilen tropik fırtınalarla ilgili bilgiler, konum, durum, tahminin oluşturulduğu tarih, pencere, rüzgar hızı ve rüzgar yarıçaplarını içerir.
GET https://atlas.microsoft.com/weather/tropical/storms/forecasts/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}
GET https://atlas.microsoft.com/weather/tropical/storms/forecasts/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}&unit={unit}&details={details}&radiiGeometry={radiiGeometry}&windowGeometry={windowGeometry}
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
format
|
path | True |
Yanıtın istenen biçimi. Yalnızca |
|
api-version
|
query | True |
string |
Azure Haritalar API'sinin sürüm numarası. |
basin
|
query | True |
Havza tanımlayıcısı |
|
gov
|
query | True |
integer (int32) |
Hükümet fırtına kimliği |
year
|
query | True |
integer (int32) |
Kasırga(lar)ın yılı |
details
|
query |
boolean |
Doğru olduğunda, rüzgar yarıçapı özet verileri yanıta dahil edilir |
|
radii
|
query |
boolean |
Doğru olduğunda, rüzgar yarıçapı özet verileri ve geoJSON ayrıntıları yanıta dahil edilir |
|
unit
|
query |
Verilerin metrik birimler veya İngiliz ölçü birimleri cinsinden döndürüleceğini belirtir. Varsayılan değer metriktir. |
||
window
|
query |
boolean |
Doğru olduğunda, pencere geometrisi verileri (geoJSON) yanıta dahil edilir |
İstek Başlığı
Name | Gerekli | Tür | Description |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra Id güvenlik modeliyle birlikte hangi hesabın kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'da Microsoft Entra ID güvenliğini kullanmak için rehberlik için aşağıdaki |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam |
|
Other Status Codes |
Beklenmeyen bir hata oluştu. |
Güvenlik
AADToken
Bunlar Microsoft Entra OAuth 2.0 Akışlarının
Senaryoları uygulamak için
Notlar
- Bu güvenlik tanımı kullanılmasını gerektirir. Bu, Haritalar yönetimi API'sinden edinilebilir.
Authorization URL
, Azure genel bulut örneğine özgüdür. Bağımsız bulutların benzersiz Yetkilendirme URL'leri ve Microsoft Entra Id yapılandırmaları vardır.
* Azure rol tabanlı erişim denetimi Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla azure yönetim düzlemi yapılandırılır.
* Azure Haritalar Web SDK kullanımı, bir uygulamanın birden çok kullanım örneği için yapılandırma tabanlı kurulumuna olanak tanır.
- Microsoft kimlik platformu hakkında daha fazla bilgi için bkz. Microsoft kimlik platformuna genel bakış.
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Bu, Azure portalında Azure Haritalar hesabı oluşturma veya PowerShell, CLI, Azure SDK'ları veya REST API kullanarak sağlanan paylaşılan bir anahtardır.
Bu anahtarla, tüm uygulamalar tüm REST API'lere erişebilir. Başka bir deyişle, bu anahtar, verildikleri hesapta ana anahtar olarak kullanılabilir.
Herkese açık uygulamalar için, anahtarınızın güvenli bir şekilde depolanabilmesi için Azure Haritalar REST API'lerine erişmek için gizli istemci uygulamaları yaklaşımını kullanmanızı öneririz.
Tür:
apiKey
İçinde:
query
SAS Token
Bu paylaşılan erişim imzası belirteci, Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzlemi aracılığıyla Azure Haritalar kaynağı Sas Listeleme işleminden oluşturulur.
Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirteç için kullanım süre sonu, oran ve bölgelere ayrıntılı denetim ile erişim yetkisine sahiptir. Başka bir deyişle SAS Belirteci, uygulamaların erişimi paylaşılan anahtardan daha güvenli bir şekilde denetlemesine izin vermek için kullanılabilir.
Herkese açık uygulamalar için önerimiz, Eşleme hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmayı işleme kötüye kullanımını sınırlamak ve SAS Belirtecini düzenli olarak yenilemektir.
Tür:
apiKey
İçinde:
header
Örnekler
Get Tropical Storm Forecasts
Örnek isteği
GET https://atlas.microsoft.com/weather/tropical/storms/forecasts/json?api-version=1.1&year=2021&basinId=NP&govId=2
Örnek yanıt
{
"results": [
{
"dateTime": "2021-04-25T06:00:00+00:00",
"initializedDateTime": "2021-04-24T18:00:00+00:00",
"location": {
"latitude": 22,
"longitude": 137.8
},
"maxWindGust": {
"value": 92.6,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 74.1,
"unit": "km/h",
"unitType": 7
},
"status": "Tropical Storm",
"window": {
"left": {
"latitude": 22.56387,
"longitude": 137.739517
},
"right": {
"latitude": 21.4361,
"longitude": 137.860489
}
}
},
{
"dateTime": "2021-04-25T18:00:00+00:00",
"initializedDateTime": "2021-04-24T18:00:00+00:00",
"location": {
"latitude": 23.7,
"longitude": 142.4
},
"maxWindGust": {
"value": 92.6,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 74.1,
"unit": "km/h",
"unitType": 7
},
"status": "Tropical Storm",
"window": {
"left": {
"latitude": 24.45283,
"longitude": 142.055313
},
"right": {
"latitude": 22.94641,
"longitude": 142.744675
}
}
}
]
}
Tanımlar
Name | Description |
---|---|
basin |
Havza tanımlayıcısı |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Json |
Yanıtın istenen biçimi. Yalnızca |
Lat |
Enlem ve boylam olarak temsil edilen konum. |
Radius |
Rulman 0–90 = NE kadranı; 90–180 = SE kadranı; 180–270 = SW kadranı; 270–360 = KB kadran. |
Storm |
Hükümet tarafından verilen fırtına tahmini |
Storm |
Devlet tarafından yayınlanan tahminlerin listesi |
Storm |
İstekte details=true veya radiiGeometry=true olduğunda görüntülenir. |
Unit |
Görüntülenen birim türüyle ilişkili sayısal kimlik değeri. Birim çevirisi için kullanılabilir. Ayrıntılar için lütfen Azure Haritalar'daki Hava Durumu hizmetlerine bakın. |
Weather |
Verilerin metrik birimler veya İngiliz ölçü birimleri cinsinden döndürüleceğini belirtir. Varsayılan değer metriktir. |
Weather |
Hava durumu ile ilgili belirli bir birimin belirli değeri. |
Weather |
Fırtına için tahmin penceresi |
basinId
Havza tanımlayıcısı
Değer | Description |
---|---|
AL |
Atlantik |
CP |
Orta Pasifik |
EP |
Doğu Pasifik |
NI |
Kuzey Hint Okyanusu |
NP |
Kuzeybatı Pasifik |
SI |
Güneybatı Hint Okyanusu |
SP |
Güney Pasifik |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
GeoJsonGeometry
Geçerli bir GeoJSON
geometri nesnesi. Tür yedi geçerli GeoJSON geometri türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon ve GeometryCollection. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
type |
Geo |
|
GeoJsonGeometryCollection
Geçerli bir GeoJSON GeometryCollection
nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
geometries | GeoJsonGeometry[]: |
Geçerli |
type |
string:
Geometry |
|
GeoJsonLineString
Geçerli bir GeoJSON LineString
geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] (double) |
|
type |
string:
Line |
|
GeoJsonMultiLineString
Geçerli bir GeoJSON MultiLineString
geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] (double) |
|
type |
string:
Multi |
|
GeoJsonMultiPoint
Geçerli bir GeoJSON MultiPoint
geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] (double) |
|
type |
string:
Multi |
|
GeoJsonMultiPolygon
Geçerli bir GeoJSON MultiPolygon
nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] (double) |
Geçerli |
type |
string:
Multi |
|
GeoJsonPoint
Geçerli bir GeoJSON Point
geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] (double) |
|
type |
string:
Point |
|
GeoJsonPolygon
Geçerli bir GeoJSON Polygon
geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] (double) |
|
type |
string:
Polygon |
|
JsonFormat
Yanıtın istenen biçimi. Yalnızca json
biçimi desteklenir.
Değer | Description |
---|---|
json |
LatLongPair
Enlem ve boylam olarak temsil edilen konum.
Name | Tür | Description |
---|---|---|
latitude |
number (double) |
Latitude özelliği |
longitude |
number (double) |
Longitude özelliği |
RadiusSector
Rulman 0–90 = NE kadranı; 90–180 = SE kadranı; 180–270 = SW kadranı; 270–360 = KB kadran.
Name | Tür | Description |
---|---|---|
beginBearing |
number (double) |
Kadranın başlangıcının derece cinsinden taşınması. |
endBearing |
number (double) |
Kadranın sonunun derece cinsinden yönü. |
range |
number (double) |
Kadranın yarıçapı, deniz mili cinsinden. |
StormForecast
Hükümet tarafından verilen fırtına tahmini
Name | Tür | Description |
---|---|---|
dateTime |
string |
Tahminin geçerli olduğu tarihsaat ISO8601 biçiminde görüntülenir. |
initializedDateTime |
string |
Tahminin oluşturulduğu tarih, ISO8601 biçiminde görüntülenir. |
location |
Fırtınanın koordinatları |
|
maxWindGust |
Fırtına ile ilişkili maksimum rüzgar hızı hızı. NULL olabilir. |
|
status |
string |
Olası durum değerleri şunlardır:
|
sustainedWind |
Fırtına ile ilişkili maksimum sürekli rüzgar hızı. NULL olabilir. |
|
windRadiiSummary |
İstekte details=true veya radiiGeometry=true olduğunda görüntülenir. |
|
window |
Belirtilen süre boyunca fırtına için tahmin penceresi hakkında bilgi içerir (koninin tamamı değil). İstekte windowGeometry=true ise, bu nesne pencere geometrisi için geoJSON ayrıntılarını içerir. |
StormForecastResult
Devlet tarafından yayınlanan tahminlerin listesi
Name | Tür | Description |
---|---|---|
nextLink |
string |
, döndürülen özelliklerin sonraki sayfasının bağlantısıdır. Bu son sayfaysa, bu alan yok. |
results |
Devlet tarafından yayınlanan tahminlerin listesi |
StormWindRadiiSummary
İstekte details=true veya radiiGeometry=true olduğunda görüntülenir.
Name | Tür | Description |
---|---|---|
dateTime |
string |
Rüzgar yarıçapı özet verilerinin geçerli olduğu DateTime, ISO8601 biçiminde görüntülenir. |
radiiGeometry | GeoJsonGeometry: |
GeoJSON nesnesi. İstekte radiiGeometry=true olduğunda görüntülenir. Rüzgar yarıçapı kadranlarının ana hatlarını açıklar. |
radiusSectorData |
Rüzgar yarıçapı kadranlarını çizmek için gereken bilgileri içerir. Rulman 0–90 = NE kadranı; 90–180 = SE kadranı; 180–270 = SW kadranı; 270–360 = KB kadran. |
|
windSpeed |
radiusSectorData ile ilişkili rüzgar hızı. |
UnitType
Görüntülenen birim türüyle ilişkili sayısal kimlik değeri. Birim çevirisi için kullanılabilir. Ayrıntılar için lütfen Azure Haritalar'daki Hava Durumu hizmetlerine bakın.
Değer | Description |
---|---|
0 |
ayaklar |
1 |
Inç |
10 |
metrePersaniye |
11 |
hektoPaskallar |
12 |
İnçOfMercury |
13 |
kiloPaskal |
14 |
Milibar |
15 |
milimetresOfMercury |
16 |
poundPerSquareInch |
17 |
Santigrat |
18 |
fahrenhayt |
19 |
kelvin |
2 |
Km |
20 |
yüzde |
21 |
yüzmek |
22 |
tamsayı |
3 |
milimetre |
31 |
MikrogramPerCubicMeterOfAir |
4 |
santimetre |
5 |
metre |
6 |
kilometre |
7 |
kilometresPerHour |
8 |
Knot |
9 |
mil/Saat |
WeatherDataUnit
Verilerin metrik birimler veya İngiliz ölçü birimleri cinsinden döndürüleceğini belirtir. Varsayılan değer metriktir.
Değer | Description |
---|---|
imperial |
Verileri İngiliz ölçü birimlerinde döndürün. Emperyal sistemin bazı örnek birimleri Fahrenheit ve mil'dir. |
metric |
Verileri metrik birimler halinde döndürün. Bazı örnek metrik sistem birimleri Santigrat ve kilometredir. |
WeatherUnit
Hava durumu ile ilgili belirli bir birimin belirli değeri.
Name | Tür | Description |
---|---|---|
unit |
string |
Döndürülen değer için birim türü. |
unitType |
Unit |
Görüntülenen birim türüyle ilişkili sayısal kimlik değeri. Birim çevirisi için kullanılabilir. Ayrıntılar için lütfen Azure Haritalar'daki Hava Durumu hizmetlerine bakın. |
value |
number (float) |
Yuvarlanmış değer. |
WeatherWindow
Fırtına için tahmin penceresi
Name | Tür | Description |
---|---|---|
beginDateTime |
string (date-time) |
Hareket penceresinin başlangıcının DateTime'ı, ISO8601 biçiminde görüntülenir. |
beginStatus |
string |
Pencerenin başındaki fırtına durumu. |
endDateTime |
string (date-time) |
Hareket penceresinin sonunun DateTime'ı, ISO8601 biçiminde görüntülenir. |
endStatus |
string |
Pencerenin sonundaki fırtına durumu. |
geometry | GeoJsonGeometry: |
İstekte windowGeometry=true olduğunda görüntülenir. Belirtilen zaman dilimi boyunca hareket penceresini tanımlayan koordinatları içeren GeoJSON nesnesi. |
left |
Zaman dilimi sırasında pencerenin sol tarafında bulunan noktanın konumu. |
|
right |
Zaman diliminin sonunda pencerenin sağ tarafında bulunan noktanın konumu. |