Method: resolveMapsUrls

Google マップの URL のリストを、Google マップ上の特定の地理空間エンティティ（場所など）に解決します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

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