Method: resolveNames

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

Richiesta HTTP

POST https://mapstools.googleapis.com/v1:resolveNames

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
Campi
queries[]

object (LocationQuery)

Obbligatorio. Un elenco di query sulla posizione da risolvere. Puoi specificare fino a 20 query.
locationBias

object (LocationBias)

Facoltativo. Una regione facoltativa per influenzare i risultati della risoluzione. Se specificato, i risultati della risoluzione saranno orientati verso le entità più vicine a questa regione. L'inclusione di locationBias o regionCode spesso fornisce risultati migliori restringendo lo spazio di ricerca.

Se vengono specificati sia locationBias sia regionCode, locationBias ha la precedenza su regionCode.
regionCode

string

Facoltativo. Un codice regione facoltativo per influenzare i risultati della risoluzione. Se specificato, i risultati della risoluzione saranno orientati verso le entità che si trovano all'interno o nelle vicinanze della regione specificata. Deve essere un codice regione CLDR. Ad esempio, "US" o "CA". L'inclusione di locationBias o regionCode spesso fornisce risultati migliori restringendo lo spazio di ricerca.

Se vengono specificati sia locationBias sia regionCode, locationBias ha la precedenza su regionCode.

Corpo della risposta

Messaggio di risposta per v1.resolveNames.

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

Rappresentazione JSON 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  },
  "saveToMapsUrl": string
}
Campi
results[]

object (Result)

Solo output. L'elenco delle entità risolte dalle query sulla posizione. Garantito per la mappatura 1:1 con gli indici della richiesta queries. Una stringa vuota all'indice i indica che la risoluzione non è riuscita per quella query. Se la risoluzione non è riuscita, controlla il campo failedRequests per lo stato dell'errore.
failedRequests

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

Solo output. Una mappa che comunica errori parziali. La chiave è l'indice della richiesta non riuscita nel campo queries. 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" }.
saveToMapsUrl

string

Solo output. Un link per salvare tutte le entità risolte correttamente in Google Maps.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

LocationQuery

Una query sulla posizione rappresenta un'entità di posizione specifica che può essere risolta con Google Maps. Al momento, come query di località sono supportati solo nomi e indirizzi di luoghi.

Rappresentazione JSON 
{
  "text": string
}
Campi
text

string

Obbligatorio. La query di testo da risolvere in una specifica entità geospaziale su Google Maps, ad esempio un luogo o un indirizzo. Più specifica è la query, più accurata è la risoluzione. Ad esempio, "San Francisco", "Googleplex, Mountain View, CA", "1600 Amphitheatre Parkway, Mountain View, CA" o "Torre Eiffel, Parigi". Le query devono essere un indirizzo o il nome di un luogo specifico. Le località generiche come il nome di una catena (ad es. Starbucks) o una query di ricerca come "ristoranti" non sono supportate.

LocationBias

La regione a cui orientare i risultati della risoluzione.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "viewport": {
    object (Viewport)
  }
  // End of mutually exclusive fields.
}
Campi
Il tipo di aggiustamento della località. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
viewport

object (Viewport)

Un'area visibile definita da un riquadro di delimitazione.
Fine dei campi che si escludono a vicenda.

Risultato

Una singola entità risolta da una determinata query sulla posizione, insieme al livello di confidenza della risoluzione.

Rappresentazione JSON 
{
  "entity": {
    object (Entity)
  },
  "confidence": enum (Confidence)
}
Campi
entity

object (Entity)

Solo output. L'entità risolta dalla query sulla posizione.
confidence

enum (Confidence)

Solo output. Il livello di confidenza per la risoluzione.

Confidenza

Il livello di confidenza per la risoluzione.

Enum
CONFIDENCE_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
MEDIUM Una confidenza media indica che la risoluzione è probabilmente corretta, ma potrebbero esserci altri candidati.
HIGH Un'attendibilità elevata indica che la risoluzione è corretta e rappresenta un'entità geospaziale specifica (ad es. un luogo specifico).