Package google.maps.geocode.v4beta

Indice

GeocodeService

Un servizio per eseguire la geocodifica.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

Questo metodo esegue una geocodifica dell'indirizzo, che mappa un indirizzo a un LatLng. Fornisce anche informazioni strutturate sull'indirizzo.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
GeocodeLocation

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

Questo metodo esegue una geocodifica della posizione, che mappa un LatLng a un indirizzo. Fornisce anche informazioni strutturate sull'indirizzo.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
GeocodePlace

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

Questo metodo esegue una ricerca di geocodifica utilizzando un ID luogo.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.place

GeocodeAddressRequest

Messaggio di richiesta per GeocodeService.GeocodeAddress.

Campi
location_bias

GeocodeAddressRequest.LocationBias

(Facoltativo) La regione in cui eseguire la ricerca. Questa posizione funge da bias, il che significa che potrebbero essere restituiti risultati relativi alla posizione specificata.

language_code

string

(Facoltativo) La lingua in cui devono essere restituiti i risultati.

region_code

string

(Facoltativo) Codice regione. Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Il parametro influisce sui risultati in base alla legge vigente. Questo parametro influenzerà anche, ma non limiterà completamente, i risultati del servizio.

Campo unione address_input. L'indirizzo da geocodificare. address_input può essere solo uno dei seguenti:
address_query

string

L'indirizzo non strutturato da geocodificare.

address

PostalAddress

L'indirizzo strutturato da geocodificare nel formato dell'indirizzo postale.

LocationBias

La regione in cui eseguire la ricerca. Questa posizione funge da bias, il che significa che potrebbero essere restituiti risultati relativi alla posizione specificata.

Campi
Campo unione type. Tipi di distorsione della località. type può essere solo uno dei seguenti:
rectangle

Viewport

Un riquadro rettangolare definito dall'angolo nord-est e sud-ovest. rectangle.high() deve essere il punto nord-est del riquadro visibile del rettangolo. rectangle.low() deve essere il punto sud-ovest del rettangolo della finestra. rectangle.low().latitude() non può essere maggiore di rectangle.high().latitude(). Verrà generato un intervallo di latitudine vuoto. Un riquadro rettangolare non può essere più ampio di 180 gradi.

GeocodeAddressResponse

Messaggio di risposta per GeocodeService.GeocodeAddress.

Campi
results[]

GeocodeResult

Il risultato della geocodifica.

GeocodeLocationRequest

Messaggio di richiesta per GeocodeService.GeocodeLocation.

Campi
language_code

string

(Facoltativo) La lingua in cui devono essere restituiti i risultati.

region_code

string

(Facoltativo) Codice regione. Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Il parametro influisce sui risultati in base alla legge vigente.

types[]

string

(Facoltativo) Un insieme di tag di tipo per limitare i risultati. I risultati che non hanno nessuno dei tipi specificati vengono rimossi.

Per l'elenco completo dei valori possibili, consulta la tabella A e la tabella B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types.

granularity[]

GeocodeResult.Granularity

(Facoltativo) Un filtro di una o più enumerazioni di granularità della posizione.

Campo unione location_input. La posizione da geocodificare. location_input può essere solo uno dei seguenti:
location_query

string

La posizione nel formato della stringa "lat,lng". Ad esempio, "64.7611872,-18.4705364".

location

LatLng

La posizione nel formato strutturato.

GeocodeLocationResponse

Messaggio di risposta per GeocodeService.GeocodeLocation.

Campi
results[]

GeocodeResult

Il risultato della geocodifica.

plus_code

PlusCode

Plus Code della località nella richiesta.

GeocodePlaceRequest

Messaggio di richiesta per GeocodeService.GeocodePlace.

Campi
place

string

Obbligatorio. Identificatore del luogo da geocodificare nel formato places/{place}.

language_code

string

(Facoltativo) La lingua in cui devono essere restituiti i risultati.

region_code

string

(Facoltativo) Codice regione. Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Il parametro influisce sui risultati in base alla legge vigente.

GeocodeResult

Un risultato di geocodifica contiene informazioni geografiche su un luogo.

Campi
place

string

L'identificatore del luogo completo per questo risultato. Nel formato "//places.googleapis.com/places/{placeID}". Per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/place-id.

place_id

string

L'ID luogo per questo risultato.

location

LatLng

Le coordinate lat/lng di questo indirizzo.

granularity

GeocodeResult.Granularity

La granularità della posizione.

viewport

Viewport

Una finestra adatta alla visualizzazione del risultato del geocodifica.

bounds

Viewport

Un riquadro di delimitazione per l'indirizzo.

formatted_address

string

L'indirizzo formattato su una riga.

postal_address

PostalAddress

L'indirizzo nel formato dell'indirizzo postale.

address_components[]

GeocodeResult.AddressComponent

Componenti ripetuti per ogni livello di località.

postal_code_localities[]

LocalizedText

Elenco completo delle località contenute nel codice postale.

Questo campo viene compilato solo quando il risultato è di tipo "postal_code".

types[]

string

Un insieme di tag di tipo per questo risultato. Ad esempio, "political" e "administrative_area".

Per l'elenco completo dei valori possibili, consulta la tabella A e la tabella B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types.

plus_code

PlusCode

Plus Code della posizione in questo geocodice.

AddressComponent

I componenti strutturati che formano l'indirizzo formattato, se queste informazioni sono disponibili.

Campi
long_text

string

La descrizione o il nome completo del componente dell'indirizzo. Ad esempio, un componente dell'indirizzo per il paese Australia potrebbe avere il nome lungo "Australia".

short_text

string

Un nome testuale abbreviato per il componente dell'indirizzo, se disponibile. Ad esempio, un componente dell'indirizzo per il paese Australia potrebbe avere il nome breve "AU".

types[]

string

Un array che indica il tipo o i tipi di componente dell'indirizzo.

Per maggiori dettagli, consulta la pagina https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types.

language_code

string

La lingua utilizzata per formattare questi componenti, nella notazione CLDR.

Granularità

La granularità della posizione.

Enum
GRANULARITY_UNSPECIFIED Non utilizzare.
ROOFTOP La posizione non interpolata di un appezzamento di terreno effettivo corrispondente all'indirizzo trovato.
RANGE_INTERPOLATED Interpolato da un intervallo di numeri civici. Ad esempio, se sappiamo che un segmento di Amphitheatre Pkwy contiene i numeri 1600-1699, il numero 1650 potrebbe essere posizionato a metà strada tra i suoi punti estremi.
GEOMETRIC_CENTER Il centro geometrico di una funzionalità per cui disponiamo di dati poligonali.
APPROXIMATE Tutto il resto.

PlusCode

Il Plus Code (http://plus.codes) è un riferimento di posizione con due formati: codice globale che definisce un rettangolo di 14 m x 14 m (1/8000 di grado) o più piccolo e codice composto, che sostituisce il prefisso con una posizione di riferimento.

Campi
global_code

string

Il codice globale (completo) del luogo, ad esempio "9FWM33GV+HQ ", che rappresenta un'area di 1/8000 di grado per 1/8000 di grado (~14 x 14 metri).

compound_code

string

Il codice composto del luogo, ad esempio "33GV+HQ, Ramberg, Norvegia ", contenente il suffisso del codice globale e che sostituisce il prefisso con il nome formattato di un'entità di riferimento.