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 지도에서 장소나 주소와 같은 특정 지리 공간 항목으로 확인되는 텍스트 쿼리입니다. 질문이 구체적일수록 더 정확한 해결 방법을 얻을 수 있습니다. 예를 들어 '샌프란시스코', 'Googleplex, Mountain View, CA', '1600 Amphitheatre Parkway, Mountain View, CA', '에펠탑, 파리'와 같이 입력합니다. 질문은 구체적인 주소 또는 장소 이름이어야 합니다. 체인 이름 (예: 스타벅스) 또는 '레스토랑'과 같은 검색어와 같은 일반적인 위치는 지원되지 않습니다.

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 신뢰도가 높으면 해상도가 올바르고 특정 지리 공간 항목 (예: 특정 장소)을 나타냅니다.