Package google.maps.geocode.v4alpha

Index

• DestinationService (interface)
• GeocodeService (interface)
• Destination (message)
• Destination.ArrivalSummary (message)
• Destination.ParkingOptions (message)
• Destination.ParkingOptions.Availability (enum)
• Destination.ParkingOptions.ParkingFacility (message)
• Entrance (message)
• Entrance.Tag (enum)
• GeocodeAddressRequest (message)
• GeocodeAddressRequest.LocationBias (message)
• GeocodeAddressResponse (message)
• GeocodeLocationRequest (message)
• GeocodeLocationResponse (message)
• GeocodePlaceRequest (message)
• GeocodeResult (message)
• GeocodeResult.AddressComponent (message)
• GeocodeResult.Granularity (enum)
• ImageAnnotation (message)
• ImageAnnotation.Coordinate (message)
• Landmark (message)
• Landmark.Tag (enum)
• NavigationPoint (message)
• NavigationPoint.TravelMode (enum)
• NavigationPoint.Usage (enum)
• PlaceView (message)
• PlaceView.AddressComponent (message)
• PlaceView.StructureType (enum)
• PlusCode (message)
• SearchDestinationsRequest (message)
• SearchDestinationsRequest.AddressQuery (message)
• SearchDestinationsRequest.LocationQuery (message)
• SearchDestinationsRequest.LocationQuery.PlaceFilter (message)
• SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability (enum)
• SearchDestinationsResponse (message)
• StreetViewThumbnail (message)

DestinationService

Service permettant de récupérer des destinations.

Une destination fournit un contexte hiérarchique sur un lieu, ce qui vous permet, par exemple, de trouver des immeubles d'habitation dans un complexe d'appartements plus grand, et inversement. Il fournit également des points de navigation adaptés à des cas d'utilisation tels que le covoiturage ou la livraison.

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse) Cette méthode effectue une recherche de destination et renvoie une liste de destinations. 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.destinations

GeocodeService

Service permettant d'effectuer un géocodage.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse) Cette méthode effectue un géocodage 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éocode à 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

Destination

Une destination. Cela inclut le lieu principal, les lieux associés, les entrées et les points de navigation.

Champs
primary	PlaceView Le lieu principal identifié par le primary_query dans la requête.
containing_places[]	PlaceView Lieux moins précis dans lesquels se trouve le lieu principal. Par exemple, la résidence d'appartements qui contient ce bâtiment.
sub_destinations[]	PlaceView Sous-destinations plus précises du lieu principal. Par exemple, les unités contenues dans un bâtiment. Remarque : Par rapport à l'objet SubDestination renvoyé par l'API Places, cette liste de sous-destinations est plus exhaustive, et chaque sous-destination contient plus d'informations.
landmarks[]	Landmark Points de repère permettant d'indiquer où se trouve la destination ou d'aider à l'arrivée.
entrances[]	Entrance Entrées pour cette destination.
navigation_points[]	NavigationPoint Points de navigation pour cette destination.
parking_options	Destination.ParkingOptions Options de stationnement pour cette destination.
arrival_summary	Destination.ArrivalSummary Résumé généré par IA de l'expérience d'arrivée à destination.

ArrivalSummary

Résumé généré par IA de l'expérience d'arrivée à destination.

Champs
text	LocalizedText Résumé de l'expérience d'arrivée à destination.
flag_content_url	string Un lien permettant aux utilisateurs de signaler un problème avec le résumé.
disclosure_text	LocalizedText Uniquement en sortie. Contient le texte de divulgation du récapitulatif d'arrivée.

ParkingOptions

Informations sur les options de stationnement pour la destination.

Champs
availability	Destination.ParkingOptions.Availability Disponibilité d'un parking pour cette destination.
parking_facilities[]	Destination.ParkingOptions.ParkingFacility Les parkings de cette destination.
onsite_parking	bool Un parking sur place est disponible à destination.
free_parking_lot	bool Propose des parkings sans frais.
paid_parking_lot	bool Propose des parkings payants.
free_street_parking	bool Parking gratuit dans la rue.
paid_street_parking	bool Propose un parking payant dans la rue.
valet_parking	bool Propose un service de voiturier.
free_garage_parking	bool Le parking couvert est sans frais.
paid_garage_parking	bool Propose un parking couvert payant.

