Search - Get Geocoding Batch

서비스:: Maps

API 버전:: 2026-01-01

단일 요청으로 Geocoding API에 쿼리 배치를 보내는 데 사용합니다.
Get Geocoding Batch API는 단일 요청으로 최대 POST개의 쿼리 배치를 Geocoding API로 보내는 HTTP 요청입니다.

동기 일괄 처리 요청 제출

간단한 일괄 처리 요청에는 동기 API를 사용하는 것이 좋습니다. 서비스가 요청을 받으면 일괄 처리 항목이 계산되는 즉시 응답하며 나중에 결과를 검색할 가능성이 없습니다. 요청이 60초보다 오래 걸리는 경우 동기 API는 시간 제한 오류(408 응답)를 반환합니다. 일괄 처리 항목 수는 이 API에 대해 100개 제한됩니다.

POST https://atlas.microsoft.com/geocode:batch?api-version={api-version}

Batch 요청에 대한 POST 본문

지오코딩 쿼리를 보내려면 요청 본문에 배열 형식이 포함 POSTbatchItems 되고 헤더가 json 로 Content-Type설정되는 요청을 사용합니다application/json. 다음은 2개의 지오코딩 쿼리가 포함된 샘플 요청 본문입니다.

{
  "batchItems": [
    {
      "addressLine": "One, Microsoft Way, Redmond, WA 98052",
      "top": 2
    },
    {
      "addressLine": "Pike Pl",
      "adminDistrict": "WA",
      "locality": "Seattle",
      "top": 3
    }
  ]
}

지오코딩 batchItem 객체는 지원되는 지오코딩URI 매개변수를 허용할 수 있습니다.

일괄 처리에는 1개 이상의 쿼리가 포함되어야 합니다.

Batch 응답 모델

일괄 처리 응답에는 원래 일괄 처리 요청의 일부인 summary 성공적으로 실행된 쿼리와 totalRequests 나타내는 successfulRequests 구성 요소가 포함되어 있습니다. 일괄 처리 응답에는 일괄 처리 요청의 모든 쿼리에 대한 응답이 포함된 batchItems 배열도 포함됩니다. batchItems 일괄 처리 요청에서 원래 쿼리가 전송된 순서와 정확히 동일한 순서로 결과를 포함합니다. 각 항목은 다음 유형 중 하나입니다.

GeocodingResponse - 쿼리가 성공적으로 완료된 경우
Error - 쿼리가 실패한 경우 응답에는 이 경우 code 및 message 포함됩니다.

POST {endpoint}/geocode:batch?api-version=2026-01-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 헤더

Name	필수	형식	Description
x-ms-client-id		string	Azure AD 보안 모델과 함께 사용할 계정을 지정합니다. 이 ID는 Azure Maps 계정의 고유 ID를 나타내며, Azure Maps 관리 평면 계정 API에서 가져올 수 있습니다. Azure Maps에서 Microsoft Entra ID 보안 사용에 대한 자세한 내용은 Azure Maps의 인증 관리 를 참조하세요.
Accept-Language		string	검색 결과를 반환해야 하는 언어입니다. 자세한 내용은 지원되는 언어 참조하세요.

Name

필수

형식

Description

x-ms-client-id

string

Azure AD 보안 모델과 함께 사용할 계정을 지정합니다. 이 ID는 Azure Maps 계정의 고유 ID를 나타내며, Azure Maps 관리 평면 계정 API에서 가져올 수 있습니다. Azure Maps에서 Microsoft Entra ID 보안 사용에 대한 자세한 내용은 Azure Maps의 인증 관리 를 참조하세요.

Accept-Language

string

검색 결과를 반환해야 하는 언어입니다.

자세한 내용은 지원되는 언어 참조하세요.

요청 본문

Name	형식	Description
batchItems	GeocodingBatchRequestItem[]	처리할 쿼리 목록입니다.

응답

Name	형식	Description
200 OK	GeocodingBatchResponse	요청이 성공했습니다.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	예기치 않은 오류 응답입니다. 헤더 x-ms-error-code: string

Name

형식

Description

200 OK

GeocodingBatchResponse

요청이 성공했습니다.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

