Method: resolveMapsUrls

Google 지도 URL 목록을 Google 지도의 특정 지리 공간 엔티티 (예: 장소)로 확인합니다.

HTTP 요청

POST https://mapstools.googleapis.com/v1alpha:resolveMapsUrls

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

요청 본문

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

JSON 표현 
{
  "urls": [
    string
  ]
}
필드
urls[]

string

필수 항목입니다. 해결할 Google 지도 URL입니다. 각 URL은 유효한 Google 지도 URL이어야 합니다(예: https://maps.app.goo.gl/..., https://www.google.com/maps/place/..., https://maps.google.com/...). 현재는 단일 장소를 가리키는 URL만 지원됩니다. URL을 최대 20개까지 지정할 수 있습니다.

응답 본문

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

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

JSON 표현 
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
필드
entities[]

object (Entity)

출력 전용입니다. Google 지도 URL에서 확인된 항목 목록입니다. 요청 urls 색인과 1:1로 매핑됩니다. i (entity이 설정되지 않은 경우)의 빈 메시지는 해당 URL의 확인이 실패했음을 나타냅니다. 해결이 실패한 경우 failedRequests 필드에서 오류 상태를 확인하세요.
failedRequests

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

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

"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