Disponibilité

Mesure agrégée de la difficulté à trouver une place de stationnement lorsque vous visitez ce lieu.

De nouvelles valeurs pourront être ajoutées à l'avenir.

Enums
AVAILABILITY_UNSPECIFIED	La disponibilité des places de parking n'est pas disponible.
PLENTY	Il est facile de se garer.
SOMEWHAT_DIFFICULT	Il est plutôt difficile de trouver une place de parking.
DIFFICULT	Il est très difficile de trouver une place de parking.

ParkingFacility

Une option de stationnement individuelle et distincte (par exemple, un parking couvert ou un parking spécifique) associée à la destination. Il fournit des informations détaillées sur un parking spécifique, tandis que le message ParkingOptions parent fournit un résumé agrégé de tous les parkings disponibles.

Champs
place	PlaceView Représentation du lieu de ce parking spécifique.
onsite	bool Indique si ce parking est situé sur le site de la destination principale. Si ce champ n'est pas défini, l'état sur site est inconnu.
popular	bool Indique si ce parking est un choix populaire pour les visiteurs se rendant à la destination principale. Si ce champ n'est pas défini, l'état de popularité est inconnu.
straight_line_distance_meters	double Distance en ligne droite (en mètres) entre la destination principale et ce parking.

Entrée

Une entrée est une paire de coordonnées de latitude/longitude unique qui définit l'emplacement d'un point d'entrée et de sortie pour un lieu.

Champs
display_name	LocalizedText Nom lisible par l'humain, par exemple "Porte B", "Entrée sud", "Entrée 5e avenue".
location	LatLng Emplacement de l'entrée.
tags[]	Entrance.Tag Liste de tags décrivant l'entrée.
place	string Structure sur laquelle cette entrée est physiquement située, au format places/{place_id}.
street_view_thumbnail	StreetViewThumbnail Vignette Street View montrant l'entrée. L'image peut être demandée à l'API Street View Static. Consultez https://developers.google.com/maps/documentation/streetview/request-streetview.
street_view_annotation	ImageAnnotation Annotation de l'entrée sur le street_view_thumbnail renvoyé ci-dessus.

Tag

Caractéristiques décrivant une entrée.

Enums
TAG_UNSPECIFIED	Non utilisé.
PREFERRED	L'entrée fournit probablement un accès physique au lieu principal de la destination renvoyée. Un lieu peut avoir plusieurs entrées préférées. Si une entrée ne comporte pas ce tag, cela signifie qu'elle se trouve physiquement dans le même bâtiment que le lieu principal, mais qu'elle ne permet pas nécessairement d'accéder à ce lieu. Par exemple, si le lieu principal est un restaurant dans un centre commercial, les entrées "PREFERRED" seront celles qui mènent probablement au restaurant lui-même, tandis que les autres entrées renvoyées seront d'autres entrées du bâtiment, comme les entrées d'autres restaurants du centre commercial. Si le lieu principal est un bâtiment, les entrées PREFERRED seront celles qui mènent à la partie "principale" du bâtiment. Par exemple, dans un centre commercial, les entrées PREFERRED seront celles qui permettent d'accéder au hall principal. En revanche, une entrée qui ne permet d'accéder qu'à un magasin situé sur le côté du bâtiment ne sera pas une entrée PREFERRED. Remarque : Une entrée PREFERRED peut ne pas donner accès au lieu principal, et une entrée non PREFERRED peut donner accès au lieu principal.

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 pondération, ce qui signifie que les résultats situés à proximité de l'emplacement indiqué sont privilégiés.
language_code	string Facultatif. Langue dans laquelle les résultats doivent être renvoyés.
region_code	string Facultatif. Code régional. Code régional, spécifié sous la forme d'une valeur ccTLD (domaine de premier niveau) à deux caractères. Le paramètre affecte les résultats en fonction de la législation applicable. Ce paramètre influencera également 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 d'adresse postale.

