MCP Tools Reference: mapstools.googleapis.com

도구: resolve_maps_urls

Google 지도 URL 목록을 표준 Google 지도 장소 ID로 변환합니다.

이 도구를 호출해야 하는 경우 (중요):

  • 사용자가 하나 이상의 Google 지도 공유 링크 또는 URL (예: 'https://maps.app.goo.gl/...', 'https://www.google.com/maps/place/...' 또는 'https://maps.google.com/...')에서 기본 표준 장소 ID를 추출해야 합니다.
  • 단일 일괄 요청에서 최대 20개의 URL을 지정하여 확인할 수 있습니다.

입력 요구사항 (중요):

  • urls (문자열 배열 - 필수): 확인할 Google 지도 URL 목록입니다. 각 URL은 유효한 단일 장소 Google 지도 URL이어야 합니다.

오류 처리 (심각):

  • 일괄 처리 도구입니다. 요청에서 '혼합된 결과' (예: 일부 URL은 성공적으로 확인되지만 다른 URL은 실패함)가 반환될 수 있습니다.
  • entities의 출력 목록은 입력 urls 색인과 1:1로 매핑됩니다. URL 확인이 실패하면 entities 목록의 해당 색인에 빈 Entity 메시지 (필드가 설정되지 않음)가 표시됩니다.
  • 응답에서 failed_requests 맵 필드를 확인하여 실패한 특정 URL 색인을 식별해야 합니다(MUST). failed_requests의 키는 요청에서 실패한 URL의 0 기반 색인을 나타냅니다. 부분적인 실패로 인해 전체 일괄 호출이 실패했다고 가정하지 마세요.

다음 샘플에서는 curl를 사용하여 resolve_maps_urls MCP 도구를 호출하는 방법을 보여줍니다.

curl 요청 
                  
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "resolve_maps_urls",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

ResolveMapsUrls 요청 메시지입니다.

ResolveMapsUrlsRequest

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개까지 지정할 수 있습니다.

출력 스키마

ResolveMapsUrls의 응답 메시지입니다.

ResolveMapsUrlsResponse

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

object (Entity)

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

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

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

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

항목

JSON 표현 
{

  // Union field entity can be only one of the following:
  "place": string
  // End of list of possible types for union field entity.
}
필드
통합 필드 entity. 확인된 항목 유형입니다. entity은 다음 중 하나여야 합니다.
place

string

확인된 장소의 리소스 이름입니다.

FailedRequestsEntry

JSON 표현 
{
  "key": integer,
  "value": {
    object (Status)
  }
}
필드
key

integer
value

object (Status)

상태

JSON 표현 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
필드
code

integer

상태 코드로, google.rpc.Code의 열거형 값이어야 합니다.
message

string

개발자에게 정보를 제공하는 오류 메시지로, 영어로 작성되어야 합니다. 사용자에게 표시되는 모든 오류 메시지는 현지화되어 google.rpc.Status.details 필드에 전송되거나, 클라이언트 측에서 현지화되어야 합니다.
details[]

object

오류 세부정보를 설명하는 메시지 목록입니다. API에서 사용할 일반적인 메시지 유형 집합이 있습니다.

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" }

모두

JSON 표현 
{
  "typeUrl": string,
  "value": string
}
필드
typeUrl

string

슬래시로 끝나는 접두사와 정규화된 유형 이름으로 구성된 URI 참조를 사용하여 직렬화된 Protobuf 메시지의 유형을 식별합니다.

예: type.googleapis.com/google.protobuf.StringValue

이 문자열에는 / 문자가 하나 이상 포함되어야 하며, 마지막 / 뒤의 콘텐츠는 선행 점이 없는 표준 형식의 유형의 정규화된 이름이어야 합니다. 클라이언트가 연락을 시도하지 않도록 이러한 URI 참조에 스킴을 작성하지 마세요.

접두사는 임의적이며 Protobuf 구현은 유형을 식별하기 위해 마지막 /까지 포함한 모든 항목을 삭제해야 합니다. type.googleapis.com/은 일부 기존 구현에 필요한 일반적인 기본 접두사입니다. 이 접두사는 유형의 출처를 나타내지 않으며 이를 포함하는 URI는 요청에 응답하지 않습니다.

모든 유형 URL 문자열은 참조의 콘텐츠가 영숫자, 퍼센트 인코딩된 이스케이프, 다음 집합의 문자(외부 백틱 제외)로만 구성되어야 한다는 추가 제한이 있는 합법적인 URI 참조여야 합니다. /-.~_!$&()*+,;= 퍼센트 인코딩이 허용되지만 기존 파서와의 혼동을 방지하기 위해 구현에서는 이를 이스케이프 해제해서는 안 됩니다. 예를 들어 type.googleapis.com%2FFoo은 거부되어야 합니다.

Any의 원래 설계에서는 이러한 유형 URL에서 유형 확인 서비스를 실행할 가능성이 고려되었지만 Protobuf는 이를 구현하지 않았으며 이러한 URL에 연결하는 것을 문제이자 잠재적인 보안 문제로 간주합니다. 연락처 유형 URL을 시도하지 마세요.
value

string (bytes format)

type_url로 설명된 유형의 Protobuf 직렬화를 보유합니다.

base64 인코딩 문자열입니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ❌ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