Bing Maps "쿼리를 통한 위치 찾기 API" 마이그레이션

이 문서에서는 Bing Maps Find a Location by Query API를 Azure Maps Get Geocoding API로 마이그레이션하는 방법을 설명합니다. Azure Maps Get Geocoding API는 거리 주소, 장소 또는 랜드마크의 경도 및 위도 좌표를 가져오는 데 사용됩니다. Azure Maps Get Geocoding API는 구조화되지 않거나 구조화된 형식의 지오코딩 입력을 지원합니다. 이 마이그레이션 설명서는 거리 주소, 지역, 우편 번호 또는 랜드마크 이름과 같은 지오코딩 입력이 Bing Maps Find a Location by Query API에서 지원하는 것과 유사한 구조화되지 않은 형식(query=)인 시나리오를 위한 것입니다. 주소별로 위치를 찾기 위해 지오코딩 입력이 구조화된 Bing Maps 시나리오를 마이그레이션하는 방법에 대한 자세한 내용은 Bing Maps 주소별 위치 찾기 API 마이그레이션을 참조하세요.

필수 조건

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

주요 차이점

• Bing Maps Find a Location by Query API는 구조화되지 않은 형식의 지오코딩 입력만 지원하는 반면, Azure Maps Get Geocoding API는 구조화되지 않은(query=) 또는 구조적(addressLine=) 형식의 지오코딩 입력을 지원합니다. 랜드마크 이름을 지오코딩하려면 구조화되지 않은 입력 형식을 사용하여 Azure Maps Get Geocoding API를 사용합니다.
• Bing Maps Find a Location by Query API는 위도/경도 형식으로 좌표를 반환하고, Azure Maps Get Geocoding API는 GeoJSON 형식으로 정의된 대로 경도/위도 형식으로 좌표를 반환합니다.
• Bing Maps Find a Location by Query API는 XML 및 JSON 응답 형식을 지원합니다. Azure Maps Get Geocoding API는 GeoJSON을 지원합니다.
• Bing Maps Find a Location by Query API와 달리 Azure Maps Get Geocoding API에는 viewISO 3166-1 알파-2 지역/국가 코드를 나타내는 문자열인 입력 매개 변수가 있습니다. 입력 매개 변수는 view 지정된 사용자 영역에 맞게 지정학적 분쟁 테두리 및 레이블을 변경합니다. 자세한 내용은 URI 매개 변수를 참조하세요.
• Bing Maps Find a Location by Query API와 달리 Azure Maps Get Geocoding API는 현재 중국의 주소 지오코딩을 지원하지 않습니다.
• 엔터프라이즈용 Bing Maps와 달리 Azure Maps는 지리적 범위 지정을 지원하는 글로벌 서비스로, 유럽(EU) 또는 미국(미국) 지리적 영역(지역)에 대한 데이터 보존 제한을 허용합니다. 모든 요청(입력 데이터 포함)은 지정된 지리적 영역에서만 처리됩니다. 자세한 내용은 지리적 범위를 참조하세요.

보안 및 인증

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

요청 매개 변수

다음 표에는 Bing Maps Find a Location by Query 요청 매개 변수 및 Azure Maps에 해당하는 항목이 나와 있습니다.

Azure Maps Get Geocoding API 요청 매개 변수에 대한 자세한 내용은 URI 매개 변수를 참조하세요.

요청 예제

Bing Maps 쿼리 API POST 요청으로 위치 찾기 :

http://dev.virtualearth.net/REST/v1/Locations/15127 NE 24th Street Redmond WA&key={BingMapsKey}

Azure Maps 지오코딩 가져오기 API POST 요청:

https://atlas.microsoft.com/geocode?api-version=2023-06-01&query=15127 NE 24th Street Redmond WA&subscription-key={Your-Azure-Maps-Subscription-key}

응답 필드

다음 표에는 Bing Maps Find a Location by Query 요청을 실행할 때 HTTP 응답에 표시할 수 있는 필드와 해당하는 Azure Maps가 나열되어 있습니다.