LocationBias

Région dans laquelle effectuer la recherche. Cet emplacement sert de pondération, ce qui signifie que les résultats situés à proximité de l'emplacement indiqué sont privilégiés.

Champs
Champ d'union type. Types de biais de localisation. type ne peut être qu'un des éléments suivants :
rectangle	Viewport Zone 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 rectangulaire. rectangle.low() doit être le point sud-ouest de la fenêtre d'affichage rectangulaire. rectangle.low().latitude() ne peut pas être supérieur à rectangle.high().latitude(). Cela entraînera une plage de latitudes vide. Une fenêtre d'affichage rectangulaire ne peut pas dépasser 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 régional. Code régional, spécifié sous la forme d'une valeur ccTLD (domaine de premier niveau) à deux caractères. Le paramètre affecte les résultats en fonction de la législation 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 de plusieurs énumérations de précision de la zone géographique.
Champ d'union location_input. L'emplacement à géocoder. location_input ne peut être qu'un des éléments suivants :
location_query	string Emplacement au format de chaîne "lat,lng". Par exemple, "64.7611872,-18.4705364".
location	LatLng Lieu 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 dans la requête.

GeocodePlaceRequest

Message de requête pour GeocodeService.GeocodePlace.

Champs
place	string Obligatoire. Identifiant du 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 régional. Code régional, spécifié sous la forme d'une valeur ccTLD (domaine de premier niveau) à deux caractères. Le paramètre affecte les résultats en fonction de la législation applicable.

GeocodeResult

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

Champs
place	string Nom de la ressource de ce lieu, au format places/{placeId}. Peut être utilisé pour rechercher le lieu.
place_id	string Identifiant unique d'un lieu.
location	LatLng Coordonnées de cette adresse.
granularity	GeocodeResult.Granularity Précision de l'emplacement.
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 L'adresse au format d'adresse postale.
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 formatée, 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 l'Australie peut avoir "Australie" comme nom complet.
short_text	string Nom textuel abrégé pour le 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. Ces valeurs sont extraites du tableau des types d'adresses et de composants d'adresse utilisé par l'API Places : https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code	string Langue utilisée pour formater ce composant, en notation CLDR.

Précision

Précision de l'emplacement.

Enums
GRANULARITY_UNSPECIFIED	Ne pas utiliser.
ROOFTOP	Emplacement non interpolé d'une parcelle de terrain réelle correspondant à l'adresse mise en correspondance.
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 extrémités.
GEOMETRIC_CENTER	Centre géométrique d'un élément pour lequel nous disposons de données polygonales.
APPROXIMATE	Tout le reste.

ImageAnnotation

Annotation sur la miniature d'une image, par exemple un polygone délimitant une entrée.

Champs
coordinates[]	ImageAnnotation.Coordinate Liste de coordonnées formant un polygone sur l'image. Les coordonnées sont classées dans le sens inverse des aiguilles d'une montre.

Coordonnée

Coordonnée en pixels d'un point sur l'image. L'origine (0,0) est l'angle supérieur gauche du pixel supérieur gauche de l'image, l'axe des abscisses pointant vers la droite et l'axe des ordonnées vers le bas.

Champs
x_px	float Coordonnées X.
y_px	float Coordonnées Y.

Point de repère

Les points de repère permettent d'indiquer où se trouve la destination ou d'aider à l'atteindre.

Champs
relational_description	LocalizedText Description lisible par l'humain de la relation entre la destination et le point de repère. Par exemple : "Près de l'Empire State Building" ou "En face de la Maison-Blanche".
tags[]	Landmark.Tag Tags décrivant comment le point de repère peut être utilisé dans le contexte de la destination.
straight_line_distance_meters	double Uniquement en sortie. Distance en ligne droite entre ce repère et la destination, en mètres.
travel_distance_meters	double Uniquement en sortie. Distance à pied entre ce point de repère et la destination, en mètres.
Champ d'union landmark. Le repère. landmark ne peut être qu'un des éléments suivants :
place	PlaceView Lieu qui représente ce point de repère.

Tag

