Package google.maps.places.v1

Index

• Places (interface)
• AuthorAttribution (message)
• AutocompletePlacesRequest (message)
• AutocompletePlacesRequest.LocationBias (message)
• AutocompletePlacesRequest.LocationRestriction (message)
• AutocompletePlacesResponse (message)
• AutocompletePlacesResponse.Suggestion (message)
• AutocompletePlacesResponse.Suggestion.FormattableText (message)
• AutocompletePlacesResponse.Suggestion.PlacePrediction (message)
• AutocompletePlacesResponse.Suggestion.QueryPrediction (message)
• AutocompletePlacesResponse.Suggestion.StringRange (message)
• AutocompletePlacesResponse.Suggestion.StructuredFormat (message)
• Circle (message)
• ContentBlock (message)
• ContextualContent (message)
• ContextualContent.Justification (message)
• ContextualContent.Justification.BusinessAvailabilityAttributesJustification (message)
• ContextualContent.Justification.ReviewJustification (message)
• ContextualContent.Justification.ReviewJustification.HighlightedText (message)
• ContextualContent.Justification.ReviewJustification.HighlightedText.HighlightedTextRange (message)
• EVChargeOptions (message)
• EVChargeOptions.ConnectorAggregation (message)
• EVConnectorType (enum)
• FuelOptions (message)
• FuelOptions.FuelPrice (message)
• FuelOptions.FuelPrice.FuelType (enum)
• GetPhotoMediaRequest (message)
• GetPlaceRequest (message)
• Photo (message)
• PhotoMedia (message)
• Place (message)
• Place.AccessibilityOptions (message)
• Place.AddressComponent (message)
• Place.AreaSummary (message)
• Place.Attribution (message)
• Place.BusinessStatus (enum)
• Place.GenerativeSummary (message)
• Place.OpeningHours (message)
• Place.OpeningHours.Period (message)
• Place.OpeningHours.Period.Point (message)
• Place.OpeningHours.SecondaryHoursType (enum)
• Place.OpeningHours.SpecialDay (message)
• Place.ParkingOptions (message)
• Place.PaymentOptions (message)
• Place.PlusCode (message)
• Place.SubDestination (message)
• PriceLevel (enum)
• References (message)
• Review (message)
• SearchNearbyRequest (message)
• SearchNearbyRequest.LocationRestriction (message)
• SearchNearbyRequest.RankPreference (enum)
• SearchNearbyResponse (message)
• SearchTextRequest (message)
• SearchTextRequest.EVOptions (message)
• SearchTextRequest.LocationBias (message)
• SearchTextRequest.LocationRestriction (message)
• SearchTextRequest.RankPreference (enum)
• SearchTextResponse (message)

Places

