Bing Maps 표준 시간대 찾기 API 마이그레이션

이 문서에서는 Bing Maps 표준 시간대 찾기 API에서 Azure Maps 좌표별 표준 시간대 가져오기 API로 마이그레이션하는 방법을 설명합니다. Azure Maps 좌표별 표준 시간대 가져오기 API는 지정된 위도-경도 쌍에 대한 현재, 과거 및 향후 표준 시간대 정보뿐만 아니라 지정된 위치에 대한 일몰 및 일출 시간도 반환합니다.

필수 조건

• Azure 계정
• Azure Maps 계정
• 구독 키 또는 다른 형태의 Azure Maps를 사용한 인증

주목할만한 차이점

• Bing Maps 표준 시간대 찾기 API는 좌표 및 위치 장소 이름, 행정 영역 및 국가/지역 이름을 위치 입력으로 지원합니다. Azure Maps 좌표별 표준 시간대 가져오기 API는 좌표만 지원합니다. 위치 이름, 행정 구역, 국가/지역 이름에 대한 좌표를 가져오려면 Azure Maps 지오코딩 가져오기 API를 사용할 수 있습니다.
• Bing Maps 표준 시간대 찾기 API는 XML 및 JSON 응답 형식을 모두 지원하고, Azure Maps 좌표별 표준 시간대 가져오기 API는 JSON만 지원합니다.
• Bing Maps 표준 시간대 찾기 API는 특정 표준 시간대에 대한 일출 및 일몰 값을 제공하지 않지만 Azure Maps 좌표별 표준 시간대 가져오기 API는 제공합니다.
• 엔터프라이즈용 Bing Maps와 달리 Azure Maps는 유럽(EU) 또는 미국(US) 지리적 영역(geos)으로 데이터 보존을 제한할 수 있는 지리적 범위 지정을 지원하는 글로벌 서비스입니다. 모든 요청(입력 데이터 포함)은 지정된 지리적 영역에서만 처리됩니다. 자세한 내용은 Azure Maps 서비스 지리적 범위를 참조하세요.

보안 및 인증

엔터프라이즈용 Bing Maps는 API 키 인증만 지원합니다. Azure Maps는 구독 키, Microsoft Entra ID 또는 SAS(공유 액세스 서명) 토큰과 같은 API 호출을 인증하는 다양한 방법을 지원합니다. Azure Maps의 보안 및 인증에 대한 자세한 내용은 Azure Maps 좌표별 표준 시간대 가져오기 설명서의 Azure Maps를 사용한 인증 및 보안 섹션을 참조하세요.

요청 매개 변수

다음 표에는 Bing Maps 표준 시간대 찾기 요청 매개 변수와 Azure Maps에 해당하는 매개 변수가 나열되어 있습니다.

자세한 내용은 Azure Maps 좌표별 시간대 가져오기 URI 매개 변수를 참조하세요.

요청 예제

Bing Maps 표준 시간대 찾기 API 요청:

https://dev.virtualearth.net/REST/v1/timezone/37.7800,-122.4201?key=%7bBingMapsKey%7d

Azure Maps 좌표로 표준 시간대 가져오기 API 요청:

https://atlas.microsoft.com/timezone/byCoordinates/json?api-version=1.0&query=37.7800,-122.4201&subscription-key={Your-Azure-Maps-Subscription-key}

응답 필드

다음 표에는 Bing Maps 표준 시간대 찾기 API 및 이에 상응하는 Azure Maps를 실행할 때 HTTP 응답에 나타날 수 있는 필드가 나열되어 있습니다.

Azure Maps 좌표별 표준 시간대 가져오기 응답 필드에 대한 자세한 내용은 정의 응답을 참조하세요.

응답 예

다음 JSON은 Bing Maps 표준 시간대 찾기 API 요청을 실행할 때 HTTP 응답 본문에 반환되는 내용의 샘플을 보여 줍니다.

