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/v1alpha: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 orientare 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 che 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 che regionCode, locationBias ha la precedenza su regionCode.

Corpo della risposta

Messaggio di risposta per v1alpha.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)
    },
    ...
  }
}
Campi
results[]

object (Result)

Solo output. L'elenco delle entità risolte dalle query sulla posizione. Garantito per mappare 1:1 con gli indici queries della richiesta. 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" }.

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

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 di luoghi e indirizzi.

Rappresentazione JSON 
{
  "text": string
}
Campi
text

string

Obbligatorio. La query di testo da risolvere in un'entità geospaziale specifica su Google Maps, ad esempio un luogo o un indirizzo. Più specifica è la query, più precisa sarà 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 specifici. 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 indirizzare i risultati della risoluzione.

Rappresentazione JSON 
{

  // Union field type can be only one of the following:
  "viewport": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
Campi
Campo unione type. Il tipo di aggiustamento della località. type può essere solo uno dei seguenti tipi:
viewport

object (Viewport)

Un viewport definito da un riquadro di delimitazione.

Area visibile

Un'area visibile di latitudine e longitudine, rappresentata da due punti low e high diagonalmente opposti. Un viewport è considerato una regione chiusa, ovvero include il suo confine. I limiti di latitudine devono essere compresi tra -90 e 90 gradi inclusi, mentre i limiti di longitudine devono essere compresi tra -180 e 180 gradi inclusi. Ecco alcuni casi:

  • Se low = high, l'area visibile è costituita da un unico punto.

  • Se low.longitude > high.longitude, l'intervallo di longitudine è invertito (l'area visibile attraversa la linea di longitudine di 180 gradi).

  • Se low.longitude = -180 gradi e high.longitude = 180 gradi, l'area visibile include tutte le longitudini.

  • Se low.longitude = 180 gradi e high.longitude = -180 gradi, l'intervallo di longitudine è vuoto.

  • Se low.latitude > high.latitude, l'intervallo di latitudine è vuoto.

Sia low che high devono essere compilati e la casella rappresentata non può essere vuota (come specificato dalle definizioni precedenti). Un'area visibile vuota genererà un errore.

Ad esempio, questa finestra completamente racchiude New York City:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Rappresentazione JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Campi
low

object (LatLng)

Obbligatorio. Il punto più basso del viewport.
high

object (LatLng)

Obbligatorio. Il punto più alto dell'area visibile.

LatLng

Un oggetto che rappresenta una coppia di coordinate di latitudine e longitudine. Questi valori sono espressi come una coppia di numeri double per rappresentare i gradi di latitudine e longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono rientrare negli intervalli normalizzati.

Rappresentazione JSON 
{
  "latitude": number,
  "longitude": number
}
Campi
latitude

number

La latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0].
longitude

number

La longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0].

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'alta confidenza indica che la risoluzione è corretta e rappresenta un'entità geospaziale specifica (ad es. un luogo specifico).