Liste de tous les tags possibles décrivant comment un repère peut être utilisé dans le contexte d'une destination.

Si une adresse comporte à la fois les tags ADDRESS et ARRIVAL, cela signifie que le point de repère est à la fois important localement et proche de la destination.

Enums
TAG_UNSPECIFIED	Non utilisé.
ADDRESS	Lieu connu localement qui peut être utilisé pour identifier la position générale de la destination. En général, à quelques centaines de mètres de la destination. Ils sont semblables aux repères renvoyés par la fonctionnalité de descripteurs d'adresse de l'API Geocoding : https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL	Lieu pouvant être utilisé pour aider à arriver à destination. Utile pour la navigation une fois que vous êtes proche de la destination. Par exemple, il peut s'agir d'un lieu situé de l'autre côté de la rue par rapport à la destination. Un point de repère associé à ce tag est généralement plus proche de la destination que les points de repère associés au tag ADDRESS.

NavigationPoint

Un point de navigation est un emplacement situé à côté d'une route où la navigation peut se terminer.

Champs
navigation_point_token	string Uniquement en sortie. Jeton permettant d'identifier ce point de navigation.
display_name	LocalizedText Nom à afficher de ce point de navigation. Par exemple, "5th Ave" ou "Porte B".
location	LatLng Un point à côté du segment de route où la navigation doit se terminer. Le point est intentionnellement légèrement décalé par rapport à l'axe de la route pour indiquer clairement de quel côté de la route se trouve le lieu.
travel_modes[]	NavigationPoint.TravelMode Modes de transport adaptés à ce point de navigation.
usages[]	NavigationPoint.Usage Répertorie les usages compatibles avec ce point de navigation. Si ce champ est vide, cela ne signifie pas nécessairement que son utilisation est limitée d'une manière ou d'une autre. Tous les points de navigation peuvent être utilisés pour la navigation générale.
street_view_thumbnail	StreetViewThumbnail Vignette Street View montrant le point de navigation, si disponible. L'image peut être demandée à l'API Street View Static. Consultez https://developers.google.com/maps/documentation/streetview/request-streetview.
entrance_annotation	ImageAnnotation Annotation de l'entrée associée à ce point de navigation sur le street_view_thumbnail renvoyé ci-dessus, si disponible.
altitude_meters	float Altitude du point de navigation en mètres par rapport à l'ellipsoïde WGS-84.

TravelMode

Modes de transport adaptés à ce point de navigation.

Enums
TRAVEL_MODE_UNSPECIFIED	Non utilisé.
DRIVE	Adapté à la conduite.
WALK	Adapté à la marche.

Utilisation

Utilisations acceptées par ce point de navigation. De nouvelles valeurs pourront être ajoutées à l'avenir.

Enums
USAGE_UNSPECIFIED	Non utilisé.
UNKNOWN	Indique que le type d'utilisation est inconnu.
DROPOFF	Adapté pour déposer un passager. Par exemple, un lieu de dépose pour un covoiturage.
PICKUP	Convient pour récupérer un passager. Par exemple, un lieu de prise en charge pour un covoiturage.
PARKING	Adapté au stationnement. Par exemple, dans un parking.

PlaceView

Représente une vue d'un lieu dans l'API Places. Il fournit également des informations supplémentaires spécifiques aux destinations, telles que le type de structure et le polygone d'affichage.

Dans certains cas, un PlaceView avec le même ID de lieu peut différer de ce qui est renvoyé par l'API Places pour les champs types et display_name.