{
    "authenticationResultCode": "ValidCredentials",
    "brandLogoUri": "https://dev.virtualearth.net/Branding/logo_powered_by.png",
    "copyright": "Copyright © 2024 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",
    "resourceSets": [
        {
            "estimatedTotal": 1,
            "resources": [
                {
                    "__type": "RESTTimeZone:http://schemas.microsoft.com/search/local/ws/rest/v1",
                    "timeZone": {
                        "genericName": "Pacific Standard Time",
                        "abbreviation": "PST",
                        "ianaTimeZoneId": "America/Los_Angeles",
                        "windowsTimeZoneId": "Pacific Standard Time",
                        "utcOffset": "-8:00",
                        "convertedTime": {
                            "localTime": "2024-02-11T14:21:58",
                            "utcOffsetWithDst": "-8:00",
                            "timeZoneDisplayName": "Pacific Standard Time",
                            "timeZoneDisplayAbbr": "PST"
                        }
                    }
                }
            ]
        }
    ],
    "statusCode": 200,
    "statusDescription": "OK",
    "traceId": "f02637665942c8cb21c8414bd03224aa|MWH0032BEF|0.0.0.1"
}

다음 샘플은 Azure Maps 좌표별 표준 시간대 가져오기 API 요청을 실행할 때 HTTP 응답 본문에 반환되는 내용을 보여 줍니다.

{
    "Version": "2023d",
    "ReferenceUtcTimestamp": "2024-02-11T22:32:29.4282815Z",
    "TimeZones": [
        {
            "Id": "America/Los_Angeles",
            "Aliases": [
                "US/Pacific"
            ],
            "Countries": [
                {
                    "Name": "United States",
                    "Code": "US"
                }
            ],
            "Names": {
                "ISO6391LanguageCode": "en",
                "Generic": "Pacific Time",
                "Standard": "Pacific Standard Time",
                "Daylight": "Pacific Daylight Time"
            },
            "ReferenceTime": {
                "Tag": "PST",
                "StandardOffset": "-08:00:00",
                "DaylightSavings": "00:00:00",
                "WallTime": "2024-02-11T14:32:29.4282815-08:00",
                "PosixTzValidYear": 2024,
                "PosixTz": "PST+8PDT,M3.2.0,M11.1.0",
                "Sunrise": "2024-02-11T07:04:33.6950704-08:00",
                "Sunset": "2024-02-11T17:43:15.3679015-08:00"
            },
            "RepresentativePoint": {
                "Latitude": 34.05222222222222,
                "Longitude": -118.24277777777777
            },
            "TimeTransitions": [
                {
                    "Tag": "PST",
                    "StandardOffset": "-08:00:00",
                    "DaylightSavings": "00:00:00",
                    "UtcStart": "2023-11-05T09:00:00Z",
                    "UtcEnd": "2024-03-10T10:00:00Z"
                },
                {
                    "Tag": "PDT",
                    "StandardOffset": "-08:00:00",
                    "DaylightSavings": "01:00:00",
                    "UtcStart": "2024-03-10T10:00:00Z",
                    "UtcEnd": "2024-11-03T09:00:00Z"
                },
                {
                    "Tag": "PST",
                    "StandardOffset": "-08:00:00",
                    "DaylightSavings": "00:00:00",
                    "UtcStart": "2024-11-03T09:00:00Z",
                    "UtcEnd": "2025-03-09T10:00:00Z"
                }
            ]
        }
    ]
}

트랜잭션 사용량

엔터프라이즈용 Bing Maps 표준 시간대 찾기 API와 유사하게, Azure Maps 좌표별 표준 시간대 가져오기 API는 API 요청당 하나의 청구 가능한 트랜잭션을 기록합니다. Azure Maps 트랜잭션에 대한 자세한 내용은 Azure Maps 트랜잭션 이해를 참조하세요.

추가 정보

추가 Azure Maps 표준 시간대 API

• ID로 표준 시간대 가져오기
• 표준 시간대 열거형 IANA 가져오기
• 표준 시간대 열거형 Windows 가져오기
• 표준 시간대 IANA 버전 가져오기
• IANA에 표준 시간대 Windows 가져오기

지원

• Microsoft Q&A 포럼