Weather - Get Tropical Storm Locations
個々の国家天気予報機関から熱帯暴風雨の場所を取得するために使用します。
Get Tropical Storm Locations
API は、政府が発行した個々の熱帯暴風雨の場所を返す HTTP GET
要求です。 熱帯暴風雨に関する情報には、位置座標、ジオメトリ、流域 ID、日付、風の詳細、風半径が含まれます。
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}&details={details}&radiiGeometry={radiiGeometry}&unit={unit}¤t={current}
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
format
|
path | True |
応答の目的の形式。 サポートされているのは |
|
api-version
|
query | True |
string |
Azure Maps API のバージョン番号。 |
basin
|
query | True |
ベイスン識別子 |
|
gov
|
query | True |
integer int32 |
Government storm Id |
year
|
query | True |
integer int32 |
サイクロンの年 |
current
|
query |
boolean |
true の場合は、現在の嵐の場所を返します |
|
details
|
query |
boolean |
true の場合、風半径の概要データが応答に含まれます |
|
radii
|
query |
boolean |
true の場合、風半径の概要データと geoJSON の詳細が応答に含まれます |
|
unit
|
query |
メトリック単位またはインペリアル単位のいずれかでデータを返すように指定します。 既定値はメトリックです。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID セキュリティ モデルと組み合わせて使用するアカウントを指定します。 これは Azure Maps アカウントの一意の ID を表し、Azure Maps 管理プレーン アカウント API から取得できます。 Azure Maps で Microsoft Entra ID セキュリティを使用するには、ガイダンスについては、次 の記事を 参照してください。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
予期しないエラーが発生しました。 |
セキュリティ
AADToken
これらは Microsoft Entra OAuth 2.0 フローです。 Azure ロールベースのアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上の Azure Maps リソース アカウントまたはサブリソースへのアクセスを指定するために使用されます。 Azure Maps REST API に対する 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、任意のユーザー、グループ、またはサービス プリンシパルにアクセス権を付与できます。
シナリオを実装するには、 認証の概念を表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。
メモ
- このセキュリティ定義 では 、 ヘッダーを
x-ms-client-id
使用して、アプリケーションがアクセスを要求している Azure Maps リソースを示す必要があります。 これは、 Maps 管理 API から取得できます。
Authorization URL
は、Azure パブリック クラウド インスタンスに固有です。 ソブリン クラウドには、一意の承認 URL と Microsoft Entra ID 構成があります。
* Azure ロールベースのアクセス制御は、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーン から構成されます。
* Azure Maps Web SDK を使用すると、複数のユース ケースに対するアプリケーションの構成ベースのセットアップが可能になります。
- Microsoft ID プラットフォームの詳細については、「 Microsoft ID プラットフォームの概要」を参照してください。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
これは、Azure portal で Azure Maps アカウントを作成 するとき、または PowerShell、CLI、Azure SDK、または REST API を使用するときにプロビジョニングされる共有キーです。
このキーを使用すると、すべてのアプリケーションがすべての REST API にアクセスできます。 つまり、このキーは、発行されたアカウントのマスター キーとして使用できます。
公開されているアプリケーションの場合、キーを安全に格納できるように 、機密クライアント アプリケーション のアプローチを使用して Azure Maps REST API にアクセスすることをお勧めします。
型:
apiKey
/:
query
SAS Token
これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を使用して、Azure 管理プレーンを介して Azure Maps リソース の SAS の一覧表示操作から作成される共有アクセス署名トークンです。
このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンをきめ細かく制御できます。 つまり、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できるようにします。
公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定の一覧を構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。
型:
apiKey
/:
header
例
Get Tropical Storm Current Location |
Get Tropical Storm Locations |
Get Tropical Storm Current Location
要求のサンプル
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year=2021&basinId=NP&govId=2¤t=True
応答のサンプル
{
"results": [
{
"dateTime": "2021-04-24T18:00:00+00:00",
"location": {
"latitude": 21.7,
"longitude": 134.1
},
"maxWindGust": {
"value": 92.6,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 74.1,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 115,
"localizedDescription": "ESE"
},
"speed": {
"value": 22.2,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
}
]
}
Get Tropical Storm Locations
要求のサンプル
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year=2021&basinId=NP&govId=1
応答のサンプル
{
"results": [
{
"dateTime": "2021-02-22T00:00:00+00:00",
"location": {
"latitude": 10.4,
"longitude": 125.7
},
"maxWindGust": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 46.3,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 305,
"localizedDescription": "NW"
},
"speed": {
"value": 9.3,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Depression"
},
{
"dateTime": "2021-02-21T18:00:00+00:00",
"location": {
"latitude": 10.2,
"longitude": 125.9
},
"maxWindGust": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 46.3,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 300,
"localizedDescription": "WNW"
},
"speed": {
"value": 22.2,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Depression"
},
{
"dateTime": "2021-02-21T12:00:00+00:00",
"location": {
"latitude": 10.3,
"longitude": 125.8
},
"maxWindGust": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 300,
"localizedDescription": "WNW"
},
"speed": {
"value": 42.6,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-19T06:00:00+00:00",
"location": {
"latitude": 7.2,
"longitude": 129.8
},
"maxWindGust": {
"value": 101.9,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 270,
"localizedDescription": "W"
},
"speed": {
"value": 18.5,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-19T00:00:00+00:00",
"location": {
"latitude": 7.2,
"longitude": 131.2
},
"maxWindGust": {
"value": 101.9,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 270,
"localizedDescription": "W"
},
"speed": {
"value": 7.4,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-18T18:00:00+00:00",
"location": {
"latitude": 7.2,
"longitude": 131.7
},
"maxWindGust": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 270,
"localizedDescription": "W"
},
"speed": {
"value": 3.7,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-18T12:00:00+00:00",
"location": {
"latitude": 7.3,
"longitude": 131.8
},
"maxWindGust": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 270,
"localizedDescription": "W"
},
"speed": {
"value": 5.6,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-18T06:00:00+00:00",
"location": {
"latitude": 7.3,
"longitude": 132.1
},
"maxWindGust": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 305,
"localizedDescription": "NW"
},
"speed": {
"value": 9.3,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-18T00:00:00+00:00",
"location": {
"latitude": 7,
"longitude": 132.6
},
"maxWindGust": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 290,
"localizedDescription": "WNW"
},
"speed": {
"value": 5.6,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-17T18:00:00+00:00",
"location": {
"latitude": 7,
"longitude": 132.7
},
"maxWindGust": {
"value": 74.1,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 55.6,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 290,
"localizedDescription": "WNW"
},
"speed": {
"value": 9.3,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Depression"
},
{
"dateTime": "2021-02-17T12:00:00+00:00",
"location": {
"latitude": 6.8,
"longitude": 132.4
},
"maxWindGust": {
"value": 74.1,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 55.6,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 285,
"localizedDescription": "WNW"
},
"speed": {
"value": 13,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Depression"
},
{
"dateTime": "2021-02-17T06:00:00+00:00",
"location": {
"latitude": 6.6,
"longitude": 133.1
},
"maxWindGust": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 46.3,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 270,
"localizedDescription": "W"
},
"speed": {
"value": 22.2,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Depression"
}
]
}
定義
名前 | 説明 |
---|---|
basin |
ベイスン識別子 |
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Geo |
有効な |
Geo |
有効な |
Geo |
有効な |
Geo |
有効な |
Geo |
有効な |
Geo |
有効な |
Geo |
有効な |
Geo |
有効な |
Json |
応答の目的の形式。 サポートされているのは |
Lat |
緯度と経度として表される場所。 |
Radius |
ベアリング 0 – 90 = NE クアドラント;90 から 180 = SE 象限。180 –270 = SW 象限;270 から 360 = NW 象限。 |
Storm |
政府が発行した個々の嵐の場所 |
Storm |
政府が発行した個々の嵐の場所 |
Storm |
要求で details=true または radiiGeometry=true の場合に表示されます。 |
Unit |
表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。 |
Weather |
メトリック単位または帝国単位のいずれかでデータを返すように指定します。 既定値はメトリックです。 |
Weather |
気象に関連する特定の単位の特定の値。 |
Wind |
速度と方向を含む風の詳細が返されます。 |
Wind |
風向 |
basinId
ベイスン識別子
名前 | 型 | 説明 |
---|---|---|
AL |
string |
大西洋 |
CP |
string |
中部太平洋 |
EP |
string |
東太平洋 |
NI |
string |
北インド洋 |
NP |
string |
北西太平洋 |
SI |
string |
南西インド洋 |
SP |
string |
南太平洋 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
GeoJsonGeometry
有効な GeoJSON
geometry オブジェクト。 この型は、Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection の 7 つの有効な GeoJSON ジオメトリ型のいずれかである必要があります。 詳細については、 RFC 7946 を参照してください。
名前 | 型 | 説明 |
---|---|---|
type |
Geo |
型を指定します |
GeoJsonGeometryCollection
有効な GeoJSON GeometryCollection
オブジェクト型。 詳細については、 RFC 7946 を参照してください。
名前 | 型 | 説明 |
---|---|---|
geometries | GeoJsonGeometry[]: |
有効な |
type |
string:
Geometry |
型を指定します |
GeoJsonLineString
有効な GeoJSON LineString
geometry 型。 詳細については、 RFC 7946 を参照してください。
名前 | 型 | 説明 |
---|---|---|
coordinates |
number[] |
ジオメトリの |
type |
string:
Line |
型を指定します |
GeoJsonMultiLineString
有効な GeoJSON MultiLineString
geometry 型。 詳細については、 RFC 7946 を参照してください。
名前 | 型 | 説明 |
---|---|---|
coordinates |
number[] |
ジオメトリの |
type |
string:
Multi |
型を指定します |
GeoJsonMultiPoint
有効な GeoJSON MultiPoint
geometry 型。 詳細については、 RFC 7946 を参照してください。
名前 | 型 | 説明 |
---|---|---|
coordinates |
number[] |
ジオメトリの |
type |
string:
Multi |
型を指定します |
GeoJsonMultiPolygon
有効な GeoJSON MultiPolygon
オブジェクト型。 詳細については、 RFC 7946 を参照してください。
名前 | 型 | 説明 |
---|---|---|
coordinates |
number[] |
有効な |
type |
string:
Multi |
型を指定します |
GeoJsonPoint
有効な GeoJSON Point
geometry 型。 詳細については、 RFC 7946 を参照してください。
名前 | 型 | 説明 |
---|---|---|
coordinates |
number[] |
は |
type |
string:
Point |
型を指定します |
GeoJsonPolygon
有効な GeoJSON Polygon
geometry 型。 詳細については、 RFC 7946 を参照してください。
名前 | 型 | 説明 |
---|---|---|
coordinates |
number[] |
geometry 型の |
type |
string:
Polygon |
型を指定します |
JsonFormat
応答の目的の形式。 サポートされているのは json
形式のみです。
名前 | 型 | 説明 |
---|---|---|
json |
string |
LatLongPair
緯度と経度として表される場所。
名前 | 型 | 説明 |
---|---|---|
latitude |
number |
Latitude プロパティ |
longitude |
number |
Longitude プロパティ |
RadiusSector
ベアリング 0 – 90 = NE クアドラント;90 から 180 = SE 象限。180 –270 = SW 象限;270 から 360 = NW 象限。
名前 | 型 | 説明 |
---|---|---|
beginBearing |
number |
象限の始点の方位 (度単位)。 |
endBearing |
number |
象限の終点の方位 (度単位)。 |
range |
number |
四分円の半径 (海里単位)。 |
StormLocation
政府が発行した個々の嵐の場所
名前 | 型 | 説明 |
---|---|---|
dateTime |
string |
Datetime 予測が有効で、ISO8601形式で表示されます。 |
hasTropicalPotential |
boolean |
True の場合、嵐が熱帯系に発展する可能性があります。 |
isPostTropical |
boolean |
True の場合、嵐が弱まり、熱帯系ではなくなります。 |
isSubtropical |
boolean |
True の場合、うつ病は亜熱帯低気圧として分類されます。 |
location |
嵐の座標 |
|
maxWindGust |
嵐に関連する最大風の突風速度。 NULL の場合もあります。 |
|
minimumPressure |
嵐に関連する最小圧力。 NULL の場合もあります。 |
|
movement |
嵐の移動情報。 |
|
status |
string |
英語の嵐の状態。 |
sustainedWind |
嵐に関連する最大持続風速。 NULL の場合もあります。 |
|
windRadiiSummary |
要求で details=true または radiiGeometry=true の場合に表示されます。 |
StormLocationsResult
政府が発行した個々の嵐の場所
名前 | 型 | 説明 |
---|---|---|
nextLink |
string |
は、返される機能の次のページへのリンクです。 最後のページの場合、このフィールドはありません。 |
results |
政府が発行した個々の嵐の場所 |
StormWindRadiiSummary
要求で details=true または radiiGeometry=true の場合に表示されます。
名前 | 型 | 説明 |
---|---|---|
dateTime |
string |
風半径の概要データが有効な DateTime は、ISO8601形式で表示されます。 |
radiiGeometry | GeoJsonGeometry: |
GeoJSON オブジェクト。 要求で radiiGeometry=true の場合に表示されます。 風半径の象限のアウトラインについて説明します。 |
radiusSectorData |
風半径の象限をプロットするために必要な情報が含まれます。 ベアリング 0 – 90 = NE クアドラント;90 から 180 = SE 象限。180 –270 = SW 象限;270 から 360 = NW 象限。 |
|
windSpeed |
radiusSectorData に関連付けられている風速。 |
UnitType
表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。
名前 | 型 | 説明 |
---|---|---|
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
メトリック単位または帝国単位のいずれかでデータを返すように指定します。 既定値はメトリックです。
名前 | 型 | 説明 |
---|---|---|
imperial |
string |
帝国単位でデータを返します。 帝国システムの単位の例としては、華氏とマイルがあります。 |
metric |
string |
メトリック単位でデータを返します。 メトリック システムの単位の例としては、摂氏とキロメートルがあります。 |
WeatherUnit
気象に関連する特定の単位の特定の値。
名前 | 型 | 説明 |
---|---|---|
unit |
string |
戻り値の単位の型。 |
unitType |
表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。 |
|
value |
number |
丸められた値。 |
WindDetails
速度と方向を含む風の詳細が返されます。
名前 | 型 | 説明 |
---|---|---|
direction |
風向 |
|
speed |
指定した単位の風の速度。 |
WindDirection
風向
名前 | 型 | 説明 |
---|---|---|
degrees |
integer |
方位角の風向き。真北から始まり、時計回りの方向に続きます。 北は 0 度、東は 90 度、南は 180 度、西は 270 度です。 指定できる値は 0 から 359 です。 |
localizedDescription |
string |
指定した言語の方向の省略形。 |