Package google.maps.places.v1

Index

Lieux

Définition du service pour l'API Places. Remarque : Chaque requête (à l'exception des requêtes Autocomplete et GetPhotoMedia) nécessite un masque de champ défini en dehors du proto de 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 https://developers.google.com/maps/documentation/places/web-service/choose-fields.

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

Renvoie les prédictions pour l'entrée donnée.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

Obtenez un contenu multimédia photo avec une chaîne de référence photo.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform
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}.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

Recherchez des lieux à proximité d'adresses.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Recherche de lieux basée sur une requête textuelle.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

AddressDescriptor

Description relationnelle d'un lieu. Inclut un ensemble classé de points de repère à proximité, ainsi que des zones de couverture précises et leur relation avec le lieu cible.

Champs
landmarks[]

Landmark

Liste classée des points de repère à proximité. Les points de repère les plus connus et les plus proches sont classés en premier.

areas[]

Area

Liste classée des zones contenant ou adjacentes. Les zones les plus reconnaissables et les plus précises sont classées en premier.

Quartier

Informations sur la zone et sa relation avec le lieu cible.

Les zones incluent des sous-localités précises, des quartiers et de grands complexes qui sont utiles pour décrire un lieu.

Champs
name

string

Nom de ressource de la zone.

place_id

string

ID de lieu de la zone.

display_name

LocalizedText

Nom à afficher de la zone.

containment

Containment

Définit la relation spatiale entre le lieu cible et la zone.

Confinement

Définit la relation spatiale entre le lieu cible et la zone.

Enums
CONTAINMENT_UNSPECIFIED La contenance n'est pas spécifiée.
WITHIN L'emplacement cible se trouve dans la région de la zone, près du centre.
OUTSKIRTS L'emplacement cible se trouve dans la région de la zone, près du bord.
NEAR L'emplacement cible se trouve en dehors de la zone, mais à proximité.

Point de repère

Informations de base sur le point de repère et son lien avec le lieu cible.

Les points de repère sont des lieux importants qui peuvent être utilisés pour décrire un emplacement.

Champs
name

string

Nom de ressource du point de repère.

place_id

string

ID de lieu du point de repère.

display_name

LocalizedText

Nom à afficher du point de repère.

types[]

string

Ensemble de tags de type pour ce point de repère. Pour obtenir la liste complète des valeurs possibles, consultez https://developers.google.com/maps/documentation/places/web-service/place-types.

spatial_relationship

SpatialRelationship

Définit la relation spatiale entre le lieu cible et le point de repère.

straight_line_distance_meters

float

Distance en ligne droite, en mètres, entre le point central de la cible et le point central du repère. Dans certains cas, cette valeur peut être supérieure à travel_distance_meters.

travel_distance_meters

float

Distance de trajet, en mètres, sur le réseau routier entre la cible et le point de repère, si elle est connue. Cette valeur ne tient pas compte du mode de transport (marche, voiture ou vélo, par exemple).

SpatialRelationship

Définit la relation spatiale entre le lieu cible et le point de repère.

Enums
NEAR Il s'agit de la relation par défaut lorsqu'aucune relation plus spécifique ci-dessous ne s'applique.
WITHIN Le point de repère a une géométrie spatiale et la cible se trouve dans ses limites.
BESIDE La cible est directement adjacente au point de repère.
ACROSS_THE_ROAD La cible se trouve directement en face du point de repère, de l'autre côté de la route.
DOWN_THE_ROAD Sur le même itinéraire que le point de repère, mais pas à côté ni en face.
AROUND_THE_CORNER Pas sur le même itinéraire que le point de repère, mais à un seul embranchement.
BEHIND Près de la structure du point de repère, mais plus loin de ses entrées sur rue.

AuthorAttribution

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

Champs
display_name

string

Nom de l'auteur de Photo ou Review.

uri

string

URI de l'auteur de Photo ou Review.

photo_uri

string

URI de la photo de profil de l'auteur de Photo ou Review.

AutocompletePlacesRequest

Requête proto pour AutocompletePlaces.

Champs
input

string

Obligatoire. Chaîne de texte sur laquelle effectuer la recherche.

location_bias

LocationBias

Facultatif. Limiter les résultats à un lieu spécifié.

Vous ne devez définir qu'un seul élément location_bias ou location_restriction. Si aucun n'est défini, les résultats seront biaisés par l'adresse IP, ce qui signifie que l'adresse IP sera associée à un emplacement imprécis et utilisée comme signal de pondération.

location_restriction

LocationRestriction

Facultatif. Limiter les résultats à un emplacement spécifié

Vous ne devez définir qu'un seul élément location_bias ou location_restriction. Si aucun n'est défini, les résultats seront biaisés par l'adresse IP, ce qui signifie que l'adresse IP sera associé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") dans les types de lieux (https://developers.google.com/maps/documentation/places/web-service/place-types), ou uniquement (regions), ou uniquement (cities). 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 lieux sont renvoyés.

included_region_codes[]

string

Facultatif. Incluez uniquement les résultats dans les régions spécifiées, sous forme de 15 codes de région CLDR à deux caractères maximum. Un ensemble vide ne limitera pas les résultats. Si location_restriction et included_region_codes sont tous les deux définis, les résultats se trouveront dans la zone d'intersection.

language_code

string

Facultatif. Langue dans laquelle renvoyer les résultats. La valeur par défaut est "en-US". Les résultats peuvent être dans plusieurs langues si la langue utilisée dans input est différente de language_code ou si le lieu renvoyé n'a pas été traduit 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 la mise en forme des adresses et le classement des résultats, et peut avoir une incidence sur 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 d'origine à partir duquel calculer la distance géodésique jusqu'à la destination (renvoyée sous la forme distance_meters). Si cette valeur est omise, la distance géodésique ne sera pas renvoyée.

input_offset

int32

