Weather - Get Daily Historical Records
지정된 위치에서 과거 일일 기록 온도, 강수량 및 강설량과 같은 기후 데이터를 가져오는 데 사용합니다.
Get Daily Historical Records
API는 지정된 좌표 위치에서 과거 일일 기록 온도, 강수량 및 강설량과 같은 기후 데이터를 반환하는 HTTP GET
요청입니다. 레코드 데이터의 가용성은 위치에 따라 달라집니다. 일반적으로 기록 데이터는 위치에 따라 지난 5년에서 40년 이상까지 사용할 수 있습니다.
GET https://atlas.microsoft.com/weather/historical/records/daily/json?api-version=1.1&query={query}&startDate={startDate}&endDate={endDate}
GET https://atlas.microsoft.com/weather/historical/records/daily/json?api-version=1.1&query={query}&startDate={startDate}&endDate={endDate}&unit={unit}
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
format
|
path | True |
원하는 응답 형식입니다. |
|
api-version
|
query | True |
string |
Azure Maps API의 버전 번호. |
end
|
query | True |
string date |
ISO 8601 형식의 종료 날짜(예: 2019-10-28). 지원되는 날짜 범위는 1~31일이므로 최대 31일을 초과하지 않는 startDate 및 endDate를 지정해야 합니다(예: startDate=2012-01-01&endDate=2012-01-31). |
query
|
query | True |
number[] |
위도로 구성된 쉼표로 구분된 문자열로 지정된 해당 쿼리와 경도(예: "47.641268,-122.125679"). |
start
|
query | True |
string date |
ISO 8601 형식의 시작 날짜(예: 2019-10-27). 지원되는 날짜 범위는 1~31일이므로 최대 31일을 초과하지 않는 startDate 및 endDate를 지정해야 합니다(예: startDate=2012-01-01&endDate=2012-01-31). |
unit
|
query |
메트릭 단위 또는 임페리얼 단위로 데이터를 반환하도록 지정합니다. 기본값은 메트릭입니다. |
요청 헤더
Name | 필수 | 형식 | Description |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정의 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. Azure Maps Microsoft Entra ID 보안을 사용하려면 다음 문서를 참조하세요. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
정상 |
|
Other Status Codes |
예기치 않은 오류가 발생했습니다. |
보안
AADToken
다음은 Microsoft Entra OAuth 2.0 흐름입니다. Azure 역할 기반 액세스 제어와 쌍을 이루는 경우 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 기본 제공 역할 또는 REST API를 Azure Maps 하나 이상의 권한으로 구성된 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.
시나리오를 구현하려면 인증 개념을 보는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하는 솔루션을 제공합니다.
참고
- 이 보안 정의는 애플리케이션이
x-ms-client-id
액세스를 요청하는 Azure Maps 리소스를 나타내기 위해 헤더를 사용해야 합니다. 이는 지도 관리 API에서 가져올 수 있습니다.
Authorization URL
은 Azure 퍼블릭 클라우드 instance 관련됩니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다.
* Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다.
* Azure Maps Web SDK를 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.
- Microsoft ID 플랫폼 대한 자세한 내용은 Microsoft ID 플랫폼 개요를 참조하세요.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
이 키는 Azure Portal Azure Maps 계정을 Create PowerShell, CLI, Azure SDK 또는 REST API를 사용할 때 프로비전되는 공유 키입니다.
이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있습니다. 즉, 이 키는 발급된 계정에서 master 키로 사용할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 기밀 클라이언트 애플리케이션 접근 방식을 사용하여 키를 안전하게 저장할 수 있도록 Azure Maps REST API에 액세스하는 것이 좋습니다.
Type:
apiKey
In:
query
SAS Token
공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스의 SAS 나열 작업에서 만들어집니다.
이 토큰을 사용하면 모든 애플리케이션이 특정 토큰에 사용할 만료, 속도 및 지역에 대한 Azure 역할 기반 액세스 제어 및 세분화된 제어를 사용하여 액세스할 수 있는 권한이 부여됩니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.
Type:
apiKey
In:
header
예제
Successful Daily Historical Records Request
Sample Request
GET https://atlas.microsoft.com/weather/historical/records/daily/json?api-version=1.1&query=39.952583,-75.165222&startDate=2012-01-20&endDate=2012-01-22
Sample Response
{
"results": [
{
"date": "2012-01-20T00:00:00-04:00",
"temperature": {
"maximum": {
"value": 18.3,
"unit": "C",
"unitType": 17,
"year": 1951
},
"minimum": {
"value": -19.4,
"unit": "C",
"unitType": 17,
"year": 1984
},
"average": {
"value": -0.6,
"unit": "C",
"unitType": 17
}
},
"precipitation": {
"maximum": {
"value": 48,
"unit": "mm",
"unitType": 3,
"year": 1978
}
},
"snowfall": {
"maximum": {
"value": 12.19,
"unit": "cm",
"unitType": 4,
"year": 1978
}
}
},
{
"date": "2012-01-21T00:00:00-04:00",
"temperature": {
"maximum": {
"value": 16.7,
"unit": "C",
"unitType": 17,
"year": 1959
},
"minimum": {
"value": -21.1,
"unit": "C",
"unitType": 17,
"year": 1985
},
"average": {
"value": -2.2,
"unit": "C",
"unitType": 17
}
},
"precipitation": {
"maximum": {
"value": 33.5,
"unit": "mm",
"unitType": 3,
"year": 1979
}
},
"snowfall": {
"maximum": {
"value": 34.29,
"unit": "cm",
"unitType": 4,
"year": 2014
}
}
},
{
"date": "2012-01-22T00:00:00-04:00",
"temperature": {
"maximum": {
"value": 21.1,
"unit": "C",
"unitType": 17,
"year": 1906
},
"minimum": {
"value": -21.7,
"unit": "C",
"unitType": 17,
"year": 1984
},
"average": {
"value": -0.3,
"unit": "C",
"unitType": 17
}
},
"precipitation": {
"maximum": {
"value": 26.2,
"unit": "mm",
"unitType": 3,
"year": 1987
}
},
"snowfall": {
"maximum": {
"value": 22.35,
"unit": "cm",
"unitType": 4,
"year": 1987
}
}
}
]
}
정의
Name | Description |
---|---|
Daily |
|
Daily |
|
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Json |
원하는 응답 형식입니다. |
Unit |
표시되는 단위 유형과 연결된 숫자 ID 값입니다. 단위 번역에 사용할 수 있습니다. 자세한 내용은 Azure Maps 날씨 서비스를 참조하세요. |
Weather |
메트릭 단위 또는 임페리얼 단위로 데이터를 반환하도록 지정합니다. 기본값은 메트릭입니다. |
Weather |
날씨와 관련된 지정된 단위의 특정 값입니다. |
Weather |
|
Weather |
반환된 온도 값입니다. |
Weather |
반환된 온도 값입니다. |
DailyHistoricalRecords
Name | 형식 | Description |
---|---|---|
date |
string |
ISO 8601 형식으로 표시된 현재 관찰 날짜 및 시간(예: 2019-10-27T19:39:57-08:00). |
precipitation |
하락한 최대 강수량(액체 등가)입니다. |
|
snowfall |
최대 강설량. |
|
temperature |
온도 값입니다. |
DailyHistoricalRecordsResult
Name | 형식 | Description |
---|---|---|
nextLink |
string |
는 반환된 기능의 다음 페이지에 대한 링크입니다. 마지막 페이지인 경우 이 필드가 없습니다. |
results |
요청된 각 날짜에 대한 기록 레코드입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
JsonFormat
원하는 응답 형식입니다. json
형식만 지원됩니다.
Name | 형식 | Description |
---|---|---|
json |
string |
UnitType
표시되는 단위 유형과 연결된 숫자 ID 값입니다. 단위 번역에 사용할 수 있습니다. 자세한 내용은 Azure Maps 날씨 서비스를 참조하세요.
Name | 형식 | Description |
---|---|---|
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
메트릭 단위 또는 임페리얼 단위로 데이터를 반환하도록 지정합니다. 기본값은 메트릭입니다.
Name | 형식 | Description |
---|---|---|
imperial |
string |
임페리얼 단위로 데이터를 반환합니다. 제국 시스템의 몇 가지 예 단위는 화씨와 마일입니다. |
metric |
string |
메트릭 단위로 데이터를 반환합니다. 메트릭 시스템의 몇 가지 예제 단위는 섭씨 및 킬로미터입니다. |
WeatherUnit
날씨와 관련된 지정된 단위의 특정 값입니다.
Name | 형식 | Description |
---|---|---|
unit |
string |
반환된 값의 단위 유형입니다. |
unitType |
표시되는 단위 유형과 연결된 숫자 ID 값입니다. 단위 번역에 사용할 수 있습니다. 자세한 내용은 Azure Maps 날씨 서비스를 참조하세요. |
|
value |
number |
반올림된 값입니다. |
WeatherUnitYear
Name | 형식 | Description |
---|---|---|
unit |
string |
반환된 값의 단위 유형입니다. |
unitType |
integer |
표시되는 단위 유형과 연결된 숫자 ID 값입니다. 단위 번역에 사용할 수 있습니다. 자세한 내용은 Azure Maps 날씨 서비스를 참조하세요. |
value |
number |
반올림된 값입니다. |
year |
integer |
값이 발생한 연도입니다. |
WeatherUnitYearMax
반환된 온도 값입니다.
Name | 형식 | Description |
---|---|---|
maximum |
기간의 최대 온도입니다. |
WeatherUnitYearMaxMinAvg
반환된 온도 값입니다.
Name | 형식 | Description |
---|---|---|
average |
기간의 평균 온도입니다. |
|
maximum |
기간의 최대 온도입니다. |
|
minimum |
기간의 최소 온도입니다. |