Champs
place	string Nom de la ressource de ce lieu, au format places/{placeId}. Peut être utilisé pour rechercher le lieu.
place_id	string Identifiant unique d'un lieu.
display_name	LocalizedText Description du lieu lisible par l'humain. Par exemple, "Porte B", "McDonald's"
primary_type	string Type de lieu principal de ce lieu. Consultez https://developers.google.com/maps/documentation/places/web-service/place-types pour obtenir la liste des valeurs possibles. Remarque : Ce champ n'est pas toujours renseigné. Dans ce cas, préparez-vous à utiliser le champ types.
types[]	string Tous les types de lieux associés à ce lieu. Consultez https://developers.google.com/maps/documentation/places/web-service/place-types pour obtenir la liste des valeurs possibles.
formatted_address	string Adresse sur une seule ligne.
postal_address	PostalAddress Adresse structurée.
structure_type	PlaceView.StructureType Type de structure correspondant à ce lieu.
location	LatLng L'emplacement de ce lieu. Pour les lieux avec des polygones d'affichage, cela peut représenter un bon endroit pour placer un repère sur la carte.
display_polygon	Struct Contour polygonal du lieu au format GeoJSON, en utilisant le format RFC 7946 : https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6. Remarque : Le format RFC 7946 est compatible avec les MultiPolygons. Un objet display_polygon peut donc représenter plusieurs polygones.
address_components[]	PlaceView.AddressComponent Composants répétés pour chaque niveau de localité.

AddressComponent

Composants structurés qui forment l'adresse formatée, 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 l'Australie peut avoir "Australie" comme nom complet.
short_text	string Nom textuel abrégé pour le 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. Ces valeurs sont extraites du tableau des types d'adresses et de composants d'adresse utilisé par l'API Places : https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code	string Langue utilisée pour formater ce composant, en notation CLDR.

StructureType

Type de structure que ce lieu représente.

Enums
STRUCTURE_TYPE_UNSPECIFIED	Non utilisé.
POINT	Un point géographique.
SECTION	Sous-section d'un bâtiment.
BUILDING	Un bâtiment.
GROUNDS	Une grande zone qui contient généralement plusieurs bâtiments, comme un campus universitaire, un complexe d'appartements ou un centre commercial.

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/8 000e de degré) ou plus petit, et un code composé, qui remplace le préfixe par un lieu de référence.

Champs
global_code	string Code global (complet) du lieu, par exemple "9FWM33GV+HQ", représentant une zone de 1/8 000 par 1/8 000 de degré (environ 14 mètres par 14 mètres).
compound_code	string Code composé du lieu, par exemple "33GV+HQ, Ramberg, Norvège ", contenant le suffixe du code global et remplaçant le préfixe par un nom formaté d'une entité de référence.

SearchDestinationsRequest

Message de requête pour DestinationService.SearchDestinations.

Champs
travel_modes[]	NavigationPoint.TravelMode Facultatif. Modes de transport pour lesquels filtrer les points de navigation. Cela a une incidence sur le champ navigation_points renvoyé dans la réponse. Si ce champ est vide, les points de navigation de tous les modes de transport sont renvoyés.
language_code	string Facultatif. Langue dans laquelle les résultats doivent être renvoyés.
region_code	string Facultatif. Code régional. Code régional, spécifié sous la forme d'une valeur ccTLD (domaine de premier niveau) à deux caractères. Le paramètre affecte les résultats en fonction de la législation applicable. Ce paramètre influence également les résultats du service, mais ne les limite pas complètement.
Champ d'union primary_query. Requête pour la destination principale. Il peut s'agir d'un lieu, d'une adresse complète ou d'un emplacement LatLng. Certains lieux et adresses ne pourront pas être transformés en destination, car les informations les concernant sont insuffisantes. Les destinations sont créées autour de la requête primaire spécifiée. Remarque : Seuls les lieux et les adresses pouvant avoir une destination de navigation sont acceptés. Par exemple, un lieu représentant une maison ou un complexe d'appartements peut être utilisé comme requête principale, mais pas les lieux représentant une localité ou une région administrative. primary_query ne peut être qu'un des éléments suivants :
place	string Nom de ressource d'un lieu, au format places/{place_id}.
address_query	SearchDestinationsRequest.AddressQuery Adresse postale.
location_query	SearchDestinationsRequest.LocationQuery Une position exacte.

AddressQuery

Adresse postale que vous souhaitez rechercher. Lorsque vous spécifiez les adresses, respectez le format utilisé par les services postaux nationaux du pays concerné.

Champs
Champ d'union kind. Requête d'adresse. kind ne peut être qu'un des éléments suivants :
address	PostalAddress Une adresse postale au format d'adresse postale.
address_query	string Adresse postale mise en forme sur une seule ligne.

