Package google.maps.geocode.v4beta

Index

GeocodeService

Service permettant d'effectuer le géocodage.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

Cette méthode effectue un geocoding d'adresse, qui mappe une adresse à un LatLng. Il fournit également des informations structurées sur l'adresse.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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)

Cette méthode effectue un geocoding d'emplacement, qui mappe un LatLng à une adresse. Il fournit également des informations structurées sur l'adresse.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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)

Cette méthode effectue une recherche de géocodage à l'aide d'un ID de lieu.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Message de requête pour GeocodeService.GeocodeAddress.

Champs
location_bias

GeocodeAddressRequest.LocationBias

Facultatif. Région dans laquelle effectuer la recherche. Cet emplacement sert de biais, ce qui signifie que des résultats autour de l'emplacement indiqué peuvent être renvoyés.

language_code

string

Facultatif. Langue dans laquelle les résultats doivent être renvoyés.

region_code

string

Facultatif. Code de région. Code régional, spécifié sous la forme d'une valeur ccTLD (TLD pour top-level domain, domaine de premier niveau) à deux caractères. Ce paramètre a une incidence sur les résultats en fonction de la loi applicable. Ce paramètre influera également sur les résultats du service, sans les limiter totalement.

Champ d'union address_input. Adresse à géocoder. address_input ne peut être qu'un des éléments suivants :
address_query

string

Adresse non structurée à géocoder.

address

PostalAddress

Adresse structurée à géocoder au format adresse postale.

LocationBias

Région dans laquelle effectuer la recherche. Cet emplacement sert de biais, ce qui signifie que des résultats autour de l'emplacement indiqué peuvent être renvoyés.

Champs
Champ d'union type. Types de biais de localisation. type ne peut être qu'un des éléments suivants :
rectangle

Viewport

Boîte rectangulaire définie par les angles nord-est et sud-ouest. rectangle.high() doit être le point nord-est de la fenêtre d'affichage du rectangle. rectangle.low() doit correspondre au point sud-ouest de la fenêtre d'affichage du rectangle. rectangle.low().latitude() ne peut pas être supérieur à rectangle.high().latitude(). Cela entraînera une plage de latitude vide. Un rectangle de fenêtre d'affichage ne peut pas avoir une largeur supérieure à 180 degrés.

GeocodeAddressResponse

Message de réponse pour GeocodeService.GeocodeAddress.

Champs
results[]

GeocodeResult

Résultat du geocoding.

GeocodeLocationRequest

Message de requête pour GeocodeService.GeocodeLocation.

Champs
language_code

string

Facultatif. Langue dans laquelle les résultats doivent être renvoyés.

region_code

string

Facultatif. Code de région. Code régional, spécifié sous la forme d'une valeur ccTLD (TLD pour top-level domain, domaine de premier niveau) à deux caractères. Ce paramètre a une incidence sur les résultats en fonction de la loi applicable.

types[]

string

Facultatif. Ensemble de tags de type permettant de limiter les résultats. Les résultats qui ne correspondent à aucun des types spécifiés sont supprimés.

Pour obtenir la liste complète des valeurs possibles, consultez les tableaux A et B sur la page https://developers.google.com/maps/documentation/places/web-service/place-types.

granularity[]

GeocodeResult.Granularity

Facultatif. Filtre d'une ou plusieurs énumérations de précision de localisation.

Champ d'union location_input. Emplacement à géocoder. location_input ne peut être qu'un des éléments suivants :
location_query

string

Emplacement au format "lat,lng". Par exemple, "64.7611872,-18.4705364".

location

LatLng

Emplacement au format structuré.

GeocodeLocationResponse

Message de réponse pour GeocodeService.GeocodeLocation.

Champs
results[]

GeocodeResult

Résultat du geocoding.

plus_code

PlusCode

Plus Code de l'emplacement indiqué dans la demande.

GeocodePlaceRequest

Message de requête pour GeocodeService.GeocodePlace.

Champs
place

string

Obligatoire. Identifiant de lieu à géocoder au format places/{place}.

language_code

string

Facultatif. Langue dans laquelle les résultats doivent être renvoyés.

region_code

string

Facultatif. Code de région. Code régional, spécifié sous la forme d'une valeur ccTLD (TLD pour top-level domain, domaine de premier niveau) à deux caractères. Ce paramètre a une incidence sur les résultats en fonction de la loi applicable.

GeocodeResult

Un résultat de géocodage contient des informations géographiques sur un lieu.

Champs
place

string

Identifiant complet du lieu pour ce résultat. Au format "//places.googleapis.com/places/{placeID}". Pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/place-id.

place_id

string

ID du lieu pour ce résultat.

location

LatLng

Latlng de cette adresse.

granularity

GeocodeResult.Granularity

Précision de la position.

viewport

Viewport

Fenêtre d'affichage adaptée à l'affichage du résultat du géocodage.

bounds

Viewport

Cadre de délimitation de l'adresse.

formatted_address

string

Adresse mise en forme sur une seule ligne.

postal_address

PostalAddress

Adresse au format postal.

address_components[]

GeocodeResult.AddressComponent

Composants répétés pour chaque niveau de localité.

postal_code_localities[]

LocalizedText

Liste complète des localités contenues dans le code postal.

Ce champ n'est renseigné que lorsque le résultat est de type "postal_code".

types[]

string

Ensemble de tags de type pour ce résultat. Par exemple, "political" et "administrative_area".

Pour obtenir la liste complète des valeurs possibles, consultez les tableaux A et B sur la page https://developers.google.com/maps/documentation/places/web-service/place-types.

plus_code

PlusCode

Plus Code de l'emplacement dans ce géocode.

AddressComponent

Composants structurés qui forment l'adresse mise en forme, si ces informations sont disponibles.

Champs
long_text

string

Description complète ou nom du composant d'adresse. Par exemple, un composant d'adresse pour le pays Australie peut avoir le nom long "Australie".

short_text

string

Nom textuel abrégé du composant d'adresse, s'il est disponible. Par exemple, un composant d'adresse pour l'Australie peut avoir le nom court "AU".

types[]

string

Tableau indiquant le ou les types du composant d'adresse.

Pour en savoir plus, consultez https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types.

language_code

string

Langue utilisée pour mettre en forme ces composants, en notation CLDR.

Précision

Précision de la position.

Enums
GRANULARITY_UNSPECIFIED Ne pas utiliser.
ROOFTOP Emplacement non interpolé d'une parcelle de terrain réelle correspondant à l'adresse trouvée.
RANGE_INTERPOLATED Interpolé à partir d'une plage de numéros de rue. Par exemple, si nous savons qu'un segment d'Amphitheatre Pkwy contient les numéros 1600 à 1699, le numéro 1650 peut être placé à mi-chemin entre ses points de terminaison.
GEOMETRIC_CENTER Centre géométrique d'une entité pour laquelle nous disposons de données polygonales.
APPROXIMATE Tout le reste.

PlusCode

Un Plus Code (http://plus.codes) est une référence de lieu qui se présente sous deux formats : un code global définissant un rectangle de 14 m x 14 m (1/8000e de degré) ou plus petit, et un code composé, qui remplace le préfixe par une référence de lieu.

Champs
global_code

string

Code global (complet) du lieu, tel que "9FWM33GV+HQ", représentant une zone de 1/8000e de degré par 1/8000e de degré (environ 14 mètres sur 14 mètres).

compound_code

string

Code composé du lieu, tel que "33GV+HQ, Ramberg, Norvège ", contenant le suffixe du code global et remplaçant le préfixe par le nom mis en forme d'une entité de référence.