Method: resolveMapsUrls

Risolve un elenco di URL di Google Maps in entità geospaziali specifiche (ad es. luoghi) su Google Maps.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "urls": [
    string
  ]
}
Campi
urls[]

string

Obbligatorio. Gli URL di Google Maps da risolvere. Ogni URL deve essere un URL di Google Maps valido, ad esempio https://maps.app.goo.gl/..., https://www.google.com/maps/place/... o https://maps.google.com/.... Al momento sono supportati solo gli URL che rimandano a un singolo luogo. Puoi specificare fino a 20 URL.

Corpo della risposta

Messaggio di risposta per v1alpha.resolveMapsUrls.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

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

object (Entity)

Solo output. L'elenco delle entità risolte dagli URL di Google Maps. È garantito il mapping 1:1 con gli indici urls della richiesta. Un messaggio vuoto all'indice i (dove non è impostata alcuna entity) indica che la risoluzione non è riuscita per quell'URL. Se la risoluzione non è riuscita, controlla il campo failedRequests per lo stato di errore.
failedRequests

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

Solo output. Una mappa che comunica errori parziali per gli URL di Google Maps. La chiave è l'indice della richiesta non riuscita nel campo urls. Il valore è lo stato di errore che indica il motivo per cui la risoluzione non è riuscita.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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