예기치 않은 오류 응답입니다.

헤더

x-ms-error-code: string

보안

AadToken

이들은 Microsoft Entra OAuth 2.0 흐름입니다. Azure 역할 기반 접근 제어와 결합하면 Azure Maps REST API 접근을 제어하는 데 사용할 수 있습니다. Azure 역할 기반 접근 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 접근 권한을 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 내장된 역할이나 하나 이상의 권한으로 구성된 사용자 지정 역할을 통해 Azure Maps REST API에 대한 접근 권한을 부여받을 수 있습니다.\n\n시나리오를 구현하려면 authentication concepts를 참고하는 것을 권장합니다. 요약하자면, 이 보안 정의는 특정 API와 범위에 대한 접근 제어가 가능한 객체를 통해 애플리케이션을 모델링하는 솔루션을 제공합니다.\n\n#### 주석\n* 이 보안 정의 요구 애플리케이션이 요청하는 Azure Maps 리소스를 나타내기 위해 x-ms-client-id 헤더를 사용하는 것입니다. 이는 Maps 관리 API에서 얻을 수 있습니다.\n* \nAuthorization URL은 Azure 퍼블릭 클라우드 인스턴스에만 특화된 것입니다. 소버린 클라우드는 고유한 권한 부여 URL과 Microsoft Entra ID 구성을 가지고 있습니다. \n* \nAzure 역할 기반 접근 제어는 Azure 관리 평면에서 Azure 포털, PowerShell, CLI, Azure SDK 또는 REST API를 통해 구성됩니다.\n* Azure Maps Web SDK는 다양한 사용 사례에 맞는 애플리케이션 구성을 설정할 수 있게 해줍니다.\n* Microsoft ID 플랫폼에 대한 자세한 내용은 Microsoft ID 플랫폼 개요를 참조하세요.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
https://atlas.microsoft.com/.default

subscription-key

이 키는 Azure 포털에서 Create a Azure Maps account 또는 PowerShell, CLI, Azure SDK, REST API를 사용할 때 제공되는 공유 키입니다.\n\n 이 키로 모든 애플리케이션이 모든 REST API에 접근할 수 있습니다. 즉, 이 키는 발급된 계좌의 마스터 키로 사용할 수 있습니다.\n\n 공개된 애플리케이션의 경우, confidential client applications 방식을 사용하여 REST API에 Azure Maps접근하여 키를 안전하게 저장할 수 있도록 하는 것을 권장합니다.

형식: apiKey
In(다음 안에): header

SAS Token

이 토큰은 Azure Maps 리소스의 List SAS 연산에서 Azure 포털, PowerShell, CLI, Azure SDK, REST API를 통해 Azure 관리 플레인을 통해 생성됩니다.\n\n 이 토큰을 사용하면 모든 애플리케이션이 Azure로 접근할 권한이 부여됩니다 역할 기반 접근 제어 및 특정 토큰의 만료일, 사용 속도, 사용 영역에 대한 세밀한 제어를 제공합니다. 즉, SAS 토큰은 공유 키보다 더 안전한 방식으로 애플리케이션이 접근 권한을 제어할 수 있도록 하는 데 사용될 수 있습니다.\n\n 공개적으로 노출된 애플리케이션의 경우, Map 계정 리소스 에서 허용된 출처 목록을 구체적으로 설정하여 렌더링 남용을 제한하고 SAS 토큰을 정기적으로 갱신할 것을 권장합니다.

형식: apiKey
In(다음 안에): header

예제

A Geocoding Batch API call containing 2 Geocoding queries

샘플 요청

HTTP

POST {endpoint}/geocode:batch?api-version=2026-01-01

{
  "batchItems": [
    {
      "addressLine": "15127 NE 24th Street, Redmond, WA 98052",
      "top": 2,
      "optionalId": "4C3681A6C8AA4AC3441412763A2A25C81444DC8B"
    },
    {
      "query": "Pike Pl",
      "locality": "Seattle",
      "top": 3
    }
  ]
}

샘플 응답

상태 코드:: 200