LocationQuery

Une requête de localisation pour identifier une destination principale à proximité.

Remarque : Si la requête de localisation se trouve dans un bâtiment contenant des sous-locaux, il est possible que le lieu principal renvoyé soit un sous-local. Dans ce cas, le champ containing_places inclut le bâtiment.

Champs
place_filter	SearchDestinationsRequest.LocationQuery.PlaceFilter Facultatif. Filtres à appliquer aux destinations candidates.
Champ d'union kind. La requête de localisation. kind ne peut être qu'un des éléments suivants :
location	LatLng Emplacement LatLng précis.

PlaceFilter

Filtres à appliquer aux candidats de destination.

Champs
structure_type	PlaceView.StructureType Facultatif. Si cette option est spécifiée, toutes les destinations sont garanties d'avoir un lieu principal avec ce type de structure. Cela peut entraîner le filtrage de certaines destinations, ou l'élargissement/l'affinement des destinations renvoyées. Par exemple, si GROUNDS est spécifié, toutes les destinations renvoyées auront un lieu principal avec le type de structure GROUNDS. Cela peut entraîner le filtrage de certaines destinations qui ne font pas partie d'un terrain, ou l'approximation des destinations renvoyées au niveau du terrain. Ce champ permet également d'extraire plus facilement les polygones d'affichage des bâtiments. Par exemple, si BUILDING est spécifié, le polygone d'affichage du lieu principal correspondra au bâtiment situé à l'emplacement spécifié.
addressability	SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability Facultatif. Si cette option est spécifiée, seules les destinations qui répondent aux critères d'adressabilité correspondants sont renvoyées.

Adressabilité

Définit les options de filtrage de l'adressabilité. De nouvelles valeurs pourront être ajoutées à l'avenir.

Enums
ADDRESSABILITY_UNSPECIFIED	Si aucune valeur n'est spécifiée, le service choisit une valeur par défaut appropriée.
ANY	L'adressabilité n'est pas un critère de filtrage. Les destinations sont renvoyées, qu'elles soient adressables ou non.
PRIMARY	Toutes les destinations renvoyées auront un lieu principal avec une adresse ou un nom au niveau de la rue.
WEAK	Toutes les destinations renvoyées auront un lieu principal ou une sous-destination avec une adresse ou un nom au niveau de la rue.

SearchDestinationsResponse

Message de réponse pour DestinationService.SearchDestinations.

Champs
destinations[]	Destination Liste de destinations. Le service renvoie un résultat si une destination principale peut être identifiée sans ambiguïté à partir de la requête principale. Sinon, le service peut renvoyer plusieurs résultats pour la désambiguïsation ou aucun résultat.

StreetViewThumbnail

Paramètres permettant de représenter une miniature Google Street View. Ces paramètres peuvent être utilisés pour demander une image Street View à l'API Street View Static. Consultez https://developers.google.com/maps/documentation/streetview/request-streetview.

Champs
pano	string Un ID de panorama spécifique.
width_px	int32 Largeur de l'image miniature de sortie en pixels. Remarque : Lorsque vous demandez des annotations en plus de la miniature, vous devez utiliser ces valeurs de hauteur et de largeur dans la requête API Street View pour vous assurer que les coordonnées des annotations sont correctement alignées avec l'image.
height_px	int32 Hauteur de l'image miniature de sortie en pixels. Remarque : Lorsque vous demandez des annotations en plus de la miniature, vous devez utiliser ces valeurs de hauteur et de largeur dans la requête API Street View pour vous assurer que les coordonnées des annotations sont correctement alignées avec l'image.
heading_degree	float Orientation horizontale de la caméra en degrés. Plage [0, 360). 0 indique le nord et 90 indique l'est.
pitch_degree	float Orientation verticale de la caméra en degrés. Plage [-90, 90]. 0 correspond à l'horizon, +90 à la verticale vers le haut et -90 à la verticale vers le bas.
fov_degree	float Champ de vision horizontal en degrés. Plage (0, 180]. Contrôle le niveau de zoom. Plus le champ de vision est petit, plus le zoom est important.