Method: resolveNames

장소 이름 (또는 주소) 목록을 Google 지도의 특정 지리 공간 항목 (예: 장소)으로 변환합니다.

HTTP 요청

POST https://mapstools.googleapis.com/v1:resolveNames

URL은 gRPC 트랜스코딩 문법을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
필드
queries[]

object (LocationQuery)

필수 항목입니다. 확인할 위치 쿼리 목록입니다. 최대 20개의 쿼리를 지정할 수 있습니다.
locationBias

object (LocationBias)

선택사항입니다. 확인 결과에 편향을 적용하는 선택적 리전입니다. 지정된 경우 확인 결과가 이 리전에 더 가까운 항목으로 편향됩니다. locationBias 또는 regionCode를 포함하면 검색 범위를 좁혀 더 나은 결과를 얻을 수 있습니다.

locationBias 및 regionCode가 모두 지정된 경우 locationBias가 regionCode보다 우선 적용됩니다.
regionCode

string

선택사항입니다. 확인 결과에 편향을 적용하는 선택적 지역 코드입니다. 지정된 경우 확인 결과는 지정된 리전 내에 있거나 그 근처에 있는 항목으로 편향됩니다. CLDR 리전 코드여야 합니다. 예를 들어 'US' 또는 'CA'입니다. locationBias 또는 regionCode를 포함하면 검색 범위를 좁혀 더 나은 결과를 얻을 수 있습니다.

locationBias 및 regionCode가 모두 지정된 경우 locationBias가 regionCode보다 우선 적용됩니다.

응답 본문

v1.resolveNames의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  },
  "saveToMapsUrl": string
}
필드
results[]

object (Result)

출력 전용입니다. 위치 쿼리에서 확인된 항목 목록입니다. 요청 queries 색인과 1:1로 매핑됩니다. 색인 i의 빈 문자열은 해당 쿼리의 확인이 실패했음을 나타냅니다. 해결이 실패한 경우 failedRequests 필드에서 오류 상태를 확인하세요.
failedRequests

map (key: integer, value: object (Status))

출력 전용입니다. 부분 실패를 전달하는 맵입니다. 키는 queries 필드에서 실패한 요청의 색인입니다. 값은 해결이 실패한 이유를 자세히 설명하는 오류 상태입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
saveToMapsUrl

string

출력 전용입니다. 성공적으로 확인된 모든 항목을 Google 지도에 저장하는 링크입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/maps-platform.mapstools

LocationQuery

위치 쿼리는 Google 지도로 확인할 수 있는 특정 위치 항목을 나타냅니다. 현재는 장소 이름과 주소만 위치 검색어로 지원됩니다.

JSON 표현 
{
  "text": string
}
필드
text

string

필수 항목입니다. Google 지도에서 장소 또는 주소와 같은 특정 지리 공간 항목으로 변환할 텍스트 쿼리입니다. 쿼리가 구체적일수록 해결 방법이 더 정확해집니다. 예를 들어 'San Francisco', 'Googleplex, Mountain View, CA', '1600 Amphitheatre Parkway, Mountain View, CA' 또는 'Eiffel Tower, Paris'입니다. 쿼리는 특정 주소 또는 장소 이름이어야 합니다. 체인 이름 (예: 스타벅스)과 같은 일반적인 위치나 '음식점'과 같은 검색어는 지원되지 않습니다.

LocationBias

확인 결과에 편향을 적용할 리전입니다.

JSON 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "viewport": {
    object (Viewport)
  }
  // End of mutually exclusive fields.
}
필드
위치 편향의 유형입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
viewport

object (Viewport)

경계 상자로 정의된 표시 영역입니다.
상호 배타적인 필드의 끝입니다.

결과

지정된 위치 쿼리에서 확인된 단일 항목과 확인의 신뢰도 수준입니다.

JSON 표현 
{
  "entity": {
    object (Entity)
  },
  "confidence": enum (Confidence)
}
필드
entity

object (Entity)

출력 전용입니다. 위치 쿼리에서 확인된 항목입니다.
confidence

enum (Confidence)

출력 전용입니다. 해결에 대한 신뢰 수준입니다.

신뢰도

해결에 대한 신뢰 수준입니다.

열거형
CONFIDENCE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
MEDIUM 중간 신뢰도는 해결 방법이 올바를 가능성이 높지만 다른 후보가 있을 수 있음을 나타냅니다.
HIGH 신뢰도가 높으면 확인이 정확하고 특정 지리 공간 항목 (예: 특정 장소)을 나타냅니다.