{
  "summary": {
    "successfulRequests": 1,
    "totalRequests": 2
  },
  "batchItems": [
    {
      "optionalId": "4C3681A6C8AA4AC3441412763A2A25C81444DC8B",
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "properties": {
            "type": "Address",
            "confidence": "High",
            "matchCodes": [
              "Good"
            ],
            "address": {
              "locality": "Redmond",
              "adminDistricts": [
                {
                  "shortName": "WA"
                },
                {
                  "shortName": "King County"
                }
              ],
              "countryRegion": {
                "ISO": "US",
                "name": "United States"
              },
              "postalCode": "98052",
              "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
              "streetName": "NE 24th St",
              "streetNumber": "15127",
              "addressLine": "15127 NE 24th St"
            },
            "geocodePoints": [
              {
                "geometry": {
                  "type": "Point",
                  "coordinates": [
                    -122.138669,
                    47.630359
                  ]
                },
                "calculationMethod": "Rooftop",
                "usageTypes": [
                  "Display",
                  "Route"
                ]
              },
              {
                "geometry": {
                  "type": "Point",
                  "coordinates": [
                    -122.1387383,
                    47.630563
                  ]
                },
                "calculationMethod": "Rooftop",
                "usageTypes": [
                  "Route"
                ]
              }
            ]
          },
          "geometry": {
            "type": "Point",
            "coordinates": [
              -122.138669,
              47.630359
            ]
          },
          "bbox": [
            -122.14631082421619,
            47.62649628242932,
            -122.1310271757838,
            47.634221717570675
          ]
        }
      ]
    },
    {
      "error": {
        "code": "Conflicting Parameters",
        "message": "When 'query' is present, only the following parameters are valid: 'bbox, location, view, top'. 'locality' was passed"
      }
    }
  ]
}

정의

Name	Description
Address	결과의 주소입니다.
AddressAdminDistrictsItem	주소에 대한 국가 또는 지역의 세분화 이름입니다.
AddressCountryRegion	이름 및 ISO 코드가 있는 국가 또는 지역입니다.
Azure.Core.Foundations.Error	오류 개체입니다.
Azure.Core.Foundations.ErrorResponse	오류 세부 정보가 포함된 응답입니다.
Azure.Core.Foundations.InnerError	오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Azure REST API 가이드라인에 따르면 - https://aka.ms/AzureRestApiGuidelines#handling-errors.
CalculationMethodEnum	지오코드 지점을 계산하는 데 사용된 메서드입니다.
ConfidenceEnum	지오코딩된 위치 결과가 일치하는 신뢰도 수준입니다. 일치 코드와 함께 이 값을 사용하여 일치 항목에 대한 자세한 정보를 확인합니다. 지오코딩된 위치의 신뢰도는 지정된 경우 지오코딩된 위치 및 사용자의 위치의 상대적 중요도를 비롯한 여러 요인을 기반으로 합니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
FeatureCollectionEnum	`GeoJSON` 형식을 지정합니다. 지원되는 유일한 개체 형식은 `FeatureCollection`. 자세한 내용은 RFC 7946참조하세요.
FeaturesItem	특징 오브젝트입니다.
FeaturesItemProperties	특징의 특성.
FeatureTypeEnum	기능 유형은 기능이어야 합니다.
GeocodePointsItem	지오코드 포인트.
GeocodingBatchRequestBody	처리할 주소 지오코딩 쿼리/요청 목록입니다. 목록에는 최대 100개의 쿼리가 포함될 수 있으며 1개 이상의 쿼리가 포함되어야 합니다.
GeocodingBatchRequestItem	Batch 쿼리 개체
GeocodingBatchResponse	이 개체는 성공적인 Geocoding Batch 서비스 호출에서 반환됩니다.
GeocodingBatchResponseItem	배치 응답 항목입니다.
GeocodingBatchResponseSummary	일괄 처리 요청에 대한 요약
GeoJsonObjectType	`GeoJSON` 형식을 지정합니다. Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, FeatureCollection 등 유효한 9가지 GeoJSON 개체 형식 중 하나여야 합니다.
GeoJsonPoint	유효한 `GeoJSON Point` 기하 도형 형식입니다. 자세한 내용은 RFC 7946 참조하세요.
Intersection	결과의 주소입니다.
MatchCodesEnum	매치 코드를 나타내는 열거 항목입니다.
UsageTypeEnum	사용 유형을 나타내는 열거형입니다.

