Aracılığıyla paylaş


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

JsonFormat

Yanıtın istenen biçimi. Yalnızca json biçimi desteklenir.

api-version
query True

string

Azure Haritalar API'sinin sürüm numarası.

basinId
query True

basinId

Havza tanımlayıcısı

govId
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

radiiGeometry
query

boolean

Doğru olduğunda, rüzgar yarıçapı özet verileri ve geoJSON ayrıntıları yanıta dahil edilir

unit
query

WeatherDataUnit

Verilerin metrik birimler veya İngiliz ölçü birimleri cinsinden döndürüleceğini belirtir. Varsayılan değer metriktir.

windowGeometry
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 makalelerine bakın.

Yanıtlar

Name Tür Description
200 OK

StormForecastResult

Tamam

Other Status Codes

ErrorResponse

Beklenmeyen bir hata oluştu.

Güvenlik

AADToken

Bunlar Microsoft Entra OAuth 2.0 Akışlarının . Azure rol tabanlı erişim denetimiyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi denetlemek için kullanılabilir. Azure rol tabanlı erişim denetimleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağına erişim belirtmek için kullanılır. Tüm kullanıcılara, gruplara veya hizmet sorumlularına yerleşik bir rol veya Azure Haritalar REST API'leri için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.

Senaryoları uygulamak içinkimlik doğrulama kavramlarını görüntülemenizi öneririz. Özetle, bu güvenlik tanımı belirli API'ler ve kapsamlar üzerinde erişim denetimi yapabilen nesneler aracılığıyla uygulamaları modellemek için bir çözüm sağlar.

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.

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
basinId

Havza tanımlayıcısı

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

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.

GeoJsonGeometryCollection

Geçerli bir GeoJSON GeometryCollection nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.

GeoJsonLineString

Geçerli bir GeoJSON LineString geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.

GeoJsonMultiLineString

Geçerli bir GeoJSON MultiLineString geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.

GeoJsonMultiPoint

Geçerli bir GeoJSON MultiPoint geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.

GeoJsonMultiPolygon

Geçerli bir GeoJSON MultiPolygon nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.

GeoJsonPoint

Geçerli bir GeoJSON Point geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.

GeoJsonPolygon

Geçerli bir GeoJSON Polygon geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.

JsonFormat

Yanıtın istenen biçimi. Yalnızca json biçimi desteklenir.

LatLongPair

Enlem ve boylam olarak temsil edilen konum.

RadiusSector

Rulman 0–90 = NE kadranı; 90–180 = SE kadranı; 180–270 = SW kadranı; 270–360 = KB kadran.

StormForecast

Hükümet tarafından verilen fırtına tahmini

StormForecastResult

Devlet tarafından yayınlanan tahminlerin listesi

StormWindRadiiSummary

İstekte details=true veya radiiGeometry=true olduğunda görüntülenir.

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.

WeatherDataUnit

Verilerin metrik birimler veya İngiliz ölçü birimleri cinsinden döndürüleceğini belirtir. Varsayılan değer metriktir.

WeatherUnit

Hava durumu ile ilgili belirli bir birimin belirli değeri.

WeatherWindow

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

ErrorAdditionalInfo[]

Hata ek bilgileri.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

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

GeoJsonObjectType

GeoJSON türünü belirtir. Dokuz geçerli GeoJSON nesne türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature ve FeatureCollection.

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 GeoJSON geometri nesnelerinin listesini içerir. GeoJSON'daki koordinatların x, y sırada (boylam, enlem) olduğunu.

type string:

GeometryCollection

GeoJSON türünü belirtir. Dokuz geçerli GeoJSON nesne türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature ve FeatureCollection.

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)

GeoJson LineString geometrisinin koordinatları.

type string:

LineString

GeoJSON türünü belirtir. Dokuz geçerli GeoJSON nesne türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature ve FeatureCollection.

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)

GeoJson MultiLineString geometrisinin koordinatları.

type string:

MultiLineString

GeoJSON türünü belirtir. Dokuz geçerli GeoJSON nesne türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature ve FeatureCollection.

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)

GeoJson MultiPoint geometrisinin koordinatları.

type string:

MultiPoint

GeoJSON türünü belirtir. Dokuz geçerli GeoJSON nesne türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature ve FeatureCollection.

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 GeoJSON Polygon nesnelerinin listesini içerir. GeoJSON'daki koordinatların x, y sırada (boylam, enlem) olduğunu.

type string:

MultiPolygon

GeoJSON türünü belirtir. Dokuz geçerli GeoJSON nesne türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature ve FeatureCollection.

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)

Position, iki veya daha fazla öğe içeren bir sayı dizisidir. İlk iki öğe boylam ve enlemtam olarak bu sıradadır. Yükseklik/Yükseltme isteğe bağlı bir üçüncü öğedir. Ayrıntılar için lütfen RFC 7946 bakın.

type string:

Point

GeoJSON türünü belirtir. Dokuz geçerli GeoJSON nesne türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature ve FeatureCollection.

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)

GeoJson Polygon geometri türü için koordinatlar.

type string:

Polygon

GeoJSON türünü belirtir. Dokuz geçerli GeoJSON nesne türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature ve FeatureCollection.

JsonFormat

Yanıtın istenen biçimi. Yalnızca json biçimi desteklenir.

Değer Description
json

JavaScript Nesne Gösterimi Veri Değişim Biçimi

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

LatLongPair

Fırtınanın koordinatları

maxWindGust

WeatherUnit

Fırtına ile ilişkili maksimum rüzgar hızı hızı. NULL olabilir.

status

string

Olası durum değerleri şunlardır:

  • Siklonik fırtına
  • Derin depresyon
  • Depresyon
  • Son derece şiddetli siklonik fırtına
  • Kasırga kategorisi (1-5)
  • Yoğun tropikal siklon
  • Orta derecede tropikal fırtına
  • Post-tropikal siklon
  • Potansiyel tropikal siklon
  • Şiddetli siklonik fırtına
  • Şiddetli tropik fırtına
  • Subtropikal
  • Süper siklonik fırtına
  • Tropikal siklon
  • Tropikal siklon kategorisi (1-5)
  • Tropikal depresyon
  • Tropikal rahatsızlık
  • Tropikal fırtına
  • Tayfun
  • Çok yoğun tropikal siklon
  • Çok şiddetli siklonik fırtına
  • Çok güçlü tayfun
  • Şiddetli tayfun

sustainedWind

WeatherUnit

Fırtına ile ilişkili maksimum sürekli rüzgar hızı. NULL olabilir.

windRadiiSummary

StormWindRadiiSummary[]

İstekte details=true veya radiiGeometry=true olduğunda görüntülenir.

window

WeatherWindow

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

StormForecast[]

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

RadiusSector[]

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

WeatherUnit

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

UnitType (int32)

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

LatLongPair

Zaman dilimi sırasında pencerenin sol tarafında bulunan noktanın konumu.

right

LatLongPair

Zaman diliminin sonunda pencerenin sağ tarafında bulunan noktanın konumu.