Définition de service pour l'API Places. Remarque: Chaque requête (à l'exception des requêtes Autocomplete) nécessite un masque de champ défini en dehors du fichier proto de la requête (all/* n'est pas supposé). Le masque de champ peut être défini via l'en-tête HTTP X-Goog-FieldMask. Consultez la page https://developers.google.com/maps/documentation/places/web-service/choose-fields.

AutocompletePlaces
rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse) Renvoie des prédictions pour l'entrée donnée.

GetPhotoMedia
rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia) Permet d'obtenir un contenu multimédia photo avec une chaîne de référence photo.

GetPlace
rpc GetPlace(GetPlaceRequest) returns (Place) Obtenez les détails d'un lieu en fonction de son nom de ressource, qui est une chaîne au format places/{place_id}.

SearchNearby
rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse) Recherchez des lieux à proximité de lieux.

SearchText
rpc SearchText(SearchTextRequest) returns (SearchTextResponse) Recherche de lieux basée sur une requête textuelle.

AuthorAttribution

Informations sur l'auteur des données du contenu généré par les utilisateurs. Utilisé dans Photo et Review.

Champs
display_name	string Nom de l'auteur du fichier Photo ou Review.
uri	string URI de l'auteur du fichier Photo ou Review.
photo_uri	string URI de la photo de profil de l'auteur de Photo ou Review.

AutocompletePlacesRequest

Demandez un proto pour AutocompletePlaces.

Champs
input	string Obligatoire. Chaîne de texte sur laquelle doit porter la recherche.
location_bias	LocationBias Facultatif. Limiter les résultats à un emplacement spécifié. Vous ne pouvez définir qu'un seul des éléments location_bias ou location_restriction. Si aucune de ces valeurs n'est définie, les résultats sont pondérés en fonction de l'adresse IP, ce qui signifie que l'adresse IP est mappée à un emplacement imprécis et utilisée comme signal de pondération.
location_restriction	LocationRestriction Facultatif. Limiter les résultats à un lieu spécifié. Vous ne pouvez définir qu'un seul des éléments location_bias ou location_restriction. Si aucune de ces valeurs n'est définie, les résultats sont pondérés en fonction de l'adresse IP, ce qui signifie que l'adresse IP est mappée à un emplacement imprécis et utilisée comme signal de pondération.
included_primary_types[]	string Facultatif. Type de lieu principal inclus (par exemple, "restaurant" ou "gas_station") de https://developers.google.com/maps/documentation/places/web-service/place-types. Un lieu n'est renvoyé que si son type principal est inclus dans cette liste. Vous pouvez spécifier jusqu'à cinq valeurs. Si aucun type n'est spécifié, tous les types de lieu sont renvoyés.
included_region_codes[]	string Facultatif. Incluez uniquement les résultats des régions spécifiées, sous la forme de 15 codes régionaux CLDR à deux caractères maximum. Un ensemble vide ne limitera pas les résultats. Si les champs location_restriction et included_region_codes sont tous les deux définis, les résultats sont situés dans la zone de l'intersection.
language_code	string Facultatif. Langue dans laquelle les résultats doivent être renvoyés. La valeur par défaut est "en-US". Les résultats peuvent s'afficher dans plusieurs langues si la langue utilisée dans input est différente de language_code ou si le lieu affiché n'a pas de traduction de la langue locale vers language_code.
region_code	string Facultatif. Code régional, spécifié sous forme de code CLDR à deux caractères. Cela affecte le format des adresses et le classement des résultats, et peut influencer les résultats renvoyés. Cela ne limite pas les résultats à la région spécifiée. Pour limiter les résultats à une région, utilisez region_code_restriction.
origin	LatLng Facultatif. Point de départ à partir duquel calculer la distance géodésique jusqu'à la destination (renvoyée en tant que distance_meters). Si cette valeur est omise, la distance géodésique n'est pas renvoyée.
input_offset	int32 Facultatif. Décalage de caractères Unicode basé sur zéro de input indiquant la position du curseur dans input. La position du curseur peut influencer les prédictions renvoyées. Si ce champ est vide, la valeur par défaut est la longueur de input.
include_query_predictions	bool Facultatif. Si la valeur est "true", la réponse inclura à la fois les prédictions de lieu et de requête. Sinon, la réponse ne renverra que des prédictions de lieu.
session_token	string Facultatif. Chaîne qui identifie une session de saisie semi-automatique à des fins de facturation. Il doit s'agir d'une chaîne en base64 avec nom de fichier et URL ne dépassant pas 36 caractères ASCII. Sinon, une erreur INVALID_ARGUMENT est renvoyée. La session commence lorsque l'utilisateur commence à saisir une requête et se termine lorsqu'il sélectionne un lieu et qu'un appel à Place Details ou à Address Validation est effectué. Chaque session peut comporter plusieurs requêtes, suivies d'une requête Place Details ou Address Validation. Les identifiants utilisés pour chaque requête au cours d'une session doivent appartenir au même projet de la console Google Cloud. Une fois la session terminée, le jeton n'est plus valide. Votre application doit générer un nouveau jeton pour chaque session. Si le paramètre session_token est omis ou si vous réutilisez un jeton de session, la session est facturée comme si aucun jeton n'était fourni (chaque requête est facturée séparément). Nous vous recommandons de respecter les consignes suivantes: Utilisez des jetons de session pour tous les appels Place Autocomplete. Générez un nouveau jeton pour chaque session. Nous vous recommandons d'utiliser un UUID version 4. Assurez-vous que les identifiants utilisés pour toutes les requêtes Place Autocomplete, Place Details et Address Validation au cours d'une session appartiennent au même projet de la console Cloud. N'oubliez pas de transmettre un jeton de session unique pour chaque nouvelle session. Si vous utilisez le même jeton pour plusieurs sessions, chaque requête est facturée individuellement.

LocationBias

Région dans laquelle effectuer la recherche. Les résultats peuvent être pondérés selon la région spécifiée.

Champs
Champ d'union type. type ne peut être qu'un des éléments suivants :
rectangle	Viewport Fenêtre d'affichage définie par un angle nord-est et sud-ouest
circle	Circle Cercle défini par un point central et un rayon.

LocationRestriction

Région dans laquelle effectuer la recherche. Les résultats sont limités à la région spécifiée.

Champs
Champ d'union type. type ne peut être qu'un des éléments suivants :
rectangle	Viewport Fenêtre d'affichage définie par un angle nord-est et sud-ouest
circle	Circle Cercle défini par un point central et un rayon.

AutocompletePlacesResponse

Proto de réponse pour AutocompletePlaces.

Champs
suggestions[]	Suggestion Contient une liste de suggestions, classées par ordre décroissant de pertinence.

Suggestion

Résultat de la suggestion de saisie semi-automatique.

Champs
Champ d'union kind. kind ne peut être qu'un des éléments suivants :
place_prediction	PlacePrediction Prédiction d'un lieu.
query_prediction	QueryPrediction Prédiction d'une requête.

FormattableText

Texte représentant une prédiction de lieu ou de requête. Le texte peut être utilisé tel quel ou mis en forme.

Champs
text	string Texte pouvant être utilisé tel quel ou mis en forme avec matches.
matches[]	StringRange Liste de plages de chaînes identifiant la correspondance entre la requête d'entrée et text. Les plages peuvent être utilisées pour mettre en forme des parties spécifiques de text. Les sous-chaînes peuvent ne pas être des correspondances exactes de input si la correspondance a été déterminée par des critères autres que la correspondance de chaîne (par exemple, des corrections orthographiques ou des translittérations). Ces valeurs sont des décalages de caractères Unicode de text. Les plages sont triées selon des valeurs de décalage croissantes.

PlacePrediction

Résultats d'une prédiction Place Autocomplete.

Champs
place	string Nom de ressource du lieu suggéré. Ce nom peut être utilisé dans d'autres API qui acceptent les noms de lieu.
place_id	string Identifiant unique du lieu suggéré. Cet identifiant peut être utilisé dans d'autres API qui acceptent les ID de lieu.
text	FormattableText Contient le nom lisible du résultat renvoyé. Pour les résultats d'établissements, il s'agit généralement du nom et de l'adresse de l'établissement. text est recommandé pour les développeurs qui souhaitent afficher un seul élément d'interface utilisateur. Les développeurs qui souhaitent afficher deux éléments d'interface utilisateur distincts, mais liés, peuvent utiliser structured_format à la place. Il existe deux façons différentes de représenter une prédiction de lieu. Les utilisateurs ne doivent pas essayer d'analyser structured_format dans text, ou inversement. Ce texte peut être différent du display_name renvoyé par GetPlace. Peut être dans plusieurs langues si les requêtes input et language_code sont dans des langues différentes ou si le lieu n'a pas de traduction de la langue locale vers language_code.
structured_format	StructuredFormat Décomposition de la prédiction de lieu sous la forme d'un texte principal contenant le nom du lieu et d'un texte secondaire contenant d'autres éléments permettant de faire la distinction (une ville ou une région, par exemple). structured_format est recommandé pour les développeurs qui souhaitent afficher deux éléments d'interface utilisateur distincts, mais liés. Les développeurs qui souhaitent afficher un seul élément d'interface utilisateur peuvent utiliser text à la place. Il existe deux façons différentes de représenter une prédiction de lieu. Les utilisateurs ne doivent pas essayer d'analyser structured_format dans text, ou inversement.
types[]	string Liste des types qui s'appliquent à ce lieu à partir du tableau A ou du tableau B dans le tableau https://developers.google.com/maps/documentation/places/web-service/place-types. Un type est une catégorisation d'un lieu. Les lieux partageant des types partagés partagent des caractéristiques similaires.
distance_meters	int32 Longueur de la géodésique en mètres à partir de origin si origin est spécifié. Il est possible que certaines prédictions (itinéraires, par exemple) ne soient pas renseignées dans ce champ.

QueryPrediction

Résultats d'une prédiction Query Autocomplete.

Champs
text	FormattableText Texte prédit. Ce texte ne représente pas un lieu, mais plutôt une requête textuelle pouvant être utilisée dans un point de terminaison de recherche (par exemple, Text Search). text est recommandé pour les développeurs qui souhaitent afficher un seul élément d'interface utilisateur. Les développeurs qui souhaitent afficher deux éléments d'interface utilisateur distincts, mais liés, peuvent utiliser structured_format à la place. Il existe deux façons différentes de représenter une prédiction de requête. Les utilisateurs ne doivent pas essayer d'analyser structured_format dans text, ou inversement. Peut être dans plusieurs langues si les requêtes input et language_code sont dans des langues différentes ou si une partie de la requête n'a pas de traduction de la langue locale vers la langue language_code.
structured_format	StructuredFormat Décomposition de la prédiction de requête sous la forme d'un texte principal contenant la requête et d'un texte secondaire contenant d'autres caractéristiques permettant de faire la distinction (une ville ou une région, par exemple). structured_format est recommandé pour les développeurs qui souhaitent afficher deux éléments d'interface utilisateur distincts, mais liés. Les développeurs qui souhaitent afficher un seul élément d'interface utilisateur peuvent utiliser text à la place. Il existe deux façons différentes de représenter une prédiction de requête. Les utilisateurs ne doivent pas essayer d'analyser structured_format dans text, ou inversement.

StringRange

Identifie une sous-chaîne dans un texte donné.

Champs
start_offset	int32 Décalage basé sur zéro du premier caractère Unicode de la chaîne (inclus).
end_offset	int32 Décalage basé sur zéro du dernier caractère Unicode (exclusif).

StructuredFormat

Contient une répartition des prédictions de lieu ou de requête en texte principal et texte secondaire.

Pour les prédictions de lieu, le texte principal contient le nom spécifique du lieu. Pour les prédictions de requête, le texte principal contient la requête.

Le texte secondaire contient d'autres éléments géographiques permettant de faire la distinction (comme une ville ou une région) permettant d'identifier plus précisément le lieu ou d'affiner la requête.

Champs
main_text	FormattableText Représente le nom du lieu ou de la requête.
secondary_text	FormattableText Représente d'autres éléments géographiques permettant de faire la distinction (comme une ville ou une région) permettant d'identifier plus précisément le lieu ou d'affiner la requête.

Entourer

Cercle avec LatLng comme centre et rayon

Champs
center	LatLng Obligatoire. Centrer la latitude et la longitude. La plage de latitude doit être comprise entre [-90,0 et 90,0]. La plage de longitude doit être comprise entre [-180,0 et 180,0].
radius	double Obligatoire. Rayon mesuré en mètres. Le rayon doit être compris entre [0,0 et 50 000,0].

ContentBlock

Bloc de contenu qui peut être diffusé individuellement.

Champs
topic	string Thème du contenu, par exemple "présentation" ou "restaurant".
content	LocalizedText Contenus liés au sujet.
references	References Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus. Références associées à ce bloc de contenu.

ContextualContent

Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus.

Contenu contextuel par rapport à la requête de lieu.

Champs
reviews[]	Review Liste d'avis sur ce lieu, consignés par rapport à la requête relative à ce lieu.
photos[]	Photo Informations (y compris des références) sur les photos de ce lieu, contenues dans la requête concernant le lieu.
justifications[]	Justification Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus. Justifications concernant le lieu.

Justification

Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus.

Justifications concernant le lieu. Les justifications répondent à la question de savoir pourquoi un lieu pourrait intéresser un utilisateur final.

Champs
Champ d'union justification. justification ne peut être qu'un des éléments suivants :
review_justification	ReviewJustification Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus.
business_availability_attributes_justification	BusinessAvailabilityAttributesJustification Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus.

BusinessAvailabilityAttributesJustification

Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus. Justifications de BusinessAvailabilityAttributes. Il présente certains attributs d'une entreprise qui pourraient intéresser un utilisateur final.

Champs
takeout	bool L'établissement propose des plats à emporter.
delivery	bool Si un établissement propose la livraison.
dine_in	bool Si un établissement propose des repas sur place.

ReviewJustification

Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus.

Justifications des avis d'utilisateurs. Cela met en évidence une section de l'avis de l'utilisateur qui pourrait l'intéresser. Par exemple, si la requête de recherche est "pizza au feu de bois", le texte correspondant à la requête de recherche est mis en surbrillance dans la justification.

Champs
highlighted_text	HighlightedText
review	Review Avis à partir duquel le texte en surbrillance est généré.

HighlightedText

Texte surligné par la justification. Il s'agit d'un sous-ensemble de l'avis lui-même. Le mot exact à mettre en surbrillance est marqué par HighlightedTextRange. Le texte mis en surbrillance peut contenir plusieurs mots.

Champs
text	string
highlighted_text_ranges[]	HighlightedTextRange Liste des plages du texte en surbrillance.

HighlightedTextRange

Plage du texte en surbrillance.

Champs
start_index	int32
end_index	int32

EVChargeOptions

Informations sur la borne de recharge de VE hébergée sur Place. La terminologie respecte https://afdc.energy.gov/fuels/electricity_infrastructure.html (un seul port peut recharger une voiture à la fois). Un port comporte un ou plusieurs connecteurs. Une station dispose d'un ou de plusieurs ports.

Champs
connector_count	int32 Nombre de connecteurs à cette station. Toutefois, certains ports peuvent avoir plusieurs connecteurs, mais ne peuvent charger qu'une voiture à la fois (par exemple, dans ce cas), le nombre de connecteurs peut être supérieur au nombre total de voitures pouvant être chargées simultanément.
connector_aggregation[]	ConnectorAggregation Liste d'agrégations de connecteurs de recharge de véhicules électriques contenant des connecteurs du même type et du même taux de recharge.

ConnectorAggregation

Informations sur la recharge de VE regroupées par [type, max_charge_rate_kw]. Affiche le regroupement de charges de VE pour les connecteurs de même type et ayant le même type de charge maximale en kW.

Champs
type	EVConnectorType Type de connecteur de cette agrégation.
max_charge_rate_kw	double Taux de recharge maximal statique en kW de chaque connecteur dans l'agrégation.
count	int32 Nombre de connecteurs dans cette agrégation.
availability_last_update_time	Timestamp Horodatage de la dernière mise à jour des informations sur la disponibilité du connecteur dans cette agrégation.
available_count	int32 Nombre de connecteurs de cette agrégation qui sont actuellement disponibles.
out_of_service_count	int32 Nombre de connecteurs de cette agrégation qui sont actuellement hors service.

EVConnectorType

Pour en savoir plus sur les types de connecteurs de recharge de VE, consultez la page http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107.

Enums
EV_CONNECTOR_TYPE_UNSPECIFIED	Connecteur non spécifié.
EV_CONNECTOR_TYPE_OTHER	Autres types de connecteurs
EV_CONNECTOR_TYPE_J1772	Connecteur J1772 de type 1.
EV_CONNECTOR_TYPE_TYPE_2	Connecteur CEI 62196 type 2. Souvent appelé MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO	Connecteur de type CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1	Système de recharge combiné (CA et CC). Basé sur SAE. Connecteur J-1772 de type 1
EV_CONNECTOR_TYPE_CCS_COMBO_2	Système de recharge combiné (CA et CC). Basé sur le connecteur Mennekes de type 2
EV_CONNECTOR_TYPE_TESLA	Connecteur TESLA générique. Il s'agit d'un NACS en Amérique du Nord, mais peut ne pas être un NACS dans d'autres parties du monde (par exemple, CCS Combo 2 (CCS2) ou GB/T). Cette valeur est moins représentative d'un type de connecteur réel, et "plus" représente la possibilité de recharger un véhicule de la marque Tesla à une borne de recharge appartenant à Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T	Le type GB/T correspond à la norme GB/T en Chine. Ce type couvre tous les types GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET	Prise murale non spécifiée.

FuelOptions

Informations les plus récentes sur les options de carburant d'une station-service. Ces informations sont mises à jour régulièrement.

Champs
fuel_prices[]	FuelPrice Dernier prix connu du carburant de chaque type de carburant de cette station. Cette station propose une entrée par type de carburant. L'ordre n'a pas d'importance.

FuelPrice

Informations sur le prix du carburant pour un type donné.

Champs
type	FuelType Type de carburant.
price	Money Prix du carburant.
update_time	Timestamp Heure de la dernière mise à jour du prix du carburant.

FuelType

Types de carburant.

Enums
FUEL_TYPE_UNSPECIFIED	Type de carburant non spécifié.
DIESEL	Carburant diesel
REGULAR_UNLEADED	Standard sans piste.
MIDGRADE	Intermédiaire.
PREMIUM	Le haut de gamme
SP91	SP 91.
SP91_E10	SP 91 E10.
SP92	SP 92.
SP95	SP 95.
SP95_E10	SP95 E10.
SP98	SP 98.
SP99	SP 99.
SP100	SP 100.
LPG	GPL.
E80	E 80.
E85	E 85.
METHANE	Le méthane
BIO_DIESEL	Bio-diesel
TRUCK_DIESEL	Un diesel.

GetPhotoMediaRequest

Requête de récupération de la photo d'un lieu à l'aide d'un nom de ressource de photo.

Champs
name	string Obligatoire. Nom de ressource d'un support photo au format places/{place_id}/photos/{photo_reference}/media. Le nom de ressource d'une photo tel que renvoyé dans le champ photos.name d'un objet Place se présente au format places/{place_id}/photos/{photo_reference}. Vous devez ajouter /media à la fin de la ressource photo pour obtenir le nom de la ressource multimédia photo.
max_width_px	int32 Facultatif. Spécifie la largeur maximale souhaitée, en pixels, de l'image. Si l'image est plus petite que les valeurs spécifiées, l'image d'origine est renvoyée. Si l'image est plus grande dans l'une ou l'autre des dimensions, elle sera mise à l'échelle pour correspondre à la plus petite des deux dimensions, dans la limite de ses proportions d'origine. Les propriétés max_height_px et max_width_px acceptent un entier compris entre 1 et 4 800 inclus. Si la valeur n'est pas comprise dans la plage autorisée, une erreur INVALID_ARGUMENT est renvoyée. Vous devez spécifier au moins l'une des valeurs max_height_px ou max_width_px. Si aucune des valeurs max_height_px et max_width_px n'est spécifiée, une erreur INVALID_ARGUMENT s'affiche.
max_height_px	int32 Facultatif. Spécifie la hauteur maximale souhaitée, en pixels, de l'image. Si l'image est plus petite que les valeurs spécifiées, l'image d'origine est renvoyée. Si l'image est plus grande dans l'une ou l'autre des dimensions, elle sera mise à l'échelle pour correspondre à la plus petite des deux dimensions, dans la limite de ses proportions d'origine. Les propriétés max_height_px et max_width_px acceptent un entier compris entre 1 et 4 800 inclus. Si la valeur n'est pas comprise dans la plage autorisée, une erreur INVALID_ARGUMENT est renvoyée. Vous devez spécifier au moins l'une des valeurs max_height_px ou max_width_px. Si aucune des valeurs max_height_px et max_width_px n'est spécifiée, une erreur INVALID_ARGUMENT s'affiche.
skip_http_redirect	bool Facultatif. S'il est défini, ignorez le comportement de redirection HTTP par défaut et affichez une réponse au format texte (par exemple, au format JSON pour le cas d'utilisation HTTP). Si cette règle n'est pas configurée, une redirection HTTP est émise pour rediriger l'appel vers l'image multimédia. Cette option est ignorée pour les requêtes autres que HTTP.

GetPlaceRequest

Requête de récupération d'un lieu à partir de son nom de ressource, qui est une chaîne au format places/{place_id}.

Champs
name	string Obligatoire. Nom de ressource d'un lieu, au format places/{place_id}.
language_code	string Facultatif. Les détails du lieu s'afficheront dans la langue préférée, le cas échéant. Liste des langues actuellement acceptées: https://developers.google.com/maps/faq#languagesupport.
region_code	string Facultatif. Le code pays/région Unicode (CLDR) de l'emplacement d'où provient la requête. Ce paramètre permet d'afficher des détails sur le lieu, comme son nom spécifique à une région, le cas échéant. Le paramètre peut avoir une incidence sur les résultats en fonction de la législation applicable. Pour en savoir plus, consultez la page https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Notez que les codes régionaux à trois chiffres ne sont pas acceptés pour le moment.
session_token	string Facultatif. Chaîne qui identifie une session de saisie semi-automatique à des fins de facturation. Il doit s'agir d'une chaîne en base64 avec nom de fichier et URL ne dépassant pas 36 caractères ASCII. Sinon, une erreur INVALID_ARGUMENT est renvoyée. La session commence lorsque l'utilisateur commence à saisir une requête et se termine lorsqu'il sélectionne un lieu et qu'un appel à Place Details ou à Address Validation est effectué. Chaque session peut comporter plusieurs requêtes, suivies d'une requête Place Details ou Address Validation. Les identifiants utilisés pour chaque requête au cours d'une session doivent appartenir au même projet de la console Google Cloud. Une fois la session terminée, le jeton n'est plus valide. Votre application doit générer un nouveau jeton pour chaque session. Si le paramètre session_token est omis ou si vous réutilisez un jeton de session, la session est facturée comme si aucun jeton n'était fourni (chaque requête est facturée séparément). Nous vous recommandons de respecter les consignes suivantes: Utilisez des jetons de session pour tous les appels Place Autocomplete. Générez un nouveau jeton pour chaque session. Nous vous recommandons d'utiliser un UUID version 4. Assurez-vous que les identifiants utilisés pour toutes les requêtes Place Autocomplete, Place Details et Address Validation au cours d'une session appartiennent au même projet de la console Cloud. N'oubliez pas de transmettre un jeton de session unique pour chaque nouvelle session. Si vous utilisez le même jeton pour plusieurs sessions, chaque requête est facturée individuellement.

Photo

Informations sur la photo d'un lieu.

Champs
name	string Identifiant. Référence représentant cette photo de lieu, qui peut être utilisée pour la rechercher à nouveau (également appelée "nom de ressource" de l'API: places/{place_id}/photos/{photo}).
width_px	int32 Largeur maximale disponible, en pixels.
height_px	int32 Hauteur maximale disponible, en pixels.
author_attributions[]	AuthorAttribution Auteurs de cette photo.

PhotoMedia

Élément multimédia photo provenant de l'API Places.

Champs
name	string Nom de ressource d'un support photo au format places/{place_id}/photos/{photo_reference}/media.
photo_uri	string URI de courte durée pouvant être utilisé pour afficher la photo.

Lieu

Toutes les informations représentant un lieu.

Champs
name	string Nom de la ressource de ce lieu, au format places/{place_id}. Permet de rechercher le lieu.
id	string Identifiant unique d'un lieu.
display_name	LocalizedText Nom localisé du lieu, sous la forme d'une courte description lisible par l'humain. Exemples : "Google Sydney", "Starbucks", "Pyrmont", etc.
types[]	string Ensemble de tags de type pour ce résultat. Exemples : "political" et "locality". Pour obtenir la liste complète des valeurs possibles, consultez les tableaux A et B à l'adresse https://developers.google.com/maps/documentation/places/web-service/place-types.
primary_type	string Type principal du résultat donné. Ce type doit correspondre à l'un des types compatibles avec l'API Places. Exemples : "restaurant", "café", "aéroport", etc. Un lieu ne peut avoir qu'un seul type principal. Pour obtenir la liste complète des valeurs possibles, consultez les tableaux A et B à l'adresse https://developers.google.com/maps/documentation/places/web-service/place-types.
primary_type_display_name	LocalizedText Nom à afficher du type principal, localisé dans la langue de la requête, le cas échéant. Pour obtenir la liste complète des valeurs possibles, consultez les tableaux A et B à l'adresse https://developers.google.com/maps/documentation/places/web-service/place-types.
national_phone_number	string Numéro de téléphone du lieu, au format national, lisible par l'humain.
international_phone_number	string Numéro de téléphone du lieu, au format international, lisible par l'humain.
formatted_address	string Adresse complète et lisible de ce lieu.
short_formatted_address	string Adresse courte et lisible de ce lieu.
address_components[]	AddressComponent Composants répétés pour chaque niveau de localité. Remarques concernant le tableau address_components[] : - Le tableau de composants d'adresse peut contenir plus de composants que le tableau formatted_address. - Le tableau n'inclut pas nécessairement toutes les entités politiques contenant une adresse, à l'exception de celles incluses dans formatted_address. Pour récupérer toutes les entités politiques contenant une adresse spécifique, vous devez utiliser le geocoding inversé, en transmettant à la requête la latitude/longitude de l'adresse en tant que paramètre. - Il n'est pas garanti que le format de la réponse reste le même entre les requêtes. En particulier, le nombre de composants "address_components" varie en fonction de l'adresse demandée et peut changer au fil du temps pour la même adresse. Un composant peut changer de position dans le tableau. Le type du composant peut changer. Un composant particulier peut être manquant dans une réponse ultérieure.
plus_code	PlusCode Plus code de l'emplacement du lieu (latitude/longitude).
location	LatLng Position de ce lieu.
viewport	Viewport Fenêtre d'affichage permettant d'afficher le lieu sur une carte de taille moyenne.
rating	double Une note comprise entre 1 et 5, 0 basée sur les avis des utilisateurs sur ce lieu.
google_maps_uri	string URL fournissant plus d'informations sur ce lieu.
website_uri	string Site Web officiel de ce lieu (par exemple, la page d'accueil d'une entreprise). Notez que pour les établissements appartenant à une chaîne (un magasin IKEA, par exemple), il s'agit généralement du site Web du magasin individuel, et non de celui de la chaîne dans son ensemble.
reviews[]	Review Liste d'avis concernant ce lieu, triés par pertinence. Un maximum de cinq avis peut être renvoyé.
regular_opening_hours	OpeningHours Horaires d'ouverture habituels
photos[]	Photo Informations (y compris des références) concernant les photos de ce lieu. Vous pouvez renvoyer jusqu'à 10 photos.
adr_format_address	string Adresse du lieu au microformat adr: http://microformats.org/wiki/adr.
business_status	BusinessStatus État de l'établissement pour le lieu.
price_level	PriceLevel Niveau de prix du lieu.
attributions[]	Attribution Ensemble du fournisseur de données à afficher avec ce résultat.
icon_mask_base_uri	string URL tronquée d'un masque d'icône. L'utilisateur peut accéder à différents types d'icônes en ajoutant un suffixe (par exemple, ".svg" ou ".png").
icon_background_color	string Couleur d'arrière-plan de icon_mask au format hexadécimal, par exemple #909CE1.
current_opening_hours	OpeningHours Les horaires d'ouverture pour les sept prochains jours (y compris aujourd'hui). La période commence à minuit le jour de la demande et se termine à 23 h 59 six jours plus tard. Ce champ inclut le sous-champ special_days de toutes les heures, défini pour les dates qui comportent des horaires exceptionnels.
current_secondary_opening_hours[]	OpeningHours Contient un tableau d'entrées pour les sept prochains jours, y compris des informations sur les horaires secondaires d'un établissement. Les horaires secondaires sont différents des horaires standards d'un établissement. Par exemple, un restaurant peut définir des horaires de drive ou de livraison comme horaires secondaires. Ce champ renseigne le sous-champ "Type", qui s'appuie sur une liste prédéfinie de types d'horaires d'ouverture (par exemple, "DRIVE_THROUGH", "PICKUP" ou "TAKEOUT") en fonction des types de lieux. Ce champ inclut le sous-champ special_days de toutes les heures, défini pour les dates qui comportent des horaires exceptionnels.
regular_secondary_opening_hours[]	OpeningHours Contient un tableau d'entrées pour les informations sur les horaires secondaires habituels d'un établissement. Les horaires secondaires sont différents des horaires standards d'un établissement. Par exemple, un restaurant peut définir des horaires de drive ou de livraison comme horaires secondaires. Ce champ renseigne le sous-champ "Type", qui s'appuie sur une liste prédéfinie de types d'horaires d'ouverture (par exemple, "DRIVE_THROUGH", "PICKUP" ou "TAKEOUT") en fonction des types de lieux.
editorial_summary	LocalizedText Contient un résumé du lieu. Un résumé se compose d'un résumé textuel et inclut également le code de langue correspondant, le cas échéant. Le texte récapitulatif doit être présenté tel quel et ne peut être ni modifié, ni altéré.
payment_options	PaymentOptions Options de paiement acceptées par le lieu. Si les données d'une option de paiement ne sont pas disponibles, le champ correspondant n'est pas défini.
parking_options	ParkingOptions Options de stationnement fournies par le lieu.
sub_destinations[]	SubDestination Liste des sous-destinations associées au lieu.
fuel_options	FuelOptions Informations les plus récentes sur les options de carburant d'une station-service. Ces informations sont mises à jour régulièrement.
ev_charge_options	EVChargeOptions Informations sur les options de recharge VE.
generative_summary	GenerativeSummary Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus. Résumé du lieu généré par IA.
area_summary	AreaSummary Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus. Résumé généré par IA de la zone dans laquelle se trouve le lieu.
utc_offset_minutes	int32 Nombre de minutes (en minutes) que le fuseau horaire de ce lieu est actuellement décalé par rapport à UTC. Cette valeur est exprimée en minutes afin de prendre en charge les fuseaux horaires qui sont décalés de quelques fractions d'heure (par exemple, X heures et 15 minutes).
user_rating_count	int32 Nombre total d'avis (avec ou sans texte) pour ce lieu.
takeout	bool Indique si l'établissement accepte la vente à emporter.
delivery	bool Indique si l'établissement propose la livraison.
dine_in	bool Indique si l'établissement propose des tables en salle ou en terrasse.
curbside_pickup	bool Indique si l'établissement accepte le drive.
reservable	bool Indique si le lieu accepte les réservations.
serves_breakfast	bool Indique si l'établissement sert le petit-déjeuner.
serves_lunch	bool Indique si l'établissement sert le déjeuner.
serves_dinner	bool Indique si l'établissement sert le dîner.
serves_beer	bool Indique si le lieu sert de la bière.
serves_wine	bool Indique si le lieu sert du vin.
serves_brunch	bool Indique si l'établissement sert des brunchs.
serves_vegetarian_food	bool Indique si le lieu sert de la nourriture végétarienne.
outdoor_seating	bool L'établissement possède une terrasse aménagée.
live_music	bool Des concerts sont organisés.
menu_for_children	bool Cet établissement propose un menu pour enfants.
serves_cocktails	bool L'établissement sert des cocktails.
serves_dessert	bool Établissement servant des desserts.
serves_coffee	bool L'établissement sert du café.
good_for_children	bool L'emplacement est idéal pour les enfants.
allows_dogs	bool Les chiens sont acceptés.
restroom	bool Il y a des toilettes.
good_for_groups	bool L'établissement peut accueillir des groupes.
good_for_watching_sports	bool Ce lieu permet de regarder des événements sportifs.
accessibility_options	AccessibilityOptions Informations sur les options d'accessibilité proposées par un lieu.

AccessibilityOptions

Informations sur les options d'accessibilité proposées par un lieu.

Champs
wheelchair_accessible_parking	bool L'établissement dispose d'un parking accessible en fauteuil roulant.
wheelchair_accessible_entrance	bool Le lieu dispose d'une entrée accessible en fauteuil roulant.
wheelchair_accessible_restroom	bool L'établissement dispose de toilettes accessibles en fauteuil roulant.
wheelchair_accessible_seating	bool Des places assises accessibles en fauteuil roulant sont disponibles dans l'établissement.

AddressComponent

Composants structurés qui forment l'adresse formatée, si cette information est disponible.

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, le cas échéant. Par exemple, un composant d'adresse pour l'Australie peut avoir le nom abrégé "AU".
types[]	string Tableau indiquant le ou les types du composant d'adresse.
language_code	string Langue utilisée pour formater ce composant, au format CLDR.

AreaSummary

Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus.

Résumé généré par IA de la zone dans laquelle se trouve le lieu.

Champs
content_blocks[]	ContentBlock Blocs de contenu qui composent le résumé de zone. Chaque bloc est associé à un thème distinct concernant la zone.

Attribution

Informations sur les fournisseurs de données de ce lieu.

Champs
provider	string Nom du fournisseur de données du lieu.
provider_uri	string URI du fournisseur de données du lieu.

BusinessStatus

État de l'établissement pour le lieu.

Enums
BUSINESS_STATUS_UNSPECIFIED	Valeur par défaut. Cette valeur n'est pas utilisée.
OPERATIONAL	L'établissement est opérationnel, et pas nécessairement ouvert en ce moment.
CLOSED_TEMPORARILY	L'établissement est fermé temporairement.
CLOSED_PERMANENTLY	L'établissement est fermé définitivement.

GenerativeSummary

Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus.

Résumé du lieu généré par IA.

Champs
overview	LocalizedText Présentation du lieu.
description	LocalizedText Description détaillée du lieu.
references	References Références utilisées pour générer la description récapitulative.

OpeningHours

Informations sur les horaires d'ouverture du lieu.

Champs
periods[]	Period Périodes d'ouverture de ce lieu pendant la semaine. Les règles s'affichent dans l'ordre chronologique et commencent le dimanche dans le fuseau horaire local du lieu. Une valeur vide (mais pas absente) indique un lieu qui n'est jamais ouvert (par exemple, parce qu'il est fermé temporairement pour rénovation).
weekday_descriptions[]	string Chaînes localisées décrivant les horaires d'ouverture de ce lieu (une chaîne pour chaque jour de la semaine). Ce champ est vide si les horaires sont inconnus ou n'ont pas pu être convertis en texte localisé. Exemple: "Dim: 18:00–06:00"
secondary_hours_type	SecondaryHoursType Chaîne de type utilisée pour identifier le type d'horaires secondaires.
special_days[]	SpecialDay Informations structurées pour les jours exceptionnels compris dans la période couverte par les horaires d'ouverture affichés. Les jours spéciaux sont ceux qui peuvent avoir un impact sur les horaires d'ouverture d'un lieu (le jour de Noël, par exemple). Définissez les valeurs "current_opening_hours" et "current_secondary_opening_hours" s'il existe des horaires exceptionnels.
open_now	bool Ce lieu est-il ouvert actuellement ? Toujours présent, sauf si nous manquons de données concernant l'heure de la journée ou le fuseau horaire pour ces horaires d'ouverture.

Période

Point pendant lequel le lieu reste à l'état "open_now".

Champs
open	Point Heure à laquelle le lieu commence à être ouvert.
close	Point Heure à laquelle le lieu commence à être fermé.

Point

Points de changement d'état.

Champs
date	Date Date dans le fuseau horaire local du lieu.
truncated	bool Indique si ce point de terminaison a été tronqué ou non. La troncation se produit lorsque les heures réelles sont en dehors de celles pendant lesquelles nous sommes prêts à renvoyer des heures. Nous tronquons donc les heures pour les ramener à ces limites. Cela permet de renvoyer un délai de 24 x 7 heures à partir de minuit le jour de la requête.
day	int32 Jour de la semaine, sous la forme d'un entier compris entre 0 et 6. 0 correspond à dimanche, 1 à lundi, etc.
hour	int32 Heure à deux chiffres. Il est compris entre 00 et 23.
minute	int32 Minute à deux chiffres. Il est compris entre 00 et 59.

SecondaryHoursType

Type utilisé pour identifier le type d'horaires secondaires.

Enums
SECONDARY_HOURS_TYPE_UNSPECIFIED	Valeur par défaut lorsque le type d'heure secondaire n'est pas spécifié.
DRIVE_THROUGH	Les heures de service de drive pour les banques, les restaurants ou les pharmacies.
HAPPY_HOUR	L'happy hour.
DELIVERY	Heure de livraison.
TAKEOUT	Heure de vente à emporter.
KITCHEN	L'heure de la cuisine.
BREAKFAST	L'heure du petit-déjeuner.
LUNCH	À l'heure du déjeuner.
DINNER	L'heure du dîner.
BRUNCH	L'heure du brunch.
PICKUP	Heure de retrait.
ACCESS	Heures d'accès aux lieux de stockage.
SENIOR_HOURS	Horaires d'ouverture exceptionnels pour les seniors.
ONLINE_SERVICE_HOURS	Horaires d'ouverture en ligne

SpecialDay

Informations structurées pour les jours exceptionnels compris dans la période couverte par les horaires d'ouverture affichés. Les jours spéciaux sont ceux qui peuvent avoir un impact sur les horaires d'ouverture d'un lieu (le jour de Noël, par exemple).

Champs
date	Date Date de ce jour spécial.

ParkingOptions

Informations sur les options de stationnement disponibles pour le lieu. Un parking peut accepter plus d'une option à la fois.

Champs
free_parking_lot	bool Des parkings sans frais sont à disposition.
paid_parking_lot	bool Des parkings payants sont disponibles.
free_street_parking	bool Le stationnement dans la rue est sans frais.
paid_street_parking	bool Des places de stationnement sont disponibles moyennant un supplément dans la rue.
valet_parking	bool Un parking avec service de voiturier est proposé.
free_garage_parking	bool Le parking couvert est sans frais.
paid_garage_parking	bool L'établissement propose un parking couvert payant.

PaymentOptions

Options de paiement acceptées par le lieu.

Champs
accepts_credit_cards	bool Place accepte les paiements par carte de crédit.
accepts_debit_cards	bool Place accepte les cartes de débit comme mode de paiement.
accepts_cash_only	bool L'établissement n'accepte que les paiements en espèces. Les établissements qui présentent cet attribut peuvent accepter d'autres modes de paiement.
accepts_nfc	bool Place accepte les paiements NFC.

PlusCode

Les plus codes (http://plus.codes) sont des références de lieu disponibles en deux formats: un code global définissant un rectangle de 14 x 14 m (1/8 000 degrés) ou un rectangle plus petit, et un code composé, qui remplace le préfixe par un emplacement de référence.

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

SubDestination

Nom de ressource et ID des sous-destinations liées au lieu. Par exemple, les différents terminaux représentent différentes destinations d'un aéroport.

Champs
name	string Nom de ressource de la sous-destination.
id	string ID de lieu de la sous-destination.

PriceLevel

Niveau de prix du lieu.

Enums
PRICE_LEVEL_UNSPECIFIED	Le niveau de prix du lieu n'est pas spécifié ou est inconnu.
PRICE_LEVEL_FREE	Cet établissement propose des services sans frais.
PRICE_LEVEL_INEXPENSIVE	Place fournit des services peu coûteux.
PRICE_LEVEL_MODERATE	Place propose des services à des prix modérés.
PRICE_LEVEL_EXPENSIVE	Place fournit des services coûteux.
PRICE_LEVEL_VERY_EXPENSIVE	Place fournit des services très coûteux.

Références

Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus.

Référence à laquelle le contenu génératif est lié.

Champs
reviews[]	Review Avis servant de référence.
places[]	string Liste des noms de ressources des lieux référencés. Ce nom peut être utilisé dans d'autres API qui acceptent les noms de ressources Place.

Récapitulatif

Informations sur un avis sur un lieu.

Champs
name	string Référence représentant cet avis sur le lieu, qui peut être utilisée pour rechercher à nouveau cet avis sur ce lieu (également appelée "nom de ressource" de l'API: places/{place_id}/reviews/{review}).
relative_publish_time_description	string Chaîne de date récente mise en forme, qui représente l'heure de l'examen par rapport à l'heure actuelle, dans un format adapté à la langue et au pays.
text	LocalizedText Texte localisé de l'avis.
original_text	LocalizedText Le texte de l'avis dans sa langue d'origine.
rating	double Nombre compris entre 1 et 5, également appelé nombre d'étoiles.
author_attribution	AuthorAttribution Auteur de cet avis.
publish_time	Timestamp Code temporel de l'avis.

SearchNearbyRequest

Demande un proto pour Search Nearby.

Champs
language_code	string Les détails du lieu s'afficheront dans la langue préférée, le cas échéant. Si le code de langue n'est pas spécifié ou n'est pas reconnu, des informations sur le lieu peuvent s'afficher pour n'importe quelle langue, en préférant l'anglais si ces informations existent. Liste des langues actuellement acceptées: https://developers.google.com/maps/faq#languagesupport.
region_code	string Le code pays/région Unicode (CLDR) de l'emplacement d'où provient la requête. Ce paramètre permet d'afficher des détails sur le lieu, comme son nom spécifique à une région, le cas échéant. Le paramètre peut avoir une incidence sur les résultats en fonction de la législation applicable. Pour en savoir plus, consultez la page https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Notez que les codes régionaux à trois chiffres ne sont pas acceptés pour le moment.
included_types[]	string Type de lieu inclus (par exemple, "restaurant" ou "gas_station") depuis https://developers.google.com/maps/documentation/places/web-service/place-types. Vous pouvez spécifier jusqu'à 50 types du Tableau A. En cas de types conflictuels (un type apparaît à la fois dans include_types et excluded_types), une erreur INVALID_ARGUMENT est renvoyée. Si un type de lieu est spécifié avec plusieurs restrictions de type, seuls les lieux qui satisfont à toutes les restrictions sont renvoyés. Par exemple, si nous avons {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, les lieux renvoyés proposent des services liés au terme "restaurant", mais ne fonctionnent pas principalement comme des "restaurants".
excluded_types[]	string Type de lieu exclu (par exemple, "restaurant" ou "gas_station") de la page https://developers.google.com/maps/documentation/places/web-service/place-types. Vous pouvez spécifier jusqu'à 50 types du Tableau A. Si le client fournit à la fois des types inclus (par exemple, restaurant) et des types exclus (ex. : café), la réponse doit inclure les établissements qui sont des restaurants, mais pas les cafés. La réponse inclut des lieux qui correspondent à au moins l'un des types inclus et aucun des types exclus. En cas de types conflictuels (un type apparaît à la fois dans include_types et excluded_types), une erreur INVALID_ARGUMENT est renvoyée. Si un type de lieu est spécifié avec plusieurs restrictions de type, seuls les lieux qui satisfont à toutes les restrictions sont renvoyés. Par exemple, si nous avons {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, les lieux renvoyés proposent des services liés au terme "restaurant", mais ne fonctionnent pas principalement comme des "restaurants".
included_primary_types[]	string Type de lieu principal inclus (par exemple, "restaurant" ou "gas_station") de la page https://developers.google.com/maps/documentation/places/web-service/place-types. Un lieu ne peut avoir qu'un seul type principal issu du tableau des types compatibles qui lui est associé. Vous pouvez spécifier jusqu'à 50 types du Tableau A. En cas de conflit avec des types principaux (un type apparaît à la fois dans include_primary_types et excluded_primary_types), une erreur INVALID_ARGUMENT est renvoyée. Si un type de lieu est spécifié avec plusieurs restrictions de type, seuls les lieux qui satisfont à toutes les restrictions sont renvoyés. Par exemple, si nous avons {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, les lieux renvoyés proposent des services liés au terme "restaurant", mais ne fonctionnent pas principalement comme des "restaurants".
excluded_primary_types[]	string Type de lieu principal exclu (par exemple, "restaurant" ou "gas_station") de la page https://developers.google.com/maps/documentation/places/web-service/place-types. Vous pouvez spécifier jusqu'à 50 types du Tableau A. En cas de conflit avec des types principaux (un type apparaît à la fois dans include_primary_types et excluded_primary_types), une erreur INVALID_ARGUMENT est renvoyée. Si un type de lieu est spécifié avec plusieurs restrictions de type, seuls les lieux qui satisfont à toutes les restrictions sont renvoyés. Par exemple, si nous avons {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, les lieux renvoyés proposent des services liés au terme "restaurant", mais ne fonctionnent pas principalement comme des "restaurants".
max_result_count	int32 Nombre maximal de résultats sur une page. Elle doit être comprise entre 1 et 20 (par défaut), inclus. Si ce nombre n'est pas défini, la limite supérieure est rétablie. Si le nombre est défini sur négatif ou dépasse la limite supérieure, une erreur INVALID_ARGUMENT est renvoyée.
location_restriction	LocationRestriction Obligatoire. Région dans laquelle effectuer la recherche.
rank_preference	RankPreference Mode de classement des résultats dans la réponse.

LocationRestriction

Région dans laquelle effectuer la recherche.

Champs
Champ d'union type. type ne peut être qu'un des éléments suivants :
circle	Circle Cercle défini par un point central et un rayon

RankPreference

Mode de classement des résultats dans la réponse.

Enums
RANK_PREFERENCE_UNSPECIFIED	Valeur RankPreference non définie. Le classement par défaut sera utilisé par POPULARITY.
DISTANCE	Classe les résultats par distance.
POPULARITY	Trie les résultats par popularité.

SearchNearbyResponse

Proto de réponse pour la recherche à proximité.

Champs
places[]	Place Liste de lieux qui répond aux exigences de l'utilisateur, comme le type de lieu, le nombre de lieux et des restrictions géographiques spécifiques.

SearchTextRequest

Prototype de requête pour SearchText.

Champs
text_query	string Obligatoire. Requête textuelle pour la recherche textuelle.
language_code	string Les détails du lieu s'afficheront dans la langue préférée, le cas échéant. Si le code de langue n'est pas spécifié ou n'est pas reconnu, des informations sur le lieu peuvent s'afficher pour n'importe quelle langue, en préférant l'anglais si ces informations existent. Liste des langues actuellement acceptées: https://developers.google.com/maps/faq#languagesupport.
region_code	string Le code pays/région Unicode (CLDR) de l'emplacement d'où provient la requête. Ce paramètre permet d'afficher des détails sur le lieu, comme son nom spécifique à une région, le cas échéant. Le paramètre peut avoir une incidence sur les résultats en fonction de la législation applicable. Pour en savoir plus, consultez la page https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Notez que les codes régionaux à trois chiffres ne sont pas acceptés pour le moment.
rank_preference	RankPreference Mode de classement des résultats dans la réponse.
included_type	string Type de lieu demandé. Liste complète des types compatibles: https://developers.google.com/maps/documentation/places/web-service/place-types. N'accepte qu'un seul type inclus.
open_now	bool Permet de limiter la recherche aux lieux actuellement ouverts. La valeur par défaut est "false".
min_rating	double Filtrez les résultats dont la note moyenne des visiteurs est strictement inférieure à cette limite. Une valeur valide doit être un nombre décimal compris entre 0 et 5 (inclus) à une cadence de 0,5, c'est-à-dire [0, 0,5, 1,0, ..., 5,0] (inclus). La valeur d'entrée est arrondie à la valeur 0,5(plafond) la plus proche. Par exemple, une note de 0,6 élimine tous les résultats inférieurs à 1,0.
max_result_count (deprecated)	int32 Cet élément est obsolète. Obsolète: utilisez plutôt page_size. Nombre maximal de résultats par page pouvant être renvoyés. Si le nombre de résultats disponibles est supérieur à max_result_count, un next_page_token est renvoyé. Il peut être transmis à page_token pour obtenir la page de résultats suivante dans les requêtes suivantes. Si aucune valeur n'est spécifiée, la valeur par défaut utilisée est 20. La valeur maximale est 20 ; les valeurs supérieures seront forcées à 20. Les valeurs négatives renverront une erreur INVALID_ARGUMENT. Si max_result_count et page_size sont spécifiés, max_result_count sera ignoré.
page_size	int32 Facultatif. Nombre maximal de résultats par page pouvant être renvoyés. Si le nombre de résultats disponibles est supérieur à page_size, un next_page_token est renvoyé. Il peut être transmis à page_token pour obtenir la page de résultats suivante dans les requêtes suivantes. Si aucune valeur n'est spécifiée, la valeur par défaut utilisée est 20. La valeur maximale est 20. Les valeurs supérieures à 20 sont définies sur 20. Les valeurs négatives renverront une erreur INVALID_ARGUMENT. Si max_result_count et page_size sont spécifiés, max_result_count sera ignoré.
page_token	string Facultatif. Jeton de page, reçu lors d'un appel TextSearch précédent. Fournissez-le pour récupérer la page suivante. Lors de la pagination, tous les paramètres autres que page_token, page_size et max_result_count fournis à TextSearch doivent correspondre à l'appel initial qui a fourni le jeton de page. Sinon, une erreur INVALID_ARGUMENT est renvoyée.
price_levels[]	PriceLevel Utilisé pour limiter la recherche aux lieux signalés comme étant associés à certains niveaux de prix. Les utilisateurs peuvent choisir n'importe quelle combinaison de niveaux de prix. Sélectionnez par défaut tous les niveaux de prix.
strict_type_filtering	bool Permet de définir un filtrage de type strict pour le champ "included_type". Si elle est définie sur "true", seuls les résultats du même type sont renvoyés. La valeur par défaut est "false".
location_bias	LocationBias Région dans laquelle effectuer la recherche. Cette position sert de biais, ce qui signifie que des résultats situés à proximité d'un lieu donné peuvent être renvoyés. Ne peut pas être défini avec location_restriction.
location_restriction	LocationRestriction Région dans laquelle effectuer la recherche. Cette zone géographique fait office de restriction, ce qui signifie que les résultats situés en dehors de la zone géographique indiquée ne seront pas renvoyés. Ne peut pas être défini avec location_bias.
ev_options	EVOptions Facultatif. Définissez les options de VE dans le cadre d'une requête de recherche de lieu.

EVOptions

Options de VE dans une requête de recherche de lieu

Champs
minimum_charging_rate_kw	double Facultatif. Taux de recharge minimal requis en kilowatts. Un lieu dont le taux de facturation est inférieur au tarif spécifié est exclu.
connector_types[]	EVConnectorType Facultatif. Liste des types de connecteurs de VE préférés. Un emplacement qui n'est compatible avec aucun des types de connecteurs listés est exclu.

LocationBias

Région dans laquelle effectuer la recherche. Cette position sert de biais, ce qui signifie que des résultats situés à proximité d'un lieu donné peuvent être renvoyés.

Champs
Champ d'union type. type ne peut être qu'un des éléments suivants :
rectangle	Viewport Rectangle défini par un angle 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(). La plage de latitudes est donc vide. Une fenêtre d'affichage rectangulaire ne peut pas dépasser 180 degrés.
circle	Circle Cercle défini par un point central et un rayon

LocationRestriction

Région dans laquelle effectuer la recherche. Cette zone géographique fait office de restriction, ce qui signifie que les résultats situés en dehors de la zone géographique indiquée ne seront pas renvoyés.

Champs
Champ d'union type. type ne peut être qu'un des éléments suivants :
rectangle	Viewport Rectangle défini par un angle 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(). La plage de latitudes est donc vide. Une fenêtre d'affichage rectangulaire ne peut pas dépasser 180 degrés.

RankPreference

Mode de classement des résultats dans la réponse.

Enums
RANK_PREFERENCE_UNSPECIFIED	Pour une requête catégorielle telle que "Restaurants à New York", RELEVANCE est la valeur par défaut. Pour les requêtes non catégorielles telles que "Mountain View, CA", nous vous recommandons de ne pas définir RankPreference.
DISTANCE	Classe les résultats par distance.
RELEVANCE	Il classe les résultats par pertinence. L'ordre de tri est déterminé par la pile de classement normale.

SearchTextResponse

Proto de réponse pour SearchText.

Champs
places[]	Place Liste des lieux qui correspondent aux critères de recherche textuelle de l'utilisateur.
contextual_contents[]	ContextualContent Version expérimentale: consultez la page https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative pour en savoir plus. Liste de contenus contextuels dans lesquels chaque entrée est associée au lieu correspondant dans le même index dans le champ "Lieux". Il est préférable d'utiliser les contenus pertinents pour text_query dans la requête. Si le contenu contextuel n'est pas disponible pour l'un de ces emplacements, il renvoie du contenu non contextuel. Elle n'est vide que si le contenu n'est pas disponible pour ce lieu. Cette liste doit comporter autant d'entrées que la liste de lieux, si nécessaire.
next_page_token	string Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis ou vide, il n'y a pas de pages suivantes.