Address

Object

결과의 주소입니다.

Name	형식	Description
addressLine	string	거리 이름과 번호가 포함된 AddressLine
adminDistricts	AddressAdminDistrictsItem[]	주소에 대한 국가 또는 지역의 세분화 이름입니다. 이 요소는 일반적으로 첫 번째 순서 관리 세분화로 처리되지만 경우에 따라 국가, 종속성 또는 지역의 두 번째, 세 번째 또는 네 번째 순서 세분화도 포함됩니다.
countryRegion	AddressCountryRegion	이름 및 ISO 코드가 있는 국가 또는 지역입니다.
formattedAddress	string	형식이 지정된 주소 속성
intersection	Intersection	결과의 주소입니다.
locality	string	지역 속성
neighborhood	string	인근 부동산
postalCode	string	우편 번호 속성
streetName	string	formattedAddress의 거리 이름
streetNumber	string	formattedAddress의 거리의 번호(사용 가능한 경우)

AddressAdminDistrictsItem

Object

주소에 대한 국가 또는 지역의 세분화 이름입니다.

Name	형식	Description
name	string	해당 adminDistrict 필드의 이름, adminDistrict[0]의 경우 이 이름은 워싱턴, adminDistrict[1]과 같은 주의 전체 이름이 될 수 있으며, 이는 카운티의 전체 이름이 될 수 있습니다.
shortName	string	해당 adminDistrict 필드의 짧은 이름인 adminDistrict[0]의 경우 WA, adminDistrict[1]와 같은 주의 짧은 이름이 될 수 있습니다. 이 이름은 카운티의 짧은 이름일 수 있습니다.

AddressCountryRegion

Object

이름 및 ISO 코드가 있는 국가 또는 지역입니다.

Name	형식	Description
ISO	string	국가/지역의 ISO
name	string	국가/지역의 이름

Azure.Core.Foundations.Error

Object

