Weather - Get Tropical Storm Locations
Используйте для получения информации о местоположении тропических штормов от отдельных национальных агентств по прогнозированию погоды.
Get Tropical Storm Locations
API представляет собой HTTP-запросGET
, который возвращает местоположение отдельных тропических штормов, созданных правительством. Информация о тропических штормах включает в себя координаты местоположения, геометрию, идентификатор бассейна, дату, данные о ветре и радиусы ветра.
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 |
Номер версии API Azure Maps. |
basin
|
query | True |
Идентификатор бассейна |
|
gov
|
query | True |
integer (int32) |
Правительственный шторм Id |
year
|
query | True |
integer (int32) |
Год циклона (циклонов) |
current
|
query |
boolean |
Если значение true, возвращает текущее местоположение шторма |
|
details
|
query |
boolean |
Если значение равно true, в ответ включаются сводные данные о радиусах ветра |
|
radii
|
query |
boolean |
Если значение равно true, в ответ включаются сводные данные о радиусах ветра и сведения о geoJSON |
|
unit
|
query |
Указывает, что данные возвращаются в метрических или британских единицах. Значение по умолчанию — metric. |
Заголовок запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
x-ms-client-id |
string |
Указывает, какая учетная запись предназначена для использования в сочетании с моделью безопасности идентификатора Microsoft Entra. Он представляет уникальный идентификатор учетной записи Azure Maps и может быть получен из API учетной записи уровня управления Azure Maps. Сведения о том, как использовать безопасность идентификатора Microsoft Entra в Azure Maps, см. в следующих статьях |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
ХОРОШО |
|
Other Status Codes |
Произошла непредвиденная ошибка. |
Безопасность
AADToken
Это потоки Microsoft Entra OAuth 2.0. При паре с доступом на основе ролей Azure его можно использовать для управления доступом к REST API Azure Maps. Управление доступом на основе ролей Azure используется для назначения доступа к одной или нескольким учетным записям ресурсов Azure Maps или вложенным ресурсам. Доступ к любому пользователю, группе или субъекту-службе можно предоставить через встроенную роль или пользовательскую роль, состоящую из одного или нескольких разрешений для REST API Azure Maps.
Для реализации сценариев рекомендуется просматривать концепции проверки подлинности . В целом, это определение безопасности предоставляет решение для моделирования приложений через объекты, способные управлять доступом в определенных API и областях.
Примечания.
- Для этого определения безопасности требуется использовать заголовок
x-ms-client-id
, чтобы указать, к какой ресурсу Azure Maps приложение запрашивает доступ. Это можно получить из API управления карт.
Authorization URL
зависит от экземпляра общедоступного облака Azure. В национальных облаках есть уникальные URL-адреса авторизации и конфигурации идентификатора Microsoft Entra.
* Управление доступом на основе ролей Azure настраивается с плоскости управления Azure с помощью портала Azure, PowerShell, CLI, пакетов SDK Azure или REST API.
* Использование веб-пакета SDK Azure Maps позволяет настроить приложение на основе конфигурации для нескольких вариантов использования.
- Дополнительные сведения о платформе удостоверений Майкрософт см. в обзоре платформы удостоверений Майкрософт.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
Имя | Описание |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Это общий ключ, подготовленный при создания учетной записи Azure Maps на портале Azure или с помощью PowerShell, CLI, пакетов SDK Azure или REST API.
С помощью этого ключа любой приложение может получить доступ ко всем REST API. Другими словами, этот ключ можно использовать в качестве главного ключа в учетной записи, в которую они выданы.
Для общедоступных приложений мы рекомендуем использовать конфиденциальные клиентские приложения, подход для доступа к REST API Azure Maps, чтобы ваш ключ можно было безопасно хранить.
Тип:
apiKey
В:
query
SAS Token
Это маркер подписанного URL-адреса создается из операции SAS списка на ресурсе Azure Maps через плоскость управления Azure с помощью портала Azure, PowerShell, CLI, пакетов SDK Azure или REST API.
С помощью этого маркера любой приложению разрешен доступ с помощью управления доступом на основе ролей Azure и точного управления сроком действия, скоростью и регионами, используемыми для конкретного маркера. Другими словами, маркер SAS можно использовать для разрешения приложений управлять доступом более защищенным способом, чем общий ключ.
Для общедоступных приложений мы рекомендуем настроить определенный список разрешенных источников в ресурсе учетной записи карты карты, чтобы ограничить злоупотребление отрисовкой и регулярно обновлять маркер 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 = северо-восточный квадрант; 90–180 = юго-восточный квадрант; 180–270 = квадрант SW; 270–360 = Северо-Западный квадрант. |
Storm |
Место проведения отдельного шторма, объявленного правительством |
Storm |
Места проведения отдельного шторма, вызванного правительством |
Storm |
Отображается, когда details=true или radiiGeometry=true в запросе. |
Unit |
Числовое значение ID, связанное с типом отображаемой единицы измерения. Может использоваться для перевода единиц измерения. Дополнительные сведения см. в статье Службы погоды в Azure Maps . |
Weather |
Указывает, что данные возвращаются в метрических или британских единицах. Значение по умолчанию — metric. |
Weather |
Удельное значение данной единицы, связанное с погодой. |
Wind |
Возвращаются данные о ветре, включая скорость и направление. |
Wind |
Направление ветра |
basinId
Идентификатор бассейна
Значение | Описание |
---|---|
AL |
Атлантический |
CP |
Центральная часть Тихого океана |
EP |
Восточная часть Тихого океана |
NI |
Северная часть Индийского океана |
NP |
Северо-западная часть Тихого океана |
SI |
Юго-западная часть Индийского океана |
SP |
Южно-Тихоокеанский регион |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Дополнительный тип сведений. |
ErrorDetail
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ErrorResponse
Ответ на ошибку
Имя | Тип | Описание |
---|---|---|
error |
Объект ошибки. |
GeoJsonGeometry
Допустимый объект GeoJSON
геометрии. Тип должен быть одним из семи допустимых типов геометрии GeoJSON — Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon и GeometryCollection. Дополнительные сведения см. в RFC 7946.
Имя | Тип | Описание |
---|---|---|
type |
Geo |
Указывает тип |
GeoJsonGeometryCollection
Допустимый тип объекта GeoJSON GeometryCollection
. Дополнительные сведения см. в RFC 7946.
Имя | Тип | Описание |
---|---|---|
geometries | GeoJsonGeometry[]: |
Содержит список допустимых |
type |
string:
Geometry |
Указывает тип |
GeoJsonLineString
Допустимый тип геометрии GeoJSON LineString
. Дополнительные сведения см. в RFC 7946.
Имя | Тип | Описание |
---|---|---|
coordinates |
number[] (double) |
Координаты геометрии |
type |
string:
Line |
Указывает тип |
GeoJsonMultiLineString
Допустимый тип геометрии GeoJSON MultiLineString
. Дополнительные сведения см. в RFC 7946.
Имя | Тип | Описание |
---|---|---|
coordinates |
number[] (double) |
Координаты геометрии |
type |
string:
Multi |
Указывает тип |
GeoJsonMultiPoint
Допустимый тип геометрии GeoJSON MultiPoint
. Дополнительные сведения см. в RFC 7946.
Имя | Тип | Описание |
---|---|---|
coordinates |
number[] (double) |
Координаты геометрии |
type |
string:
Multi |
Указывает тип |
GeoJsonMultiPolygon
Допустимый тип объекта GeoJSON MultiPolygon
. Дополнительные сведения см. в RFC 7946.
Имя | Тип | Описание |
---|---|---|
coordinates |
number[] (double) |
Содержит список допустимых объектов |
type |
string:
Multi |
Указывает тип |
GeoJsonPoint
Допустимый тип геометрии GeoJSON Point
. Дополнительные сведения см. в RFC 7946.
Имя | Тип | Описание |
---|---|---|
coordinates |
number[] (double) |
|
type |
string:
Point |
Указывает тип |
GeoJsonPolygon
Допустимый тип геометрии GeoJSON Polygon
. Дополнительные сведения см. в RFC 7946.
Имя | Тип | Описание |
---|---|---|
coordinates |
number[] (double) |
Координаты для типа геометрии |
type |
string:
Polygon |
Указывает тип |
JsonFormat
Требуемый формат ответа. Поддерживается только json
формат.
Значение | Описание |
---|---|
json |
LatLongPair
Расположение, представленное в виде широты и долготы.
Имя | Тип | Описание |
---|---|---|
latitude |
number (double) |
Свойство Latitude |
longitude |
number (double) |
Свойство Долготы |
RadiusSector
Направление 0–90 = северо-восточный квадрант; 90–180 = юго-восточный квадрант; 180–270 = квадрант SW; 270–360 = Северо-Западный квадрант.
Имя | Тип | Описание |
---|---|---|
beginBearing |
number (double) |
Направление в градусах от начала квадранта. |
endBearing |
number (double) |
Направление в градусах от конца квадранта. |
range |
number (double) |
Радиус квадранта, в морских милях. |
StormLocation
Место проведения отдельного шторма, объявленного правительством
Имя | Тип | Описание |
---|---|---|
dateTime |
string |
Datetime прогноз действующий, отображается в ISO8601 формате. |
hasTropicalPotential |
boolean |
Верно, когда шторм может развиться в тропическую систему. |
isPostTropical |
boolean |
Верно, когда шторм ослабевает, и больше не станет тропической системой. |
isSubtropical |
boolean |
Верно, когда депрессия классифицируется как субтропический циклон. |
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 = северо-восточный квадрант; 90–180 = юго-восточный квадрант; 180–270 = квадрант SW; 270–360 = Северо-Западный квадрант. |
|
windSpeed |
Скорость ветра, связанная с radiusSectorData. |
UnitType
Числовое значение ID, связанное с типом отображаемой единицы измерения. Может использоваться для перевода единиц измерения. Дополнительные сведения см. в статье Службы погоды в Azure Maps .
Значение | Описание |
---|---|
0 |
футы |
1 |
дюймы |
10 |
метры в секунду (м/с) |
11 |
гектопаскали |
12 |
дюймы ртутного столба |
13 |
килопаскали |
14 |
миллибары |
15 |
миллиметры ртутного столба (мм рт. столба) |
16 |
poundsPerSquareInch (фунт/кв. дюйм) |
17 |
Цельсия |
18 |
Фаренгейт |
19 |
Кельвин |
2 |
мили |
20 |
процент |
21 |
плавать |
22 |
целое число |
3 |
миллиметр |
31 |
МикрограммКубический метр воздуха |
4 |
сантиметр |
5 |
метр |
6 |
километр |
7 |
километры в час (км/час) |
8 |
узлы |
9 |
миль в час |
WeatherDataUnit
Указывает, что данные возвращаются в метрических или британских единицах. Значение по умолчанию — metric.
Значение | Описание |
---|---|
imperial |
Возвращайте данные в британских единицах. Некоторыми примерами единиц имперской системы являются Фаренгейт и миля. |
metric |
Возвращайте данные в метрических единицах. Некоторыми примерами единиц метрической системы являются Цельсий и километр. |
WeatherUnit
Удельное значение данной единицы, связанное с погодой.
Имя | Тип | Описание |
---|---|---|
unit |
string |
Тип единицы измерения для возвращаемого значения. |
unitType |
Unit |
Числовое значение ID, связанное с типом отображаемой единицы измерения. Может использоваться для перевода единиц измерения. Дополнительные сведения см. в статье Службы погоды в Azure Maps . |
value |
number (float) |
Округленное значение. |
WindDetails
Возвращаются данные о ветре, включая скорость и направление.
Имя | Тип | Описание |
---|---|---|
direction |
Направление ветра |
|
speed |
Скорость ветра в указанной единице. |
WindDirection
Направление ветра
Имя | Тип | Описание |
---|---|---|
degrees |
integer (int32) |
Направление ветра в градусах по азимуту, начиная с истинного севера и продолжая по часовой стрелке. Север составляет 0 градусов, восток составляет 90 градусов, юг составляет 180 градусов, запад — 270 градусов. Возможные значения 0-359. |
localizedDescription |
string |
Аббревиатура направления на указанном языке. |