Facultatif. Décalage de caractère Unicode basé sur zéro (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 des prédictions de lieux et de requêtes. Sinon, la réponse ne renverra que des prédictions de lieux.

session_token

string

Facultatif. Chaîne qui identifie une session Autocomplete à des fins de facturation. Il doit s'agir d'une chaîne Base64 compatible avec les URL et les noms de fichiers, et ne pas comporter plus de 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 d'une session doivent appartenir au même projet de la console Google Cloud. Lorsque la session prend fin, le jeton n'est plus valide. Votre application doit générer un nouveau jeton pour chaque session. Si vous omettez le paramètre session_token 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 la version 4 de l'UUID.
  • Assurez-vous que les identifiants utilisés pour toutes les requêtes Place Autocomplete, Place Details et Address Validation 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.
include_pure_service_area_businesses

bool

Facultatif. Incluez les établissements de services de proximité à domicile si le champ est défini sur "true". Un établissement de services de proximité est un établissement qui se rend directement chez les clients pour effectuer une prestation ou leur livrer des produits, mais qui n'accueille pas les clients dans ses locaux. Il peut s'agir, par exemple, d'un établissement proposant des services de nettoyage ou de plomberie. Ces établissements n'ont pas d'adresse physique ni de localisation sur Google Maps. Places ne renverra pas les champs incluant location, plus_code et d'autres champs liés à la localisation pour ces établissements.

LocationBias

Région dans laquelle effectuer la recherche. Les résultats peuvent être biaisés autour de 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 un angle 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 seront 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 un angle 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 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 pour un lieu.

query_prediction

QueryPrediction

Prédiction pour 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 qui peut être utilisé tel quel ou mis en forme avec matches.

matches[]

StringRange

Liste des plages de chaînes identifiant les correspondances de la requête d'entrée dans text. Les plages peuvent être utilisées pour mettre en forme des parties spécifiques de text. Les sous-chaînes ne correspondent pas forcément exactement à input si la correspondance a été déterminée par des critères autres que la correspondance de chaînes (par exemple, des corrections orthographiques ou des translittérations).

Ces valeurs sont des décalages de caractères Unicode de text. Les plages sont garanties d'être classées par ordre croissant des valeurs de décalage.

PlacePrediction

Résultats de prédiction pour 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 lieux.

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'UI distincts, mais associés, peuvent utiliser structured_format à la place. Il s'agit de deux façons différentes de représenter une prédiction de lieu. Les utilisateurs ne doivent pas essayer d'analyser structured_format en text ni l'inverse.

Il peut différer du display_name renvoyé par GetPlace.

La réponse peut être dans plusieurs langues si la demande 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 en texte principal contenant le nom du lieu et en texte secondaire contenant des caractéristiques supplémentaires permettant de lever toute ambiguïté (comme une ville ou une région).

structured_format est recommandé pour les développeurs qui souhaitent afficher deux éléments d'UI distincts, mais liés. Les développeurs qui souhaitent afficher un seul élément d'interface utilisateur peuvent utiliser text à la place. Il s'agit de deux façons différentes de représenter une prédiction de lieu. Les utilisateurs ne doivent pas essayer d'analyser structured_format en text ni l'inverse.

types[]

string

Liste des types qui s'appliquent à ce lieu à partir du tableau A ou du tableau B de la page https://developers.google.com/maps/documentation/places/web-service/place-types.

Un type est une catégorie de lieu. Les lieux ayant des types partagés auront 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, comme les itinéraires, ne s'affichent pas dans ce champ.

QueryPrediction

Résultats de prédiction pour une prédiction de saisie semi-automatique de requête.

Champs
text

FormattableText

Texte prédit. Ce texte ne représente pas un lieu, mais plutôt une requête textuelle qui pourrait être utilisée dans un point de terminaison de recherche (par exemple, la recherche de texte).

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'UI distincts, mais associés, peuvent utiliser structured_format à la place. Il s'agit de deux façons différentes de représenter une prédiction de requête. Les utilisateurs ne doivent pas essayer d'analyser structured_format en text ni l'inverse.

La réponse 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 language_code.

structured_format

StructuredFormat

Répartition de la prédiction de requête en texte principal contenant la requête et texte secondaire contenant des caractéristiques de clarification supplémentaires (comme une ville ou une région).

structured_format est recommandé pour les développeurs qui souhaitent afficher deux éléments d'UI distincts, mais liés. Les développeurs qui souhaitent afficher un seul élément d'interface utilisateur peuvent utiliser text à la place. Il s'agit de deux façons différentes de représenter une prédiction de requête. Les utilisateurs ne doivent pas essayer d'analyser structured_format en text ni l'inverse.

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 de base zéro du dernier caractère Unicode (exclusif).

StructuredFormat

Contient une répartition d'une prédiction de lieu ou de requête en texte principal et texte secondaire.

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

Le texte secondaire contient des éléments de clarification supplémentaires (tels qu'une ville ou une région) pour identifier plus précisément le lieu ou affiner la requête.

Champs
main_text

FormattableText

Représente le nom du lieu ou de la requête.

secondary_text

FormattableText

Représente des caractéristiques de clarification supplémentaires (telles qu'une ville ou une région) pour identifier plus précisément le lieu ou affiner la requête.

Cercle

Cercle avec une LatLng comme centre et rayon.

Champs
center

LatLng

Obligatoire. Latitude et longitude du centre.

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 pouvant être diffusé individuellement.

Champs
content

LocalizedText

Contenus liés au thème.

referenced_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.

ContextualContent

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Contenu contextuel à la requête sur le lieu.

Champs
reviews[]

Review

Liste des avis sur ce lieu, en fonction du contexte de la requête sur le lieu.

photos[]

Photo

Informations (y compris les références) sur les photos de ce lieu, en fonction de la requête sur le lieu.

justifications[]

Justification

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Justifications concernant le lieu.

Justification

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

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

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

BusinessAvailabilityAttributesJustification

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Justifications des attributs de disponibilité de l'établissement. Cela montre certains attributs d'un établissement qui pourraient intéresser un utilisateur final.

Champs
takeout

bool

Si un établissement propose des plats à emporter.

delivery

bool

Si un établissement propose la livraison.

dine_in

bool

Si un lieu propose des repas sur place.

ReviewJustification

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Justifications des avis des utilisateurs. Cette section met en évidence une partie de l'avis de l'utilisateur qui pourrait intéresser un utilisateur final. Par exemple, si la requête de recherche est "pizza au feu de bois", la justification de l'avis met en évidence le texte pertinent pour la requête de recherche.

Champs
highlighted_text

HighlightedText

review

Review

Avis à partir duquel le texte mis en surbrillance est généré.

HighlightedText

Texte mis en évidence par la justification. Il s'agit d'un sous-ensemble de l'avis lui-même. Le mot exact à mettre en surbrillance est indiqué par HighlightedTextRange. Plusieurs mots du texte peuvent être mis en évidence.

Champs
text

string

highlighted_text_ranges[]

HighlightedTextRange

Liste des plages du texte mis en surbrillance.

HighlightedTextRange

Plage de texte mis en surbrillance.

Champs
start_index

int32

end_index

int32

EVChargeOptions

Informations sur la borne de recharge de véhicules électriques hébergée dans un lieu La terminologie est conforme à https://afdc.energy.gov/fuels/electricity_infrastructure.html. Un port peut recharger une voiture à la fois. Un port comporte un ou plusieurs connecteurs. Une borne comporte un ou plusieurs ports.

Champs
connector_count

int32

Nombre de connecteurs à cette borne. Toutefois, comme certains ports peuvent comporter plusieurs connecteurs, mais ne peuvent recharger qu'une voiture à la fois (par exemple), le nombre de connecteurs peut être supérieur au nombre total de voitures pouvant être rechargées simultanément.

connector_aggregation[]

ConnectorAggregation

Liste des agrégations de connecteurs de recharge pour véhicules électriques qui contiennent des connecteurs du même type et du même taux de recharge.

ConnectorAggregation

Informations sur la recharge de véhicules électriques regroupées par [type, max_charge_rate_kw]. Affiche l'agrégation de la recharge des VE pour les connecteurs qui ont le même type et le même taux de recharge maximal 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 actuellement disponibles dans cette agrégation.

out_of_service_count

int32

Nombre de connecteurs de cette agrégation actuellement hors service.

EVConnectorType

Pour en savoir plus sur les types de connecteurs de recharge pour véhicules électriques, consultez 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 IEC 62196 de 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 la norme SAE. Connecteur de type 1 J-1772
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 de NACS en Amérique du Nord, mais il peut s'agir d'un autre type de connecteur dans d'autres régions 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 représente davantage la possibilité de recharger un véhicule de la marque Tesla dans une station 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.
EV_CONNECTOR_TYPE_NACS Le North American Charging System (NACS), normalisé sous la norme SAE J3400.

FuelOptions

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

Champs
fuel_prices[]

FuelPrice

Dernier prix du carburant connu pour chaque type de carburant disponible dans cette station. Il y a une entrée par type de carburant disponible dans cette station. 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.
DIESEL_PLUS Carburant diesel plus.
REGULAR_UNLEADED Sans plomb standard.
MIDGRADE Niveau 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 Gaz de pétrole liquéfié
E80 E 80.
E85 E 85.
E100 E 100.
METHANE Méthane.
BIO_DIESEL Biodiesel.
TRUCK_DIESEL Diesel pour camions.

GetPhotoMediaRequest

Requête permettant de récupérer une photo d'un lieu à l'aide du nom de ressource photo.

Champs
name

string

Obligatoire. Nom de ressource d'un élément multimédia photo au format suivant : places/{place_id}/photos/{photo_reference}/media.

Le nom de ressource d'une photo tel qu'il est renvoyé dans le champ photos.name d'un objet Place est au format places/{place_id}/photos/{photo_reference}. Vous devez ajouter /media à la fin de la ressource photo pour obtenir le nom de ressource du contenu multimédia de la photo.

max_width_px

int32

Facultatif. Spécifie la largeur maximale souhaitée de l'image, en pixels. 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 dimension, elle sera mise à l'échelle pour correspondre à la plus petite des deux dimensions, tout en conservant son format 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 ne se trouve pas dans la plage autorisée, une erreur INVALID_ARGUMENT est renvoyée.

Vous devez spécifier au moins max_height_px ou max_width_px. Si ni max_height_px ni max_width_px ne sont spécifiés, une erreur INVALID_ARGUMENT est renvoyée.

max_height_px

int32

Facultatif. Spécifie la hauteur maximale souhaitée de l'image, en pixels. 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 dimension, elle sera mise à l'échelle pour correspondre à la plus petite des deux dimensions, tout en conservant son format 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 ne se trouve pas dans la plage autorisée, une erreur INVALID_ARGUMENT est renvoyée.

Vous devez spécifier au moins max_height_px ou max_width_px. Si ni max_height_px ni max_width_px ne sont spécifiés, une erreur INVALID_ARGUMENT est renvoyée.

skip_http_redirect

bool

Facultatif. Si cette option est définie, 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 elle n'est pas définie, une redirection HTTP est émise pour rediriger l'appel vers le contenu multimédia de l'image. Cette option est ignorée pour les requêtes non HTTP.

GetPlaceRequest

Requête permettant de récupérer un lieu en fonction 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'affichent dans la langue de votre choix, si elle est disponible.

Liste actuelle des langues disponibles : https://developers.google.com/maps/faq#languagesupport.

region_code

string

Facultatif. Code de pays/région Unicode (CLDR) de l'emplacement d'où provient la demande. Ce paramètre permet d'afficher les détails du lieu, comme son nom spécifique à la région, s'il est disponible. Ce paramètre peut avoir une incidence sur les résultats en fonction de la loi applicable. Pour en savoir plus, consultez https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Notez que les codes de région à trois chiffres ne sont pas acceptés pour le moment.

session_token

string

Facultatif. Chaîne qui identifie une session Autocomplete à des fins de facturation. Il doit s'agir d'une chaîne Base64 compatible avec les URL et les noms de fichiers, et ne pas comporter plus de 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 d'une session doivent appartenir au même projet de la console Google Cloud. Lorsque la session prend fin, le jeton n'est plus valide. Votre application doit générer un nouveau jeton pour chaque session. Si vous omettez le paramètre session_token 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 la version 4 de l'UUID.
  • Assurez-vous que les identifiants utilisés pour toutes les requêtes Place Autocomplete, Place Details et Address Validation 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 une photo d'un lieu.

Champs
name

string

Identifiant. Référence représentant cette photo de lieu, qui peut être utilisée pour la retrouver (é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.

flag_content_uri

string

Lien permettant aux utilisateurs de signaler un problème concernant la photo.

google_maps_uri

string

Un lien permettant d'afficher la photo sur Google Maps.

PhotoMedia

Photo provenant de l'API Places.

Champs
name

string

Nom de ressource d'un élément multimédia photo au format suivant : places/{place_id}/photos/{photo_reference}/media.

photo_uri

string

URI à courte durée de vie qui peut être utilisé pour afficher la photo.

Lieu

Toutes les informations représentant un lieu.

Champs
name

string

Nom de ressource de ce lieu, au format places/{place_id}. Peut être utilisé pour rechercher le lieu.

id

string

Identifiant unique d'un lieu.

display_name

LocalizedText

Nom localisé du lieu, adapté à une courte description intelligible. Par exemple, "Google Sydney", "Starbucks", "Pyrmont", etc.

types[]

string

Ensemble de tags de type pour ce résultat. Par exemple, "political" (politique) et "locality" (localité). 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.

primary_type

string

Type principal du résultat donné. Ce type doit être l'un des types acceptés par l'API Places. Par exemple, "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 sur la page https://developers.google.com/maps/documentation/places/web-service/place-types. Le type principal peut être manquant si le type principal du lieu n'est pas accepté. Lorsqu'un type principal est présent, il s'agit toujours de l'un des types du champ 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 sur la page https://developers.google.com/maps/documentation/places/web-service/place-types. Le type principal peut être manquant si le type principal du lieu n'est pas accepté.

national_phone_number

string

Numéro de téléphone du lieu, lisible, au format national.

international_phone_number

string

Numéro de téléphone du lieu, lisible par un humain et au format international.

formatted_address

string

Adresse complète et lisible de ce lieu.

short_formatted_address

string

Adresse courte et lisible de ce lieu.

postal_address

PostalAddress

Adresse au format postal.

address_components[]

AddressComponent

Composants répétés pour chaque niveau de localité. Notez les informations suivantes concernant le tableau address_components[] : - Le tableau de composants d'adresse peut contenir plus de composants que l'adresse formatée. - 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. - Le format de la réponse ne sera peut-être pas le même d'une requête à l'autre. En particulier, le nombre de address_components varie selon 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 la latitude et de la longitude du lieu.

location

LatLng

Position de ce lieu.

viewport

Viewport

Fenêtre d'affichage adaptée à l'affichage du lieu sur une carte de taille moyenne. Ce viewport ne doit pas être utilisé comme limite physique ni comme zone desservie de l'établissement.

rating

double

Note comprise entre 1,0 et 5,0, basée sur les avis des utilisateurs concernant ce lieu.

google_maps_uri

string

URL fournissant plus d'informations sur ce lieu.

website_uri

string

Site Web faisant autorité pour ce lieu, par exemple la page d'accueil d'un établissement. Notez que pour les lieux faisant partie d'une chaîne (par exemple, un magasin IKEA), 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 des avis sur ce lieu, triés par pertinence. Un maximum de cinq avis peuvent être renvoyés.

regular_opening_hours

OpeningHours

Horaires d'ouverture habituels. Notez que si un lieu est toujours ouvert (24 heures sur 24), le champ close ne sera pas défini. Les clients peuvent s'appuyer sur le fait qu'un lieu toujours ouvert (24 heures) est représenté par une période open contenant day avec la valeur 0, hour avec la valeur 0 et minute avec la valeur 0.

time_zone

TimeZone

Fuseau horaire de la base de données des fuseaux horaires IANA. Par exemple, "America/New_York".

photos[]

Photo

Informations (y compris les références) sur les photos de ce lieu. Vous pouvez obtenir jusqu'à 10 photos.

adr_format_address

string

Adresse du lieu au format 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 de fournisseurs de données à afficher avec ce résultat.

icon_mask_base_uri

string

URL tronquée vers un masque d'icône. L'utilisateur peut accéder à différents types d'icônes en ajoutant un suffixe de type à la fin (par exemple, ".svg" ou ".png").

icon_background_color

string

Couleur d'arrière-plan pour 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 à la date de la demande et se termine à 23h59 six jours plus tard. Ce champ inclut le sous-champ "special_days" de toutes les heures, défini pour les dates ayant 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 principaux d'un établissement. Par exemple, un restaurant peut indiquer les horaires du drive ou de la livraison comme horaires secondaires. Ce champ renseigne le sous-champ "type", qui est extrait d'une liste prédéfinie de types d'heures d'ouverture (tels que 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 ayant des horaires exceptionnels.

regular_secondary_opening_hours[]

OpeningHours

Contient un tableau d'entrées d'informations sur les horaires secondaires réguliers d'un établissement. Les horaires secondaires sont différents des horaires principaux d'un établissement. Par exemple, un restaurant peut indiquer les horaires du drive ou de la livraison comme horaires secondaires. Ce champ renseigne le sous-champ "type", qui est extrait d'une liste prédéfinie de types d'heures d'ouverture (tels que 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'une présentation textuelle et inclut également le code de langue, le cas échéant. Le texte récapitulatif doit être présenté tel quel et ne peut pas être modifié.

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 de l'option de paiement ne sera pas défini.

parking_options

ParkingOptions

Options de stationnement proposées 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 dans une station-service. Ces informations sont mises à jour régulièrement.

ev_charge_options

EVChargeOptions

Informations sur les options de recharge de véhicules électriques

generative_summary

GenerativeSummary

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

containing_places[]

ContainingPlace

Liste des lieux dans lesquels se trouve le lieu actuel.

address_descriptor

AddressDescriptor

Descripteur d'adresse du lieu. Les descripteurs d'adresse incluent des informations supplémentaires qui aident à décrire un lieu à l'aide de points de repère et de zones. Consultez la couverture régionale des descripteurs d'adresse sur https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.

price_range

PriceRange

Tranche de prix associée à un lieu.

review_summary

ReviewSummary

Résumé du lieu généré par l'IA à partir des avis des utilisateurs.

ev_charge_amenity_summary

EvChargeAmenitySummary

Résumé des commodités à proximité de la borne de recharge pour véhicules électriques.

neighborhood_summary

NeighborhoodSummary

Résumé des points d'intérêt à proximité du lieu.

consumer_alert

ConsumerAlert

Message d'alerte destiné aux consommateurs pour le lieu concerné lorsque nous détectons une activité suspecte concernant les avis sur un établissement ou qu'un établissement ne respecte pas nos règles.

utc_offset_minutes

int32

Nombre de minutes de décalage horaire actuel du lieu par rapport à UTC. Cette valeur est exprimée en minutes pour prendre en charge les fuseaux horaires décalés d'une fraction 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 propose des plats à emporter.

delivery

bool

Indique si l'établissement propose la livraison.

dine_in

bool

Indique si l'établissement propose des places assises à l'intérieur ou à l'extérieur.

curbside_pickup

bool

Indique si l'établissement propose le retrait en voiture.

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 à dîner.

serves_beer

bool

Indique si l'établissement sert de la bière.

serves_wine

bool

Indique si l'établissement sert du vin.

serves_brunch

bool

Indique si l'établissement sert des brunchs.

serves_vegetarian_food

bool

Indique si l'établissement sert des plats végétariens.

outdoor_seating

bool

L'établissement dispose d'une terrasse.

live_music

bool

Le lieu propose des concerts.

menu_for_children

bool

L'établissement propose un menu pour enfants.

serves_cocktails

bool

L'établissement sert des cocktails.

serves_dessert

bool

L'établissement sert des desserts.

serves_coffee

bool

Le lieu sert du café.

good_for_children

bool

Lieu adapté aux enfants.

allows_dogs

bool

Les chiens sont acceptés.

restroom

bool

L'établissement dispose de toilettes.

good_for_groups

bool

L'établissement peut accueillir des groupes.

good_for_watching_sports

bool

L'établissement est adapté pour regarder des événements sportifs.

accessibility_options

AccessibilityOptions

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

pure_service_area_business

bool

Indique si le lieu est un établissement de services de proximité à domicile. Un établissement de services de proximité est un établissement qui se rend directement chez les clients pour effectuer une prestation ou leur livrer des produits, mais qui n'accueille pas les clients dans ses locaux. Il peut s'agir, par exemple, d'un établissement proposant des services de nettoyage ou de plomberie. Il est possible que ces établissements n'aient pas d'adresse physique ni d'emplacement sur Google Maps.

AccessibilityOptions

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

Champs
wheelchair_accessible_parking

bool

Le lieu 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

Lieu disposant de toilettes accessibles en fauteuil roulant.

wheelchair_accessible_seating

bool

L'établissement propose des places assises accessibles en fauteuil roulant.

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 un long_name de "Australie".

short_text

string

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

types[]

string

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

language_code

string

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

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.

Enums
BUSINESS_STATUS_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
OPERATIONAL L'établissement est opérationnel, mais pas forcément ouvert actuellement.
CLOSED_TEMPORARILY L'établissement est temporairement fermé.
CLOSED_PERMANENTLY L'établissement est définitivement fermé.

ConsumerAlert

Message d'alerte destiné aux consommateurs pour le lieu concerné lorsque nous détectons une activité suspecte concernant les avis sur un établissement ou qu'un établissement ne respecte pas nos règles.

Champs
overview

string

Aperçu du message d'alerte consommateur.

details

Details

Détails du message d'alerte consommateur.ƒ

language_code

string

Code de langue du message d'alerte aux consommateurs. Il s'agit d'un code de langue BCP 47.

Détails

Détails du message d'alerte consommateur.

Champs
title

string

Titre à afficher avec la description.

description

string

Description du message d'alerte aux consommateurs.

ContainingPlace

Informations sur le lieu dans lequel se trouve cet endroit.

Champs
name

string

Nom de ressource du lieu dans lequel se trouve cet établissement.

id

string

ID du lieu dans lequel se trouve cet établissement.

EvChargeAmenitySummary

Résumé des commodités à proximité de la borne de recharge pour véhicules électriques. Cela ne s'applique qu'aux lieux de type electric_vehicle_charging_station. Le champ overview est fourni à coup sûr, tandis que les autres champs sont facultatifs.

Champs
overview

ContentBlock

Présentation des services disponibles. Cette information sera obligatoirement fournie.

coffee

ContentBlock

Récapitulatif des cafés à proximité.

restaurant

ContentBlock

Un résumé des restaurants à proximité.

store

ContentBlock

Résumé des magasins à proximité.

flag_content_uri

string

Lien permettant aux utilisateurs de signaler un problème concernant le résumé.

disclosure_text

LocalizedText

Message d'information sur l'IA "Résumé avec Gemini" (et ses variantes localisées). Si possible, la réponse sera fournie dans la langue spécifiée dans la requête.

GenerativeSummary

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

Champs
overview

LocalizedText

Aperçu du lieu.

overview_flag_content_uri

string

Lien permettant aux utilisateurs de signaler un problème concernant le résumé.

disclosure_text

LocalizedText

Message d'information sur l'IA "Résumé avec Gemini" (et ses variantes localisées). Si possible, la réponse sera fournie dans la langue spécifiée dans la requête.

NeighborhoodSummary

Résumé des points d'intérêt à proximité du lieu.

Champs
overview

ContentBlock

Un résumé du quartier.

description

ContentBlock

Description détaillée du quartier.

flag_content_uri

string

Lien permettant aux utilisateurs de signaler un problème concernant le résumé.

disclosure_text

LocalizedText

Message d'information sur l'IA "Résumé avec Gemini" (et ses variantes localisées). Si possible, la réponse sera fournie dans la langue spécifiée dans la requête.

OpeningHours

Informations sur les horaires d'ouverture du lieu.

Champs
periods[]

Period

Périodes pendant lesquelles ce lieu est ouvert en semaine. Les périodes sont indiquées dans l'ordre chronologique, dans le fuseau horaire local du lieu. Une valeur vide (mais non absente) indique un lieu qui n'est jamais ouvert, par exemple parce qu'il est temporairement fermé pour rénovation.

Le jour de début de periods n'est PAS fixe et ne doit pas être considéré comme étant le dimanche. L'API détermine le jour de début en fonction de différents facteurs. Par exemple, pour une entreprise ouverte 24h/24 et 7j/7, la première période peut commencer le jour de la demande. Pour d'autres établissements, il peut s'agir du premier jour de la semaine où ils sont ouverts.

REMARQUE : L'ordre du tableau periods est indépendant de celui du tableau weekday_descriptions. Ne partez pas du principe qu'elles commenceront le même jour.

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.

REMARQUE : L'ordre des jours et le début de la semaine sont déterminés par les paramètres régionaux (langue et région). L'ordre du tableau periods est indépendant de celui du tableau weekday_descriptions. Ne partez pas du principe qu'elles commenceront le même jour.

Ce champ sera vide si les horaires sont inconnus ou n'ont pas pu être convertis en texte localisé. Exemple : "Sun: 18:00–06:00"

secondary_hours_type

SecondaryHoursType

Chaîne de type utilisée pour identifier le type d'heures secondaires.

special_days[]

SpecialDay

Informations structurées pour les jours fériés inclus dans la période couverte par les horaires d'ouverture renvoyés. Les jours spéciaux sont des jours qui peuvent avoir un impact sur les horaires d'ouverture d'un lieu (par exemple, le jour de Noël). Définissez-le sur "current_opening_hours" et "current_secondary_opening_hours" si des horaires exceptionnels sont prévus.

next_open_time

Timestamp

La prochaine période d'ouverture actuelle commence dans un délai de sept jours. Ce champ n'est renseigné que si la période d'ouverture n'est pas active au moment de la diffusion de la demande.

next_close_time

Timestamp

La prochaine période d'heures d'ouverture se termine dans un délai de sept jours. Ce champ n'est renseigné que si la période d'ouverture est active au moment de la diffusion de la demande.

open_now

bool

Indique si la période d'heures d'ouverture est actuellement active. Pour les horaires d'ouverture habituels et actuels, ce champ indique si le lieu est ouvert. Pour les horaires d'ouverture secondaires et les horaires d'ouverture secondaires actuels, ce champ indique si les horaires secondaires de ce lieu sont actifs.

Période

Période pendant laquelle le lieu reste à l'état "open_now".

Champs
open

Point

Heure à laquelle l'établissement ouvre.

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 troncature se produit lorsque les heures réelles sont en dehors des limites que nous sommes prêts à renvoyer. Nous tronquons donc les heures pour les ramener à ces limites. Cela garantit que 24 * 7 heures au maximum à partir de minuit le jour de la demande sont renvoyées.

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 au format 24 heures. Les valeurs vont de 0 à 23.

minute

int32

La minute. Les valeurs vont de 0 à 59.

SecondaryHoursType

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

Enums
SECONDARY_HOURS_TYPE_UNSPECIFIED Valeur par défaut lorsque le type d'heure secondaire n'est pas spécifié.
DRIVE_THROUGH Heure du drive pour les banques, les restaurants ou les pharmacies.
HAPPY_HOUR L'happy hour.
DELIVERY Heure de livraison.
TAKEOUT Heure de retrait.
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 Horaires d'accès aux lieux de stockage.
SENIOR_HOURS Horaires d'ouverture exceptionnels pour les seniors.
ONLINE_SERVICE_HOURS Horaires du service en ligne.

SpecialDay

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

Champs
date

Date

Date de ce jour spécial.

ParkingOptions

Informations sur les options de stationnement pour le lieu. Un parking peut prendre en charge plusieurs options à la fois.

Champs
free_parking_lot

bool

Le lieu dispose de parkings sans frais.

paid_parking_lot

bool

Des parkings payants sont disponibles.

free_street_parking

bool

Le parking dans la rue est sans frais.

paid_street_parking

bool

Le stationnement dans la rue est payant.

valet_parking

bool

Un parking avec service de voiturier est disponible.

free_garage_parking

bool

Le parking couvert est sans frais.

paid_garage_parking

bool

Un parking couvert payant est disponible.

PaymentOptions

Options de paiement acceptées par le lieu.

Champs
accepts_credit_cards

bool

L'établissement accepte les cartes de crédit comme mode de paiement.

accepts_debit_cards

bool

L'établissement accepte les cartes de débit comme moyen de paiement.

accepts_cash_only

bool

Le lieu n'accepte que les paiements en espèces. Les établissements disposant de cet attribut peuvent toujours accepter d'autres modes de paiement.

accepts_nfc

bool

L'établissement accepte les paiements NFC.

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.

ReviewSummary

Résumé du lieu généré par l'IA à partir des avis des utilisateurs.

Champs
text

LocalizedText

Résumé des avis des utilisateurs.

flag_content_uri

string

Lien permettant aux utilisateurs de signaler un problème concernant le résumé.

disclosure_text

LocalizedText

Message d'information sur l'IA "Résumé avec Gemini" (et ses variantes localisées). Si possible, la réponse sera fournie dans la langue spécifiée dans la requête.

reviews_uri

string

Un lien permettant d'afficher les avis sur ce lieu dans Google Maps.

SubDestination

Les sous-destinations sont des lieux spécifiques associés à un lieu principal. Elles fournissent des destinations plus spécifiques aux utilisateurs qui effectuent des recherches dans un lieu vaste ou complexe, comme un aéroport, un parc national, une université ou un stade. Par exemple, les sous-destinations d'un aéroport peuvent inclure les terminaux et les parkings associés. Les sous-destinations renvoient l'ID et le nom de ressource du lieu, qui peuvent être utilisés dans des requêtes Place Details (New) ultérieures pour récupérer des informations plus détaillées, y compris le nom à afficher et l'emplacement de la sous-destination.

Champs
name

string

Nom de ressource de la sous-destination.

id

string

ID du lieu de la sous-destination.

Polyline

Polyligne d'un itinéraire. Seule une polyline encodée est acceptée. Elle peut être transmise sous forme de chaîne et inclut une compression avec une perte minimale. Il s'agit de la sortie par défaut de l'API Routes.

Champs
Champ d'union polyline_type. Encapsule le type de polyligne. La valeur par défaut de la sortie de l'API Routes est encoded_polyline. La polyline_type ne peut être qu'un des éléments suivants :
encoded_polyline

string

Une polyline encodée, telle qu'elle est renvoyée par l'API Routes par défaut. Consultez les outils Encoder et Decoder.

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 Le lieu propose des services sans frais.
PRICE_LEVEL_INEXPENSIVE Lieu proposant des services peu coûteux.
PRICE_LEVEL_MODERATE L'établissement propose des services à des prix modérés.
PRICE_LEVEL_EXPENSIVE Le lieu propose des services coûteux.
PRICE_LEVEL_VERY_EXPENSIVE L'établissement propose des services très coûteux.

PriceRange

Tranche de prix associée à un lieu. end_price peut ne pas être défini, ce qui indique une plage sans limite supérieure (par exemple, "Plus de 100 $").

Champs
start_price

Money

Valeur inférieure de la tranche de prix (incluse). Le prix doit être égal ou supérieur à ce montant.

end_price

Money

Limite supérieure de la tranche de prix (exclusive). Le prix doit être inférieur à ce montant.

Vérifier

Informations sur un avis concernant un lieu.

Champs
name

string

Référence représentant cet avis sur un lieu, qui peut être utilisée pour le retrouver (également appelée nom de "ressource" de l'API : places/{place_id}/reviews/{review}).

relative_publish_time_description

string

Chaîne de format temporel récent, exprimant la durée de l'avis par rapport à l'heure actuelle dans un format adapté à la langue et au pays.

text

LocalizedText

Texte localisé de l'avis.

original_text

LocalizedText

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 l'avis.

publish_time

Timestamp

Code temporel de l'avis.

flag_content_uri

string

Lien permettant aux utilisateurs de signaler un problème lié à l'avis.

google_maps_uri

string

Un lien permettant d'afficher l'avis sur Google Maps.

visit_date

Date

Date à laquelle l'auteur a visité le lieu. Cette valeur est tronquée au mois.

RouteModifiers

Encapsule un ensemble de conditions facultatives à respecter lors du calcul des itinéraires.

Champs
avoid_tolls

bool

Facultatif. Si cette valeur est définie sur "true", les routes à péage sont évitées dans la mesure du possible, en privilégiant les itinéraires qui n'en comportent pas. S'applique uniquement aux TravelMode DRIVE et TWO_WHEELER.

avoid_highways

bool

Facultatif. Si cette valeur est définie sur "true", les autoroutes sont évitées dans la mesure du possible, et la préférence est donnée aux itinéraires qui n'en contiennent pas. S'applique uniquement aux TravelMode DRIVE et TWO_WHEELER.

avoid_ferries

bool

Facultatif. Si la valeur est définie sur "true", les ferries sont évités dans la mesure du possible, et la préférence est donnée aux itinéraires qui n'en contiennent pas. S'applique uniquement aux TravelMode DRIVE et TWO_WHEELER.

avoid_indoor

bool

Facultatif. Lorsque cette valeur est définie sur "true", la navigation en intérieur est évitée dans la mesure du possible, en privilégiant les itinéraires qui ne contiennent pas de navigation en intérieur. S'applique uniquement à la WALK TravelMode.

RoutingParameters

Paramètres permettant de configurer les calculs de routage vers les lieux de la réponse, à la fois le long d'un itinéraire (où le classement des résultats sera influencé) et pour calculer les temps de trajet sur les résultats.

Champs
origin

LatLng

Facultatif. Origine de routage explicite qui remplace l'origine définie dans la polyligne. Par défaut, l'origine de la polyligne est utilisée.

travel_mode

TravelMode

Facultatif. Mode de transport.

route_modifiers

RouteModifiers

Facultatif. Modificateurs d'itinéraire.

routing_preference

RoutingPreference

Facultatif. Spécifie comment calculer les récapitulatifs de routage. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer le trajet. La préférence de routage tenant compte du trafic n'est disponible que pour les travelMode DRIVE ou TWO_WHEELER.

RoutingPreference

Ensemble de valeurs qui spécifient les facteurs à prendre en compte lors du calcul de l'itinéraire.

Enums
ROUTING_PREFERENCE_UNSPECIFIED Aucune préférence de routage n'a été spécifiée. Valeur par défaut : TRAFFIC_UNAWARE
TRAFFIC_UNAWARE Calcule les itinéraires sans tenir compte des conditions de circulation en temps réel. Convient lorsque les conditions de trafic n'ont pas d'importance ou ne s'appliquent pas. Cette valeur permet d'obtenir la latence la plus faible. Remarque : Pour TravelMode DRIVE et TWO_WHEELER, l'itinéraire et la durée sont déterminés en fonction du réseau routier et des conditions de circulation moyennes toutes heures confondues, et non de l'état actuel des routes. Par conséquent, l'itinéraire peut inclure des routes temporairement fermées. Les résultats d'une requête donnée peuvent varier au fil du temps en raison des modifications du réseau routier, des nouvelles moyennes de conditions de circulation et de la nature distribuée du service. Les résultats peuvent également varier entre plusieurs itinéraires presque équivalents à tout moment et à n'importe quelle fréquence.
TRAFFIC_AWARE Calcule les itinéraires en tenant compte des conditions de circulation en temps réel. Contrairement à TRAFFIC_AWARE_OPTIMAL, certaines optimisations sont appliquées pour réduire considérablement la latence.
TRAFFIC_AWARE_OPTIMAL Calcule les itinéraires en tenant compte des conditions de circulation en temps réel, sans appliquer la plupart des optimisations de performances. Cette valeur produit la latence la plus élevée.

RoutingSummary

Durée et distance entre l'origine du trajet et un lieu de la réponse, ainsi qu'un deuxième tronçon entre ce lieu et la destination, si demandé. Remarque : Si vous ajoutez routingSummaries dans le masque de champ sans inclure également le paramètre routingParameters.origin ou le paramètre searchAlongRouteParameters.polyline.encodedPolyline dans la requête, une erreur se produit.

Champs
legs[]

Leg

Les étapes du voyage.

Lorsque vous calculez la durée et la distance d'un trajet à partir d'un point de départ défini, legs contient une seule section indiquant la durée et la distance entre le point de départ et la destination. Lorsque vous effectuez une recherche sur un itinéraire, legs contient deux sections : une du point de départ au lieu et une du lieu à la destination.

directions_uri

string

Lien permettant d'afficher l'itinéraire sur Google Maps à l'aide des points de repère du récapitulatif d'itinéraire donné. Il n'est pas garanti que l'itinéraire généré par ce lien soit identique à celui utilisé pour générer le récapitulatif de l'itinéraire. Le lien utilise les informations fournies dans la requête, à partir de champs tels que routingParameters et searchAlongRouteParameters, le cas échéant, pour générer le lien vers l'itinéraire.

Pied

Une étape est une partie d'un trajet entre deux lieux.

Champs
duration

Duration

Temps nécessaire pour effectuer cette partie du trajet.

distance_meters

int32

Distance de cette section du trajet.

SearchNearbyRequest

Requête proto pour la recherche à proximité.

Champs
language_code

string

Les détails du lieu s'affichent dans la langue de votre choix, si elle est disponible. Si le code de langue n'est pas spécifié ou n'est pas reconnu, des informations sur le lieu dans n'importe quelle langue peuvent être renvoyées, avec une préférence pour l'anglais si de telles informations existent.

Liste actuelle des langues disponibles : https://developers.google.com/maps/faq#languagesupport.

region_code

string

Code de pays/région Unicode (CLDR) de l'emplacement d'où provient la demande. Ce paramètre permet d'afficher les détails du lieu, comme son nom spécifique à la région, s'il est disponible. Ce paramètre peut avoir une incidence sur les résultats en fonction de la loi applicable.

Pour en savoir plus, consultez https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Notez que les codes de région à trois chiffres ne sont pas acceptés pour le moment.

included_types[]

string

Type de lieu inclus (par exemple, "restaurant" ou "gas_station") à partir de https://developers.google.com/maps/documentation/places/web-service/place-types.

Vous pouvez spécifier jusqu'à 50 types du tableau A.

Si des types sont en conflit (c'est-à-dire qu'un type apparaît à la fois dans included_types et dans 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 répondent à toutes les restrictions sont renvoyés. Par exemple, si nous avons {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, les lieux renvoyés fournissent des services liés aux "restaurants", mais ne fonctionnent pas principalement comme des "restaurants".

excluded_types[]

string

Type de lieu exclu (par exemple, "restaurant" ou "gas_station") à partir de 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 (par exemple, "café"), la réponse doit inclure des lieux qui sont des restaurants, mais pas des cafés. La réponse inclut les lieux qui correspondent à au moins l'un des types inclus et à aucun des types exclus.

Si des types sont en conflit (c'est-à-dire qu'un type apparaît à la fois dans included_types et dans 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 répondent à toutes les restrictions sont renvoyés. Par exemple, si nous avons {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, les lieux renvoyés fournissent des services liés aux "restaurants", mais ne fonctionnent pas principalement comme des "restaurants".

included_primary_types[]

string

Type de lieu principal inclus (par exemple, "restaurant" ou "gas_station") à partir de https://developers.google.com/maps/documentation/places/web-service/place-types. Un lieu ne peut être associé qu'à un seul type principal parmi ceux listés dans le tableau des types acceptés.

Vous pouvez spécifier jusqu'à 50 types du tableau A.

Si des types principaux sont en conflit (c'est-à-dire si un type apparaît à la fois dans "included_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 répondent à toutes les restrictions sont renvoyés. Par exemple, si nous avons {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, les lieux renvoyés fournissent des services liés aux "restaurants", mais ne fonctionnent pas principalement comme des "restaurants".

excluded_primary_types[]

string

Type de lieu principal exclu (par exemple, "restaurant" ou "gas_station") de https://developers.google.com/maps/documentation/places/web-service/place-types.

Vous pouvez spécifier jusqu'à 50 types du tableau A.

Si des types principaux sont en conflit (c'est-à-dire si un type apparaît à la fois dans "included_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 répondent à toutes les restrictions sont renvoyés. Par exemple, si nous avons {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, les lieux renvoyés fournissent des services liés aux "restaurants", mais ne fonctionnent pas principalement comme des "restaurants".

max_result_count

int32

Nombre maximal de résultats à renvoyer. Elle doit être comprise entre 1 et 20 (valeur par défaut), inclus. Si le nombre n'est pas défini, la limite supérieure est utilisée. Si le nombre est 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

Comment les résultats seront classés dans la réponse.

routing_parameters

RoutingParameters

Facultatif. Paramètres qui affectent le routage vers les résultats de recherche.

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

Comment les résultats seront classés dans la réponse.

Enums
RANK_PREFERENCE_UNSPECIFIED La valeur RankPreference n'est pas définie. Utilisera le classement par POPULARITÉ par défaut.
DISTANCE Classe les résultats par distance.
POPULARITY Classe les résultats par popularité.

SearchNearbyResponse

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

Champs
places[]

Place

Liste des lieux qui répondent aux exigences de l'utilisateur, comme les types de lieux, le nombre de lieux et la restriction d'emplacement spécifique.

routing_summaries[]

RoutingSummary

Liste des récapitulatifs d'itinéraire où chaque entrée est associée au lieu correspondant au même index dans le champ places. Si le récapitulatif de l'itinéraire n'est pas disponible pour l'un des lieux, il contiendra une entrée vide. Cette liste doit comporter autant d'entrées que la liste des lieux, le cas échéant.

SearchTextRequest

Requête proto pour SearchText.

Champs
text_query

string

Obligatoire. Requête textuelle pour la recherche textuelle.

language_code

string

Les détails du lieu s'affichent dans la langue de votre choix, si elle est disponible. Si le code de langue n'est pas spécifié ou n'est pas reconnu, des informations sur le lieu dans n'importe quelle langue peuvent être renvoyées, avec une préférence pour l'anglais si de telles informations existent.

Liste actuelle des langues disponibles : https://developers.google.com/maps/faq#languagesupport.

region_code

string

Code de pays/région Unicode (CLDR) de l'emplacement d'où provient la demande. Ce paramètre permet d'afficher les détails du lieu, comme son nom spécifique à la région, s'il est disponible. Ce paramètre peut avoir une incidence sur les résultats en fonction de la loi applicable.

Pour en savoir plus, consultez https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Notez que les codes de région à trois chiffres ne sont pas acceptés pour le moment.

rank_preference

RankPreference

Comment les résultats seront classés dans la réponse.

included_type

string

Type de lieu demandé. Liste complète des types acceptés : https://developers.google.com/maps/documentation/places/web-service/place-types. Ne prend en charge qu'un seul type inclus.

open_now

bool

Permet de limiter la recherche aux lieux actuellement ouverts. La valeur par défaut est "false" (inactif).

min_rating

double

Filtrer les résultats dont la note moyenne des utilisateurs est strictement inférieure à cette limite. Une valeur valide doit être un nombre à virgule flottante compris entre 0 et 5 (inclus), avec une cadence de 0,5, c'est-à-dire [0, 0.5, 1.0, ..., 5.0] inclus. La note saisie est arrondie à la valeur 0,5 supérieure(plafond). Par exemple, une note de 0,6 éliminera tous les résultats dont la note est inférieure à 1,0.

max_result_count
(deprecated)

int32

Obsolète : utilisez plutôt page_size.

Nombre maximal de résultats pouvant être renvoyés par page. Si le nombre de résultats disponibles est supérieur à max_result_count, un next_page_token est renvoyé et peut être transmis à page_token pour obtenir la page de résultats suivante dans les requêtes ultérieures. Si la valeur 0 ou aucune valeur n'est fournie, la valeur par défaut de 20 est utilisée. La valeur maximale est 20. Les valeurs supérieures sont réduites à 20. Les valeurs négatives renvoient une erreur INVALID_ARGUMENT.

Si les deux champs max_result_count et page_size sont spécifiés, max_result_count sera ignoré.

page_size

int32

Facultatif. Nombre maximal de résultats pouvant être renvoyés par page. Si le nombre de résultats disponibles est supérieur à page_size, un next_page_token est renvoyé et peut être transmis à page_token pour obtenir la page de résultats suivante dans les requêtes ultérieures. Si la valeur 0 ou aucune valeur n'est fournie, la valeur par défaut de 20 est utilisée. La valeur maximale est 20. Les valeurs supérieures sont définies sur 20. Les valeurs négatives renvoient une erreur INVALID_ARGUMENT.

Si les deux champs max_result_count et page_size sont spécifiés, max_result_count sera ignoré.

page_token

string

Facultatif. Jeton de page reçu 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 ayant fourni le jeton de page. Sinon, une erreur INVALID_ARGUMENT est renvoyée.

price_levels[]

PriceLevel

Permet de limiter la recherche aux lieux marqués comme appartenant à certains niveaux de prix. Les utilisateurs peuvent choisir n'importe quelle combinaison de niveaux de prix. Par défaut, tous les niveaux de prix sont sélectionnés.

strict_type_filtering

bool

Permet de définir un filtrage strict des types pour included_type. Si la valeur est "true", seuls les résultats du même type seront renvoyés. La valeur par défaut est "false".

location_bias

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. Ne peut pas être défini avec location_restriction.

location_restriction

LocationRestriction

Région dans laquelle effectuer la recherche. Cet emplacement sert de restriction, ce qui signifie que les résultats en dehors de l'emplacement indiqué ne seront pas renvoyés. Ne peut pas être défini avec location_bias.

ev_options

EVOptions

Facultatif. Définissez les options de recherche de véhicules électriques d'une demande de recherche de lieux.

routing_parameters

RoutingParameters

Facultatif. Paramètres supplémentaires pour le routage vers les résultats.

search_along_route_parameters

SearchAlongRouteParameters

Facultatif. Proto de paramètres supplémentaires pour la recherche le long d'un itinéraire.

include_pure_service_area_businesses

bool

Facultatif. Incluez les établissements de services de proximité à domicile si le champ est défini sur "true". Un établissement de services de proximité est un établissement qui se rend directement chez les clients pour effectuer une prestation ou leur livrer des produits, mais qui n'accueille pas les clients dans ses locaux. Il peut s'agir, par exemple, d'un établissement proposant des services de nettoyage ou de plomberie. Ces établissements n'ont pas d'adresse physique ni de localisation sur Google Maps. Places ne renverra pas les champs incluant location, plus_code et d'autres champs liés à la localisation pour ces établissements.

EVOptions

Options de VE pouvant être recherchées dans une requête de recherche de lieu.

Champs
minimum_charging_rate_kw

double

Facultatif. Taux de recharge minimal requis en kilowatts. Les lieux dont le taux de recharge est inférieur à celui spécifié sont filtrés.

connector_types[]

EVConnectorType

Facultatif. Liste des types de connecteurs de VE préférés. Un lieu qui n'est compatible avec aucun des types de connecteurs listés est filtré.

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.

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 correspondre au point nord-est de la fenêtre d'affichage rectangulaire. 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.

circle

Circle

Cercle défini par un point central et un rayon.

LocationRestriction

Région dans laquelle effectuer la recherche. Cet emplacement sert de restriction, ce qui signifie que les résultats en dehors de l'emplacement indiqué ne seront pas renvoyés.

Champs

Champ d'union type.

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 correspondre au point nord-est de la fenêtre d'affichage rectangulaire. 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.

RankPreference

Comment les résultats seront classés dans la réponse.

Enums
RANK_PREFERENCE_UNSPECIFIED Pour une requête catégorielle telle que "Restaurants à New York", la pertinence 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 Classe les résultats par pertinence. L'ordre de tri est déterminé par la pile de classement normale.

SearchAlongRouteParameters

Spécifie une polyligne précalculée à partir de l'API Routes qui définit l'itinéraire à rechercher. La recherche le long d'un itinéraire est semblable à l'utilisation de l'option de requête locationBias ou locationRestriction pour orienter les résultats de recherche. Toutefois, alors que les options locationBias et locationRestriction vous permettent de spécifier une région pour orienter les résultats de recherche, cette option vous permet d'orienter les résultats le long d'un itinéraire.

Les résultats ne sont pas garantis d'être sur l'itinéraire fourni, mais sont plutôt classés dans la zone de recherche définie par la polyligne et, éventuellement, par locationBias ou locationRestriction en fonction des temps de détour minimaux entre l'origine et la destination. Les résultats peuvent correspondre à un autre itinéraire, en particulier si la polyligne fournie ne définit pas un itinéraire optimal entre l'origine et la destination.

Champs
polyline

Polyline

Obligatoire. Polyligne de l'itinéraire.

SearchTextResponse

Proto de réponse pour SearchText.

Champs
places[]

Place

Liste des lieux correspondant aux critères de recherche textuelle de l'utilisateur.

routing_summaries[]

RoutingSummary

Liste des récapitulatifs d'itinéraire où chaque entrée est associée au lieu correspondant au même index dans le champ places. Si le récapitulatif de l'itinéraire n'est pas disponible pour l'un des lieux, il contiendra une entrée vide. Cette liste comportera autant d'entrées que la liste des lieux, si elle est demandée.

contextual_contents[]

ContextualContent

Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Liste de contenus contextuels où chaque entrée est associée au lieu correspondant au même index dans le champ "places". Nous préférons les contenus pertinents pour le text_query de la demande. Si le contenu contextuel n'est pas disponible pour l'un des lieux, un contenu non contextuel sera renvoyé. Il ne sera vide que si le contenu n'est pas disponible pour ce lieu. Cette liste comportera autant d'entrées que la liste des lieux, si elle est demandée.

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, aucune page suivante n'existe.

search_uri

string

Un lien permet à l'utilisateur d'effectuer une recherche avec la même requête textuelle que celle spécifiée dans la demande sur Google Maps.

TravelMode

Options de mode de déplacement. Ces options correspondent à ce que propose l'API Routes.

Enums
TRAVEL_MODE_UNSPECIFIED Aucun mode de déplacement n'a été spécifié. La valeur par défaut est DRIVE.
DRIVE Voyagez en voiture de tourisme.
BICYCLE Déplacez-vous à vélo. Non compatible avec search_along_route_parameters.
WALK Se déplacer à pied Non compatible avec search_along_route_parameters.
TWO_WHEELER Véhicules motorisés à deux roues de toutes sortes, comme les scooters et les motos. Notez que ce mode de transport est différent du mode BICYCLE, qui couvre les transports à propulsion humaine. Non compatible avec search_along_route_parameters. Uniquement disponible dans les pays listés dans Pays et régions dans lesquels les véhicules à deux roues sont acceptés.