오류 개체입니다.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
details	Azure.Core.Foundations.Error[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror	Azure.Core.Foundations.InnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.
target	string	오류의 대상입니다.

Azure.Core.Foundations.ErrorResponse

Object

오류 세부 정보가 포함된 응답입니다.

Name	형식	Description
error	Azure.Core.Foundations.Error	오류 개체입니다.

Azure.Core.Foundations.InnerError

Object

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Azure REST API 가이드라인에 따르면 - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
innererror	Azure.Core.Foundations.InnerError	내부 오류입니다.

CalculationMethodEnum

열거형

지오코드 지점을 계산하는 데 사용된 메서드입니다.

값	Description
Interpolation	지오코드 포인트는 보간을 사용하여 도로의 포인트와 일치했습니다.
InterpolationOffset	지오코드 포인트는 보간을 사용하여 도로의 포인트와 일치시켰고, 추가 간격띄우기를 사용하여 포인트를 도로 측면으로 이동했습니다.
Parcel	지오코드 포인트가 구획의 중심과 일치했습니다.
Rooftop	지오코드 포인트가 건물의 옥상과 일치했습니다.

ConfidenceEnum

열거형

지오코딩된 위치 결과가 일치하는 신뢰도 수준입니다. 일치 코드와 함께 이 값을 사용하여 일치 항목에 대한 자세한 정보를 확인합니다.

지오코딩된 위치의 신뢰도는 지정된 경우 지오코딩된 위치 및 사용자의 위치의 상대적 중요도를 비롯한 여러 요인을 기반으로 합니다.

값 Description

High

값	Description
High	신뢰도가 로 설정된 `High`경우 하나 이상의 강력한 일치 항목이 발견되었습니다. 다중 신뢰도 일치는 `High` 해당되는 경우 중요도에 따라 순위가 매겨진 순서로 정렬됩니다. 예를 들어 랜드마크는 중요하지만 주소는 중요하지 않습니다. 요청에 위치 또는 보기가 포함된 경우 순위가 적절하게 변경될 수 있습니다. 예를 들어 "Paris"에 대한 위치 쿼리는 "Paris, France" 및 "Paris, TX"를 모두 신뢰할 수 있게 `High` 반환합니다. "프랑스 파리"는 사용자 위치가 사용자가 텍사스 주 파리에 있거나 매우 가깝다는 것을 나타내거나 지도 보기에서 사용자가 해당 지역에서 검색하고 있음을 나타내지 않는 한 중요도로 인해 항상 첫 번째 순위가 됩니다.
Medium	경우에 따라 반환된 일치 항목이 요청에 제공된 정보와 동일한 수준이 아닐 수 있습니다. 예를 들어 요청은 주소 정보를 지정할 수 있으며 지오코드 서비스는 우편번호와만 일치할 수 있습니다. 이 경우 지오코드 서비스가 우편 번호가 데이터와 일치한다는 신뢰도를 가지고 있는 경우 신뢰도는 로 `Medium` 설정되고 일치 코드는 로 `UpHierarchy` 설정되어 모든 정보와 일치할 수 없으며 상위 계층을 검색해야 함을 지정합니다. 쿼리의 위치 정보가 모호하고 위치의 순위를 매기는 추가 정보(예: 사용자 위치 또는 위치의 상대적 중요도)가 없는 경우 신뢰도는 로 설정 `Medium`됩니다. 예를 들어 "148th Ave, Bellevue"에 대한 위치 쿼리는 "148th Ave SE" 및 "148th Ave NE"를 모두 신뢰할 수 있게 `Medium` 반환할 수 있습니다. 쿼리의 위치 정보가 특정 위치를 지오코딩하기에 충분한 정보를 제공하지 않는 경우 덜 정확한 위치 값이 반환될 수 있으며 신뢰도는 로 설정 `Medium`됩니다. 예를 들어 주소가 제공되었지만 집 번호와 일치하는 항목을 찾을 수 없는 경우 Roadblock 엔티티 유형의 지오코드 결과가 반환될 수 있습니다.
Low	낮음

신뢰도가 로 설정된 High경우 하나 이상의 강력한 일치 항목이 발견되었습니다. 다중 신뢰도 일치는 High 해당되는 경우 중요도에 따라 순위가 매겨진 순서로 정렬됩니다. 예를 들어 랜드마크는 중요하지만 주소는 중요하지 않습니다.

요청에 위치 또는 보기가 포함된 경우 순위가 적절하게 변경될 수 있습니다. 예를 들어 "Paris"에 대한 위치 쿼리는 "Paris, France" 및 "Paris, TX"를 모두 신뢰할 수 있게 High 반환합니다. "프랑스 파리"는 사용자 위치가 사용자가 텍사스 주 파리에 있거나 매우 가깝다는 것을 나타내거나 지도 보기에서 사용자가 해당 지역에서 검색하고 있음을 나타내지 않는 한 중요도로 인해 항상 첫 번째 순위가 됩니다.

Medium

경우에 따라 반환된 일치 항목이 요청에 제공된 정보와 동일한 수준이 아닐 수 있습니다. 예를 들어 요청은 주소 정보를 지정할 수 있으며 지오코드 서비스는 우편번호와만 일치할 수 있습니다. 이 경우 지오코드 서비스가 우편 번호가 데이터와 일치한다는 신뢰도를 가지고 있는 경우 신뢰도는 로 Medium 설정되고 일치 코드는 로 UpHierarchy 설정되어 모든 정보와 일치할 수 없으며 상위 계층을 검색해야 함을 지정합니다.

쿼리의 위치 정보가 모호하고 위치의 순위를 매기는 추가 정보(예: 사용자 위치 또는 위치의 상대적 중요도)가 없는 경우 신뢰도는 로 설정 Medium됩니다. 예를 들어 "148th Ave, Bellevue"에 대한 위치 쿼리는 "148th Ave SE" 및 "148th Ave NE"를 모두 신뢰할 수 있게 Medium 반환할 수 있습니다.

쿼리의 위치 정보가 특정 위치를 지오코딩하기에 충분한 정보를 제공하지 않는 경우 덜 정확한 위치 값이 반환될 수 있으며 신뢰도는 로 설정 Medium됩니다. 예를 들어 주소가 제공되었지만 집 번호와 일치하는 항목을 찾을 수 없는 경우 Roadblock 엔티티 유형의 지오코드 결과가 반환될 수 있습니다.

Low

낮음

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

FeatureCollectionEnum

열거형

GeoJSON 형식을 지정합니다. 지원되는 유일한 개체 형식은 FeatureCollection. 자세한 내용은 RFC 7946참조하세요.

값	Description
FeatureCollection	`GeoJSON` `FeatureCollection` 개체 형식을 지정합니다.

FeaturesItem

Object

특징 오브젝트입니다.

Name	형식	Description
bbox	number[] (double)	경계 상자. 사용된 프로젝션 - EPSG:3857. 자세한 내용은 RFC 7946 참조하세요.
geometry	GeoJsonPoint	유효한 `GeoJSON Point` 기하 도형 형식입니다. 자세한 내용은 RFC 7946 참조하세요.
id	string	반환된 기능에 대한 ID
properties	FeaturesItemProperties	특징의 특성.
type	FeatureTypeEnum	기능 유형은 기능이어야 합니다.

FeaturesItemProperties

Object

특징의 특성.

Name	형식	Description
address	Address	결과의 주소입니다.
confidence	ConfidenceEnum	지오코딩된 위치 결과가 일치하는 신뢰도 수준입니다. 일치 코드와 함께 이 값을 사용하여 일치 항목에 대한 자세한 정보를 확인합니다. 지오코딩된 위치의 신뢰도는 지정된 경우 지오코딩된 위치 및 사용자의 위치의 상대적 중요도를 비롯한 여러 요인을 기반으로 합니다.
geocodePoints	GeocodePointsItem[]	계산 방법과 제안된 용도가 다른 지오코드 지점의 컬렉션입니다.
matchCodes	MatchCodesEnum[]	응답의 각 위치에 대한 지오코딩 수준을 나타내는 하나 이상의 일치 코드 값입니다. 예를 들어 `Good` 및 `Ambiguous` 일치 코드가 있는 지오코딩된 위치는 위치 정보에 대해 둘 이상의 지오코드 위치를 찾았으며 지오코드 서비스에 일치 항목을 찾기 위한 검색 업 계층 구조가 없음을 의미합니다. 마찬가지로, `Ambiguous` 및 `UpHierarchy` 일치 코드가 있는 지오코딩된 위치는 제공된 모든 위치 정보와 일치하는 지오코드 위치를 찾을 수 없음을 의미하므로 지오코드 서비스는 업 계층 구조를 검색하고 해당 수준에서 여러 일치 항목을 발견해야 했습니다. `Ambiguous` 및 `UpHierarchy` 결과의 예는 전체 주소 정보를 제공하지만 지오코드 서비스에서 도로 주소에 대한 일치 항목을 찾을 수 없고 대신 둘 이상의 RoadBlock 값에 대한 정보를 반환하는 경우입니다. 가능한 값은 다음과 같습니다. `Good`: 위치에 일치하는 항목이 하나만 있거나 반환된 모든 일치 항목이 강력한 일치 항목으로 간주됩니다. 예를 들어 뉴욕 쿼리는 몇 가지 좋은 일치 항목을 반환합니다. `Ambiguous`: 위치는 가능한 일치 항목 집합 중 하나입니다. 예를 들어 거리 주소 128 Main St.를 쿼리할 때 선택할 옵션을 결정하는 데 충분한 정보가 없기 때문에 응답은 128 North Main St. 및 128 South Main St.에 대한 두 위치를 반환할 수 있습니다. `UpHierarchy`: 위치는 지리적 계층 구조 위로의 이동을 나타냅니다. 이는 위치 요청에 대한 일치 항목을 찾을 수 없으므로 덜 정확한 결과가 반환될 때 발생합니다. 예를 들어 요청된 주소에 대한 일치 항목을 찾을 수 없는 경우 RoadBlock 엔터티 형식이 있는 `UpHierarchy` 일치 코드가 반환될 수 있습니다.
type	string	중 하나: * 주소 * 도로 차단 * 도로 교차로 * 동네 * 인구 거주지 * 우편번호1 * 행정구역1 * 행정구역2 * 국가지역

FeatureTypeEnum

열거형

기능 유형은 기능이어야 합니다.

값	Description
Feature	`GeoJSON` Feature 개체 형식을 지정합니다.

GeocodePointsItem

Object

지오코드 포인트.

Name	형식	Description
calculationMethod	CalculationMethodEnum	지오코드 지점을 계산하는 데 사용된 메서드입니다.
geometry	GeoJsonPoint	유효한 `GeoJSON Point` 기하 도형 형식입니다. 자세한 내용은 RFC 7946 참조하세요.
usageTypes	UsageTypeEnum[]	지오코드 지점에 가장 적합합니다. 각 지오코드 지점은 `Route` 지점, `Display` 지점 또는 둘 다로 정의됩니다. 위치에 대한 경로를 만드는 경우 `Route` 지점을 사용합니다. 지도에 위치를 표시하는 경우 `Display` 지점을 사용합니다. 예를 들어 위치가 공원인 경우 `Route` 지점은 자동차로 들어갈 수 있는 공원 입구를 지정할 수 있으며, `Display` 지점은 공원의 중심을 지정하는 지점일 수 있습니다.

GeocodingBatchRequestBody

Object

처리할 주소 지오코딩 쿼리/요청 목록입니다. 목록에는 최대 100개의 쿼리가 포함될 수 있으며 1개 이상의 쿼리가 포함되어야 합니다.

Name	형식	Description
batchItems	GeocodingBatchRequestItem[]	처리할 쿼리 목록입니다.

GeocodingBatchRequestItem

Object

Batch 쿼리 개체

Name	형식	Default value	Description
addressLine	string		지역 또는 우편 코드 속성에 지정된 지역을 기준으로 주소의 공식 거리 선입니다. 이 요소의 일반적인 사용은 거리 주소 또는 공식 주소를 제공하는 것입니다. 이 매개 변수는 매개 변수가 `query` 요청에 포함될 때 사용해서는 안 됩니다.
adminDistrict	string		주소의 국가 세분화 부분(예: WA). 이 매개 변수는 매개 변수가 `query` 요청에 포함될 때 사용해서는 안 됩니다.
adminDistrict2	string		구조화된 주소의 카운티(예: King). 이 매개 변수는 매개 변수가 `query` 요청에 포함될 때 사용해서는 안 됩니다.
adminDistrict3	string		구조화된 주소의 명명된 영역입니다. 이 매개 변수는 매개 변수가 `query` 요청에 포함될 때 사용해서는 안 됩니다.
bbox	number[] (double)		경계 상자 개체로 정의된 지구의 사각형 영역입니다. 사각형의 변은 경도 및 위도 값으로 정의됩니다. 자세한 내용은 위치 및 영역 유형을 참조하십시오. 이 매개 변수를 지정하면 위치 쿼리 결과를 계산할 때 지리적 영역이 고려됩니다. 예: [lon1, lat1, lon2, lat2]
coordinates	number[] (double)		경도와 위도로 지정된 지구상의 점입니다. 이 매개 변수를 지정하면 사용자의 위치가 고려되고 반환된 결과가 사용자와 더 관련성이 높을 수 있습니다. 예: [경도, 위도]
countryRegion	string		지오코딩 결과에 대한 신호는 지정된 ISO 3166-1 Alpha-2 지역/국가 코드 (예: FR)에 대한 신호입니다. 이 매개 변수는 매개 변수가 `query` 요청에 포함될 때 사용해서는 안 됩니다.
locality	string		주소의 지역 부분(예: 시애틀)입니다. 이 매개 변수는 매개 변수가 `query` 요청에 포함될 때 사용해서는 안 됩니다.
optionalId	string		해당 batchItem에 표시되는 요청의 ID
postalCode	string		주소의 우편 번호 부분입니다. 이 매개 변수는 매개 변수가 `query` 요청에 포함될 때 사용해서는 안 됩니다.
query	string		주소 또는 랜드마크 이름과 같은 위치에 대한 정보가 포함된 문자열입니다.
top	integer (int32) minimum: 1 maximum: 20	5	반환될 최대 응답 수입니다. 기본값: 5, 최소: 1 및 최대: 20.
view	string	auto	ISO 3166-1 Alpha-2 지역/국가 코드지정하는 문자열입니다. 이렇게 하면 지정학적으로 분쟁이 있는 테두리 및 레이블이 지정된 사용자 지역에 맞게 변경됩니다.

GeocodingBatchResponse

Object

이 개체는 성공적인 Geocoding Batch 서비스 호출에서 반환됩니다.

Name	형식	Description
batchItems	GeocodingBatchResponseItem[]	일괄 처리 결과를 포함하는 배열입니다.
nextLink	string	반환된 기능의 다음 페이지에 대한 링크입니다. 마지막 페이지인 경우 이 필드가 없습니다.
summary	GeocodingBatchResponseSummary	일괄 처리 요청에 대한 요약

GeocodingBatchResponseItem

Object

배치 응답 항목입니다.

Name	형식	Description
error	ErrorDetail	오류 세부 정보입니다.
features	FeaturesItem[]	쿼리에서 반환된 다양한 특징들이 있었습니다.
nextLink	string	반환된 기능의 다음 페이지에 대한 링크입니다. 마지막 페이지인 경우 이 필드가 없습니다.
optionalId	string	요청의 ID와 동일한 batchItem의 ID
type	FeatureCollectionEnum	`GeoJSON` 형식을 지정합니다. 지원되는 유일한 개체 형식은 `FeatureCollection`. 자세한 내용은 RFC 7946참조하세요.

GeocodingBatchResponseSummary

Object

일괄 처리 요청에 대한 요약

Name	형식	Description
successfulRequests	integer (int32)	일괄 처리에서 성공한 요청 수
totalRequests	integer (int32)	일괄 처리의 총 요청 수

GeoJsonObjectType

열거형

GeoJSON 형식을 지정합니다. Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, FeatureCollection 등 유효한 9가지 GeoJSON 개체 형식 중 하나여야 합니다.

값	Description
Point	`GeoJSON Point` 기하 도형입니다.
MultiPoint	`GeoJSON MultiPoint` 기하 도형입니다.
LineString	`GeoJSON LineString` 기하 도형입니다.
MultiLineString	`GeoJSON MultiLineString` 기하 도형입니다.
Polygon	`GeoJSON Polygon` 기하 도형입니다.
MultiPolygon	`GeoJSON MultiPolygon` 기하 도형입니다.
GeometryCollection	`GeoJSON GeometryCollection` 기하 도형입니다.
Feature	`GeoJSON Feature` 개체
FeatureCollection	`GeoJSON FeatureCollection` 개체

GeoJsonPoint

Object

유효한 GeoJSON Point 기하 도형 형식입니다. 자세한 내용은 RFC 7946 참조하세요.

Name	형식	Description
bbox	number[] (double)	경계 상자. 사용된 프로젝션 - EPSG:3857. 자세한 내용은 RFC 7946 참조하세요.
coordinates	number[] (double)	`Position` 두 개 이상의 요소가 있는 숫자 배열입니다. 처음 두 요소는 경도 및 위도순서대로 정확하게 표시됩니다. 고도/상승 선택적 세 번째 요소입니다. 자세한 내용은 RFC 7946 참조하세요.
type	string: Point	`GeoJSON` 형식을 지정합니다. Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, FeatureCollection 등 유효한 9가지 GeoJSON 개체 형식 중 하나여야 합니다.

Intersection

Object

결과의 주소입니다.

Name	형식	Description
baseStreet	string	위치의 기본 거리입니다.
displayName	string	교집합의 전체 이름입니다.
intersectionType	string	교집합의 유형입니다.
secondaryStreet1	string	첫 번째 교차 거리입니다.
secondaryStreet2	string	있는 경우 두 번째 교차 거리입니다.

MatchCodesEnum

열거형

매치 코드를 나타내는 열거 항목입니다.

값	Description
Good	좋음
Ambiguous	모호함
UpHierarchy	상위 계층 구조

UsageTypeEnum

열거형

사용 유형을 나타내는 열거형입니다.

값	Description
Display	표시
Route	경로