Method: resolveNames

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

HTTP 요청

POST https://mapstools.googleapis.com/v1alpha: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보다 우선 적용됩니다.

응답 본문

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

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

JSON 표현 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
필드
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" }

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

LocationQuery

위치 쿼리는 Google 지도로 확인할 수 있는 특정 위치 엔티티를 나타냅니다. 현재는 장소 이름과 주소만 위치 쿼리로 지원됩니다.

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

string

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

LocationBias

확인 결과를 편향시킬 지역입니다.

JSON 표현 
{

  // Union field type can be only one of the following:
  "viewport": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
필드
통합 필드 type. 위치 편향의 유형입니다. type은 다음 중 하나여야 합니다.
viewport

object (Viewport)

경계 상자로 정의된 표시 영역입니다.

표시 영역

대각선으로 반대되는 두 개의 low 및 high 포인트로 표현되는 위도-경도 뷰포트입니다. 표시 영역은 닫힌 영역으로 간주됩니다. 즉, 경계가 포함됩니다. 위도 범위는 -90~90도(포함)여야 하고 경도 범위는 -180~180도(포함)여야 합니다. 다양한 사례는 다음과 같습니다.

  • low = high이면 표시 영역은 해당 단일 점으로 구성됩니다.

  • low.longitude > high.longitude인 경우 경도 범위가 반전됩니다 (표시 영역이 180도 경도선을 교차함).

  • low.longitude = -180도이고 high.longitude = 180도인 경우 뷰포트에 모든 경도가 포함됩니다.

  • low.longitude = 180도이고 high.longitude = -180도이면 경도 범위가 비어 있습니다.

  • low.latitude > high.latitude이면 위도 범위가 비어 있습니다.

low 및 high 모두 채워져야 하며, 표현된 상자는 비어 있을 수 없습니다 (위 정의에 명시됨). 뷰포트가 비어 있으면 오류가 발생합니다.

예를 들어 다음 뷰포트는 뉴욕시를 완전히 둘러쌉니다.

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON 표현 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
필드
low

object (LatLng)

필수 항목입니다. 표시 영역의 하단입니다.
high

object (LatLng)

필수 항목입니다. 표시 영역의 최고점입니다.

LatLng

위도/경도 쌍을 나타내는 객체로 위도와 경도를 나타내는 복식 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.

JSON 표현 
{
  "latitude": number,
  "longitude": number
}
필드
latitude

number

위도입니다. 범위는 [-90.0, +90.0]입니다.
longitude

number

경도입니다. 범위는 [-180.0, +180.0]입니다.

결과

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

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

object (Entity)

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

enum (Confidence)

출력 전용입니다. 해결 방법의 신뢰도 수준입니다.

신뢰도

해결 방법의 신뢰도 수준입니다.

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