Azure Maps Get Geocoding API 응답 필드에 대한 자세한 내용은 정의를 참조하세요.

응답 예제

다음 JSON 샘플은 Bing Maps 쿼리별 위치 찾기 요청을 실행할 때 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": "Location:http://schemas.microsoft.com/search/local/ws/rest/v1", 
                    "bbox": [ 
                        47.62649628242932, 
                        -122.14631082421619, 
                        47.634221717570675, 
                        -122.1310271757838 
                    ], 
                    "name": "15127 NE 24th St, Redmond, WA 98052", 
                    "point": { 
                        "type": "Point", 
                        "coordinates": [ 
                            47.630359, 
                            -122.138669 
                        ] 
                    }, 
                    "address": { 
                        "addressLine": "15127 NE 24th St", 
                        "adminDistrict": "WA", 
                        "adminDistrict2": "King County", 
                        "countryRegion": "United States", 
                        "formattedAddress": "15127 NE 24th St, Redmond, WA 98052", 
                        "locality": "Redmond", 
                        "postalCode": "98052" 
                    }, 
                    "confidence": "High", 
                    "entityType": "Address", 
                    "geocodePoints": [ 
                        { 
                            "type": "Point", 
                            "coordinates": [ 
                                47.630359, 
                                -122.138669 
                            ], 
                            "calculationMethod": "Rooftop", 
                            "usageTypes": [ 
                                "Display" 
                            ] 
                        }, 
                        { 
                            "type": "Point", 
                            "coordinates": [ 
                                47.630563, 
                                -122.1387383 
                            ], 
                            "calculationMethod": "Rooftop", 
                            "usageTypes": [ 
                                "Route" 
                            ] 
                        } 
                    ], 
                    "matchCodes": [ 
                        "Good" 
                    ] 
                } 
            ] 
        } 
    ], 
    "statusCode": 200, 
    "statusDescription": "OK", 
    "traceId": "7896468b37528ac145ef77cc62484fd6|MWH0032BE2|0.0.0.1|Ref A: 7D01B283F7644D2891600E265FB30B24 Ref B: CO1EDGE2318 Ref C: 2024-04-23T18:29:55Z" 

다음 JSON 샘플은 Azure Maps 지오코딩 가져오기 요청을 실행할 때 HTTP 응답 본문에 반환되는 항목을 보여 줍니다.

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -122.138679,
                    47.630356
                ]
            },
            "bbox": [
                -122.14632082377759,
                47.62649328242932,
                -122.1310371762224,
                47.634218717570675
            ],
            "properties": {
                "type": "Address",
                "confidence": "High",
                "matchCodes": [
                    "Good"
                ],
                "geocodePoints": [
                    {
                        "calculationMethod": "Rooftop",
                        "usageTypes": [
                            "Display"
                        ],
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                -122.138679,
                                47.630356
                            ]
                        }
                    },
                    {
                        "calculationMethod": "Rooftop",
                        "usageTypes": [
                            "Route"
                        ],
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                -122.138685,
                                47.6305637
                            ]
                        }
                    }
                ],
                "address": {
                    "addressLine": "15127 NE 24th St",
                    "postalCode": "98052",
                    "locality": "Redmond",
                    "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
                    "countryRegion": {
                        "name": "United States",
                        "ISO": "US"
                    },
                    "adminDistricts": [
                        {
                            "shortName": "WA"
                        },
                        {
                            "shortName": "King County"
                        }
                    ]
                }
            }
        }
    ]
}

트랜잭션 사용량

Bing Maps Find a Location by Query API와 마찬가지로 Azure Maps Get Geocoding API는 요청당 하나의 청구 가능한 트랜잭션을 기록합니다. Azure Maps 트랜잭션에 대한 자세한 내용은 Azure Maps 트랜잭션 이해를 참조하세요.

추가 정보

• 지오코딩 일괄 처리 가져오기: 단일 동기 요청에서 지오코딩 가져오기 API에 쿼리 일괄 처리를 보내는 데 사용합니다.

Support

• Microsoft Q&A 포럼