Method: resolveMapsUrls

Menyelesaikan daftar URL Google Maps ke entitas geospasial tertentu (misalnya, tempat) di Google Maps.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "urls": [
    string
  ]
}
Kolom
urls[]

string

Wajib. URL Google Maps yang akan diselesaikan. Setiap URL harus berupa URL Google Maps yang valid, misalnya, https://maps.app.goo.gl/..., https://www.google.com/maps/place/..., atau https://maps.google.com/.... Saat ini, hanya URL yang mengarah ke satu tempat yang didukung. Anda dapat menentukan hingga 20 URL.

Isi respons

Pesan respons untuk v1alpha.resolveMapsUrls.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
Kolom
entities[]

object (Entity)

Hanya output. Daftar entitas yang telah diselesaikan dari URL Google Maps. Dijamin dipetakan 1:1 dengan indeks urls permintaan. Pesan kosong pada indeks i (jika tidak ada entity yang ditetapkan) menunjukkan bahwa resolusi gagal untuk URL tersebut. Jika resolusi gagal, periksa kolom failedRequests untuk mengetahui status error.
failedRequests

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

Hanya output. Peta yang mengomunikasikan kegagalan sebagian untuk URL Google Maps. Kuncinya adalah indeks permintaan yang gagal di kolom urls. Nilainya adalah status error yang menjelaskan alasan kegagalan resolusi.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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