Index
Places
(interface)AddressDescriptor
(message)AddressDescriptor.Area
(message)AddressDescriptor.Area.Containment
(enum)AddressDescriptor.Landmark
(message)AddressDescriptor.Landmark.SpatialRelationship
(enum)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.ContainingPlace
(message)Place.GenerativeSummary
(message)Place.GoogleMapsLinks
(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)Polyline
(message)PriceLevel
(enum)PriceRange
(message)References
(message)Review
(message)RouteModifiers
(message)RoutingParameters
(message)RoutingPreference
(enum)RoutingSummary
(message)RoutingSummary.Leg
(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)SearchTextRequest.SearchAlongRouteParameters
(message)SearchTextResponse
(message)TravelMode
(enum)
Lieux
Définition du service pour l'API Places. Remarque: Chaque requête (à l'exception des requêtes de saisie semi-automatique) nécessite un masque de champ défini en dehors du protocole 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 la page https://developers.google.com/maps/documentation/places/web-service/choose-fields.
AutocompletePlaces |
---|
Renvoie les prédictions pour l'entrée donnée.
|
GetPhotoMedia |
---|
Obtenez un contenu multimédia photo avec une chaîne de référence photo.
|
GetPlace |
---|
Obtenez les informations d'un lieu en fonction de son nom de ressource, qui est une chaîne au format
|
SearchNearby |
---|
Rechercher des lieux à proximité de lieux
|
SearchText |
---|
Recherche de lieux basée sur une requête textuelle
|
AddressDescriptor
Description relationnelle d'un emplacement. Inclut un ensemble classé de repères à proximité et de zones englobantes précises, ainsi que leur relation avec l'emplacement cible.
Champs | |
---|---|
landmarks[] |
Liste classée des points d'intérêt à proximité. Les points de repère les plus reconnaissables et les plus proches sont classés en premier. |
areas[] |
Liste classée des zones contenant ou adjacentes. Les zones les plus reconnaissables et les plus précises sont classées en premier. |
Zone
Informations sur la zone et sa relation avec l'emplacement cible.
Les zones incluent des sous-localités précises, des quartiers et de grands ensembles qui sont utiles pour décrire un emplacement.
Champs | |
---|---|
name |
Nom de la ressource de la zone. |
place_id |
ID de lieu de la zone. |
display_name |
Nom à afficher de la zone. |
containment |
Définit la relation spatiale entre l'emplacement cible et la zone. |
Confinement
Définit la relation spatiale entre l'emplacement cible et la zone.
Enums | |
---|---|
CONTAINMENT_UNSPECIFIED |
La structuration n'est pas spécifiée. |
WITHIN |
L'emplacement cible se trouve dans la zone, près du centre. |
OUTSKIRTS |
L'emplacement cible se trouve dans 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 repère et sa relation avec le lieu cible.
Les repères sont des lieux importants qui peuvent être utilisés pour décrire un emplacement.
Champs | |
---|---|
name |
Nom de la ressource du repère. |
place_id |
ID du lieu du repère. |
display_name |
Nom à afficher du repère. |
types[] |
Ensemble de tags de type pour ce repère. Pour obtenir la liste complète des valeurs possibles, consultez la page https://developers.google.com/maps/documentation/places/web-service/place-types. |
spatial_relationship |
Définit la relation spatiale entre l'emplacement cible et le repère. |
straight_line_distance_meters |
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 plus longue que |
travel_distance_meters |
Distance parcourue, en mètres, le long du réseau routier entre la cible et le repère, le cas échéant. Cette valeur ne tient pas compte du mode de transport (à pied, en voiture ou à vélo, par exemple). |
SpatialRelationship
Définit la relation spatiale entre l'emplacement cible et le repère.
Enums | |
---|---|
NEAR |
Il s'agit de la relation par défaut lorsque rien de plus spécifique ci-dessous ne s'applique. |
WITHIN |
Le repère possède une géométrie spatiale et la cible se trouve dans ses limites. |
BESIDE |
La cible est directement adjacente au repère. |
ACROSS_THE_ROAD |
La cible se trouve directement en face du repère, de l'autre côté de la route. |
DOWN_THE_ROAD |
Sur le même itinéraire que le repère, mais pas à côté ni en face. |
AROUND_THE_CORNER |
Ne se trouve pas sur le même itinéraire que le repère, mais à un seul virage de distance. |
BEHIND |
Près de la structure du monument, mais plus éloigné de ses entrées de rue. |
AuthorAttribution
Informations sur l'auteur des données générées par les utilisateurs. Utilisé dans Photo
et Review
.
AutocompletePlacesRequest
Proto de requête pour AutocompletePlaces.
Champs | |
---|---|
input |
Obligatoire. Chaîne de texte à rechercher. |
location_bias |
Facultatif. Limitez les résultats à un emplacement spécifié. Vous ne devez définir qu'un seul élément |
location_restriction |
Facultatif. Limitez les résultats à un emplacement spécifié. Vous ne devez définir qu'un seul élément |
included_primary_types[] |
Facultatif. Incluez le type d'établissement principal (par exemple, "restaurant" ou "station_service") dans les types d'établissements (https://developers.google.com/maps/documentation/places/web-service/place-types), ou uniquement |
included_region_codes[] |
Facultatif. Inclure uniquement les résultats dans les régions spécifiées, jusqu'à 15 codes de région CLDR à deux caractères. Un ensemble vide ne limite pas les résultats. Si |
language_code |
Facultatif. Langue dans laquelle les résultats doivent être renvoyés. La valeur par défaut est en-US. Les résultats peuvent être dans des langues mixtes si la langue utilisée dans |
region_code |
Facultatif. Code régional, spécifié sous forme de code régional CLDR à deux caractères. Cela affecte le formatage des adresses, 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 |
origin |
Facultatif. Point d'origine à partir duquel calculer la distance géodésique jusqu'à la destination (rendue sous la forme |
input_offset |
Facultatif. Décalage de caractère Unicode basé sur zéro de Si cet élément est vide, la longueur est définie par défaut sur |
include_query_predictions |
Facultatif. Si cette valeur est définie sur "true", la réponse inclut à la fois les prédictions de lieu et de requête. Sinon, la réponse ne renverra que des prédictions de lieux. |
session_token |
Facultatif. Chaîne qui identifie une session Autocomplete à des fins de facturation. Il doit s'agir d'une chaîne base64 sécurisée pour les URL et les noms de fichiers, qui ne doit 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 Google Cloud Console. 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 vous omettez le paramètre Nous vous recommandons de respecter les consignes suivantes:
|
include_pure_service_area_businesses |
Facultatif. Inclut les établissements de services de proximité à domicile si le champ est défini sur "true". Un établissement de services de proximité à domicile 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 lieu sur Google Maps. Places ne renverra pas les champs |
LocationBias
Région à rechercher. Les résultats peuvent être biaisés dans la région spécifiée.
LocationRestriction
Région à rechercher. Les résultats seront limités à la région spécifiée.
AutocompletePlacesResponse
Proto de réponse pour AutocompletePlaces.
Champs | |
---|---|
suggestions[] |
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
|
|
place_prediction |
Prédiction pour un lieu. |
query_prediction |
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 formaté.
Champs | |
---|---|
text |
Texte pouvant être utilisé tel quel ou mis en forme avec |
matches[] |
Liste des plages de chaînes indiquant où la requête d'entrée a correspondu dans Ces valeurs correspondent aux décalages de caractères Unicode de |
PlacePrediction
Résultats de prédiction pour une prédiction Place Autocomplete.
Champs | |
---|---|
place |
Nom de la ressource du lieu suggéré. Ce nom peut être utilisé dans d'autres API qui acceptent des noms de lieux. |
place_id |
Identifiant unique du lieu suggéré. Cet identifiant peut être utilisé dans d'autres API qui acceptent les ID de lieu. |
text |
Inclut le nom lisible du résultat renvoyé. Pour les résultats d'établissement, il s'agit généralement du nom et de l'adresse de l'entreprise.
Ce texte peut différer de l' Peut être dans des langues différentes si les requêtes |
structured_format |
Décomposition de la prédiction de lieu en texte principal contenant le nom du lieu et texte secondaire contenant des éléments supplémentaires permettant de lever l'ambiguïté (comme une ville ou une région).
|
types[] |
Liste des types qui s'appliquent à ce lieu, tirée 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égorisation d'un lieu. Les lieux de même type présentent des caractéristiques similaires. |
distance_meters |
Longueur de la géodésique en mètres à partir de |
QueryPrediction
Résultats de prédiction pour une prédiction de saisie semi-automatique de requête
Champs | |
---|---|
text |
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, la recherche textuelle).
Peut être dans des langues mixtes si les requêtes |
structured_format |
Répartition de la prédiction de la requête en texte principal contenant la requête et texte secondaire contenant des éléments supplémentaires permettant de lever l'ambiguïté (comme une ville ou une région).
|
StringRange
Identifie une sous-chaîne dans un texte donné.
Champs | |
---|---|
start_offset |
Décalage basé sur zéro du premier caractère Unicode de la chaîne (inclus). |
end_offset |
Décalage du dernier caractère Unicode (à partir de zéro) (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 supplémentaires permettant de lever l'ambiguïté (comme une ville ou une région) pour identifier plus précisément le lieu ou affiner la requête.
Champs | |
---|---|
main_text |
Représente le nom du lieu ou de la requête. |
secondary_text |
Représente des éléments supplémentaires permettant de lever l'ambiguïté (comme une ville ou une région) pour identifier plus précisément le lieu ou affiner la requête. |
Cercle
Cercle avec un LatLng comme centre et rayon.
Champs | |
---|---|
center |
Obligatoire. Latitude et longitude du centre La plage de latitude doit être comprise dans la plage [-90,0, +90,0]. La plage de la longitude doit être comprise entre -180,0 et 180,0. |
radius |
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 | |
---|---|
topic |
Thème du contenu (par exemple, "présentation" ou "restaurant"). |
content |
Contenu en rapport avec le sujet. |
references |
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Références associées à ce bloc de contenu. |
ContextualContent
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
Contenu en rapport avec la requête de lieu
Champs | |
---|---|
reviews[] |
Liste des avis sur ce lieu, en fonction de la requête de lieu. |
photos[] |
Informations (y compris des références) sur les photos de ce lieu, en fonction de la requête sur le lieu. |
justifications[] |
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Justifications du lieu |
Justification
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
Justifications du lieu Les justifications répondent à la question "Pourquoi un lieu peut-il intéresser un utilisateur final ?".
Champs | |
---|---|
Champ d'union
|
|
review_justification |
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. |
business_availability_attributes_justification |
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. |
BusinessAvailabilityAttributesJustification
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Justifications des attributs BusinessAvailabilityAttributes. Il s'agit d'attributs d'un établissement qui pourraient intéresser un utilisateur final.
Champs | |
---|---|
takeout |
Indique si un établissement propose des plats à emporter. |
delivery |
Indique si un établissement propose la livraison. |
dine_in |
Indique si un établissement propose des repas sur place. |
ReviewJustification
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
Justifications des avis des utilisateurs Cela met en évidence une section de l'avis de l'utilisateur qui intéresserait un utilisateur final. Par exemple, si la requête de recherche est "pizza au feu de bois", la justification de l'avis met en avant le texte pertinent pour la requête de recherche.
Champs | |
---|---|
highlighted_text |
|
review |
Avis à partir duquel le texte mis en surbrillance est généré. |
HighlightedText
Texte mis en surbrillance 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. Plusieurs mots du texte peuvent être mis en surbrillance.
Champs | |
---|---|
text |
|
highlighted_text_ranges[] |
Liste des plages du texte mis en surbrillance. |
HighlightedTextRange
Intervalle de texte mis en surbrillance.
Champs | |
---|---|
start_index |
|
end_index |
|
EVChargeOptions
Informations sur la borne de recharge de VE hébergée dans le lieu. La terminologie suit 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 |
Nombre de prises sur cette borne. Toutefois, comme certains ports peuvent comporter plusieurs connecteurs, mais ne peuvent recharger qu'une seule 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[] |
Liste des agrégations de connecteurs de recharge de VE contenant des connecteurs du même type et du même débit de recharge. |
ConnectorAggregation
Informations sur la recharge de VE regroupées par [type, max_charge_rate_kw]. Indique l'agrégation de la recharge des VE pour les connecteurs du même type et du même débit de recharge maximal en kW.
Champs | |
---|---|
type |
Type de connecteur de cette agrégation. |
max_charge_rate_kw |
Taux de recharge maximal statique en kW de chaque connecteur de l'agrégation. |
count |
Nombre de connecteurs dans cette agrégation. |
availability_last_update_time |
Code temporel de la dernière mise à jour des informations de disponibilité des connecteurs dans cette agrégation. |
available_count |
Nombre de connecteurs actuellement disponibles dans cette agrégation. |
out_of_service_count |
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 de type 2 conforme à la norme CEI 62196. On parle souvent de MENNEKES. |
EV_CONNECTOR_TYPE_CHADEMO |
Connecteur de type CHAdeMO. |
EV_CONNECTOR_TYPE_CCS_COMBO_1 |
Système de recharge combiné (AC et DC) D'après SAE. Connecteur J-1772 de type 1 |
EV_CONNECTOR_TYPE_CCS_COMBO_2 |
Système de recharge combiné (AC et DC) 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 format dans d'autres régions du monde (par exemple, CCS Combo 2 (CCS2) ou GB/T). Cette valeur représente moins un type de connecteur réel que la possibilité de recharger un véhicule de la marque Tesla sur 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. |
EV_CONNECTOR_TYPE_NACS |
Le système de recharge nord-américain (NACS), normalisé en tant que SAE J3400. |
FuelOptions
Informations les plus récentes sur les carburants disponibles dans une station-service. Ces informations sont mises à jour régulièrement.
Champs | |
---|---|
fuel_prices[] |
Dernier prix connu du carburant pour chaque type de carburant disponible dans cette station-service. 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é.
FuelType
Types de carburants
Enums | |
---|---|
FUEL_TYPE_UNSPECIFIED |
Type de carburant non spécifié. |
DIESEL |
Carburant diesel |
DIESEL_PLUS |
Diesel plus carburant. |
REGULAR_UNLEADED |
Essence sans plomb ordinaire |
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 |
Gaz de pétrole liquéfié |
E80 |
E 80. |
E85 |
E 85. |
E100 |
E 100. |
METHANE |
Méthane |
BIO_DIESEL |
Biodiesel |
TRUCK_DIESEL |
Diesel de camion. |
GetPhotoMediaRequest
Requête visant à extraire une photo d'un lieu à l'aide d'un nom de ressource photo.
Champs | |
---|---|
name |
Obligatoire. Nom de la ressource d'un contenu multimédia photo au format: Le nom de la ressource d'une photo renvoyé dans le champ |
max_width_px |
Facultatif. Indique 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 des dimensions, elle sera redimensionnée 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 l'un des éléments suivants : "max_height_px" ou "max_width_px". Si ni "max_height_px" ni "max_width_px" n'est spécifié, une erreur INVALID_ARGUMENT est renvoyée. |
max_height_px |
Facultatif. Indique 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 des dimensions, elle sera redimensionnée 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 l'un des éléments suivants : "max_height_px" ou "max_width_px". Si ni "max_height_px" ni "max_width_px" n'est spécifié, une erreur INVALID_ARGUMENT est renvoyée. |
skip_http_redirect |
Facultatif. Si cette valeur 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 cette valeur n'est pas définie, une redirection HTTP est émise pour rediriger l'appel vers le support multimédia de l'image. Cette option est ignorée pour les requêtes non HTTP. |
GetPlaceRequest
Requête de récupération d'un lieu en fonction de son nom de ressource, qui est une chaîne au format places/{place_id}
.
Champs | |
---|---|
name |
Obligatoire. Nom de la ressource d'un lieu, au format |
language_code |
Facultatif. Les informations sur le lieu s'affichent dans la langue préférée, le cas échéant. Liste actuelle des langues disponibles: https://developers.google.com/maps/faq#languagesupport. |
region_code |
Facultatif. Code de pays/région Unicode (CLDR) de l'emplacement d'où provient la requête. Ce paramètre permet d'afficher les détails du lieu, comme le nom du lieu spécifique à la 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 de région à trois chiffres ne sont pas acceptés pour le moment. |
session_token |
Facultatif. Chaîne qui identifie une session Autocomplete à des fins de facturation. Il doit s'agir d'une chaîne base64 sécurisée pour les URL et les noms de fichiers, qui ne doit 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 Google Cloud Console. 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 vous omettez le paramètre Nous vous recommandons de respecter les consignes suivantes:
|
Photo
Informations sur une photo d'un lieu
Champs | |
---|---|
name |
Identifiant. Référence représentant cette photo de lieu, qui peut être utilisée pour la rechercher à nouveau (également appelée "ressource" de l'API: |
width_px |
Largeur maximale disponible, en pixels. |
height_px |
Hauteur maximale disponible, en pixels. |
author_attributions[] |
Auteurs de cette photo |
flag_content_uri |
Lien permettant aux utilisateurs de signaler un problème avec la photo. |
google_maps_uri |
Lien permettant d'afficher la photo sur Google Maps. |
PhotoMedia
Contenu multimédia photo de l'API Places.
Champs | |
---|---|
name |
Nom de la ressource d'un contenu multimédia photo au format: |
photo_uri |
URI à courte durée de vie pouvant être utilisé pour afficher la photo. |
Lieu
Toutes les informations représentant un lieu.
Champs | |
---|---|
name |
Nom de la ressource de cet établissement, au format |
id |
Identifiant unique d'un lieu. |
display_name |
Nom localisé du lieu, qui peut servir de courte description lisible par l'humain. (par exemple, "Google Sydney", "Starbucks", "Pyrmont", etc.) |
types[] |
Ensemble de balises de type pour ce résultat. (par exemple, "politique" et "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 |
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. |
primary_type_display_name |
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. |
national_phone_number |
Numéro de téléphone lisible du lieu, au format national. |
international_phone_number |
Numéro de téléphone intelligible du lieu, au format international. |
formatted_address |
Adresse complète et lisible de ce lieu. |
short_formatted_address |
Adresse courte et lisible de cet établissement. |
address_components[] |
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 composants d'adresse 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 |
Plus Code de la latitude et de la longitude du lieu |
location |
Position de cet établissement. |
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 |
Note comprise entre 1,0 et 5,0, basée sur les avis des utilisateurs sur ce lieu. |
google_maps_uri |
URL fournissant plus d'informations sur ce lieu. |
website_uri |
Site Web faisant autorité pour ce lieu, par exemple la page d'accueil d'un établissement. Notez que pour les lieux qui font 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 la chaîne dans son ensemble. |
reviews[] |
Liste des avis sur cet établissement, triés par pertinence. Vous ne pouvez pas renvoyer plus de cinq avis. |
regular_opening_hours |
Horaires d'ouverture habituels. Notez que si un établissement est toujours ouvert (24 heures sur 24), le champ |
time_zone |
Fuseau horaire de la base de données des fuseaux horaires IANA. Par exemple, "Amérique/New_York". |
photos[] |
Informations (y compris références) sur les photos de ce lieu Vous pouvez renvoyer jusqu'à 10 photos. |
adr_format_address |
Adresse de l'établissement au format microformat ADR: http://microformats.org/wiki/adr. |
business_status |
État de l'établissement pour le lieu. |
price_level |
Niveau de prix du lieu. |
attributions[] |
Ensemble de fournisseurs de données à afficher avec ce résultat. |
icon_mask_base_uri |
URL tronquée d'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 |
Couleur d'arrière-plan pour icon_mask au format hexadécimal, par exemple #909CE1. |
current_opening_hours |
Les horaires d'ouverture pour les sept prochains jours (aujourd'hui inclus) La période commence à minuit le jour de la demande et se termine à 23h59 six jours plus tard. Ce champ inclut le sous-champ "special_days" de tous les horaires, défini pour les dates pour lesquelles des horaires exceptionnels sont définis. |
current_secondary_opening_hours[] |
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 de son drive ou de sa 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 l'établissement. Ce champ inclut le sous-champ "special_days" de tous les horaires, défini pour les dates pour lesquelles des horaires exceptionnels sont définis. |
regular_secondary_opening_hours[] |
Contient un tableau d'entrées pour les horaires secondaires habituels d'un établissement. Les horaires secondaires sont différents des horaires principaux d'un établissement. Par exemple, un restaurant peut indiquer les horaires de son drive ou de sa 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 l'établissement. |
editorial_summary |
Contient un résumé de l'établissement. Un résumé comprend une présentation textuelle et le code de langue correspondant, le cas échéant. Le texte récapitulatif doit être présenté tel quel et ne peut pas être modifié. |
payment_options |
Options de paiement acceptées par l'établissement Si les données d'une option de paiement ne sont pas disponibles, le champ de l'option de paiement n'est pas défini. |
parking_options |
Options de stationnement proposées par l'établissement. |
sub_destinations[] |
Liste des sous-destinations associées au lieu. |
fuel_options |
Informations les plus récentes sur les carburants disponibles dans une station-service. Ces informations sont mises à jour régulièrement. |
ev_charge_options |
Informations sur les options de recharge de VE |
generative_summary |
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Résumé de l'établissement généré par IA. |
area_summary |
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Résumé généré par IA de la zone dans laquelle se trouve le lieu. |
containing_places[] |
Liste des lieux dans lesquels se trouve l'emplacement actuel. |
address_descriptor |
Déscripteur 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. Pour connaître la couverture régionale des descripteurs d'adresse, consultez https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage. |
google_maps_links |
Liens permettant de déclencher différentes actions Google Maps. |
price_range |
Plage de prix associée à un lieu. |
utc_offset_minutes |
Nombre de minutes de décalage horaire actuel du lieu par rapport à UTC. Il est exprimé en minutes pour prendre en charge les fuseaux horaires décalés de fractions d'heure, par exemple X heures et 15 minutes. |
user_rating_count |
Nombre total d'avis (avec ou sans texte) pour cet établissement. |
takeout |
Indique si l'établissement propose des plats à emporter. |
delivery |
Indique si l'établissement propose la livraison. |
dine_in |
Indique si l'établissement propose des options de places assises à l'intérieur ou à l'extérieur. |
curbside_pickup |
Indique si l'établissement propose le retrait en drive. |
reservable |
Indique si l'établissement accepte les réservations. |
serves_breakfast |
Indique si l'établissement sert le petit-déjeuner. |
serves_lunch |
Indique si l'établissement sert à déjeuner. |
serves_dinner |
Indique si l'établissement sert à dîner. |
serves_beer |
Indique si l'établissement sert de la bière. |
serves_wine |
Indique si l'établissement propose du vin. |
serves_brunch |
Indique si l'établissement sert des brunchs. |
serves_vegetarian_food |
Indique si l'établissement propose des plats végétariens. |
outdoor_seating |
L'établissement dispose d'une terrasse. |
live_music |
Le lieu propose des concerts. |
menu_for_children |
L'établissement propose un menu enfant. |
serves_cocktails |
L'établissement sert des cocktails. |
serves_dessert |
L'établissement propose des desserts. |
serves_coffee |
L'établissement sert du café. |
good_for_children |
L'endroit est adapté aux enfants. |
allows_dogs |
Les chiens sont acceptés. |
restroom |
L'établissement dispose de toilettes. |
good_for_groups |
L'établissement accepte les groupes. |
good_for_watching_sports |
L'établissement est adapté pour regarder des événements sportifs. |
accessibility_options |
Informations sur les options d'accessibilité proposées par un lieu. |
pure_service_area_business |
Indique si l'établissement est un établissement de services de proximité à domicile. Un établissement de services de proximité à domicile 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 qu'ils n'aient pas d'adresse physique ou d'emplacement sur Google Maps. |
AccessibilityOptions
Informations sur les options d'accessibilité proposées par un lieu.
Champs | |
---|---|
wheelchair_accessible_parking |
L'établissement propose un parking accessible en fauteuil roulant. |
wheelchair_accessible_entrance |
L'établissement dispose d'une entrée accessible en fauteuil roulant. |
wheelchair_accessible_restroom |
L'établissement dispose de toilettes accessibles en fauteuil roulant. |
wheelchair_accessible_seating |
L'établissement propose des places assises accessibles en fauteuil roulant. |
AddressComponent
Composants structurés qui constituent l'adresse mise en forme, le cas échéant.
Champs | |
---|---|
long_text |
Description complète ou nom du composant d'adresse. Par exemple, un composant d'adresse pour l'Australie peut avoir "Australie" comme long_name. |
short_text |
Nom textuel abrégé du composant d'adresse, s'il est disponible. Par exemple, un composant d'adresse pour l'Australie peut avoir "AU" comme short_name. |
types[] |
Tableau indiquant le ou les types du composant d'adresse. |
language_code |
Langue utilisée pour mettre en forme ces composants, en notation CLDR. |
AreaSummary
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
Résumé généré par IA de la zone dans laquelle se trouve le lieu.
Champs | |
---|---|
content_blocks[] |
Blocs de contenu qui composent le récapitulatif de l'emplacement. Chaque bloc comporte un sujet distinct sur la zone. |
flag_content_uri |
Lien permettant aux utilisateurs de signaler un problème avec le résumé. |
Attribution
Informations sur les fournisseurs de données de cet établissement.
Champs | |
---|---|
provider |
Nom du fournisseur de données du lieu. |
provider_uri |
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 nécessairement ouvert pour le moment. |
CLOSED_TEMPORARILY |
L'établissement est temporairement fermé. |
CLOSED_PERMANENTLY |
L'établissement est fermé définitivement. |
ContainingPlace
Informations sur le lieu dans lequel se trouve ce lieu.
Champs | |
---|---|
name |
Nom de la ressource du lieu dans lequel se trouve cet établissement. |
id |
ID du lieu dans lequel se trouve cet établissement. |
GenerativeSummary
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
Résumé de l'établissement généré par IA.
Champs | |
---|---|
overview |
Présentation du lieu. |
overview_flag_content_uri |
Lien permettant aux utilisateurs de signaler un problème dans le résumé de la vue d'ensemble. |
description |
Description détaillée du lieu. |
description_flag_content_uri |
Lien permettant aux utilisateurs de signaler un problème avec le résumé de la description. |
references |
Références utilisées pour générer la description récapitulative. |
GoogleMapsLinks
Liens permettant de déclencher différentes actions Google Maps.
Champs | |
---|---|
directions_uri |
Lien permettant d'afficher l'itinéraire vers l'établissement. Le lien ne renseigne que l'emplacement de la destination et utilise le mode de transport par défaut |
place_uri |
Lien permettant d'afficher ce lieu. |
write_a_review_uri |
Lien permettant de rédiger un avis sur ce lieu. Ce lien n'est actuellement pas compatible avec Google Maps pour mobile et ne fonctionne que dans la version Web de Google Maps. |
reviews_uri |
Lien permettant d'afficher les avis sur ce lieu. Ce lien n'est actuellement pas compatible avec Google Maps pour mobile et ne fonctionne que dans la version Web de Google Maps. |
photos_uri |
Lien permettant d'afficher des photos de ce lieu. Ce lien n'est actuellement pas compatible avec Google Maps pour mobile et ne fonctionne que dans la version Web de Google Maps. |
OpeningHours
Informations sur les horaires d'ouverture de l'établissement.
Champs | |
---|---|
periods[] |
Périodes pendant lesquelles cet établissement est ouvert en semaine. Les périodes sont affichées dans l'ordre chronologique, en commençant par le dimanche dans le fuseau horaire local. Une valeur vide (mais pas absente) indique un lieu qui n'est jamais ouvert, par exemple s'il est temporairement fermé pour rénovation. |
weekday_descriptions[] |
Chaînes localisées décrivant les horaires d'ouverture de cet établissement, une chaîne pour chaque jour de la semaine. Ce champ est vide si les heures sont inconnues ou ne peuvent pas être converties en texte localisé. Exemple : "Dimanche : 18h00 à 6h00" |
secondary_hours_type |
Chaîne de type utilisée pour identifier le type d'heures secondaires. |
special_days[] |
Informations structurées pour les jours spéciaux compris 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 établissement (par exemple, le jour de Noël). Définissez-le pour current_opening_hours et current_secondary_opening_hours si des horaires exceptionnels s'appliquent. |
next_open_time |
Date de début de la période d'ouverture actuelle, jusqu'à sept jours à l'avance. Ce champ n'est renseigné que si la période d'ouverture n'est pas active au moment de la diffusion de la requête. |
next_close_time |
La prochaine fois que la période des horaires d'ouverture actuels se terminera, dans un délai maximal 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 |
Indique si la période d'ouverture est actuellement active. Pour les horaires d'ouverture habituels et les horaires d'ouverture actuels, ce champ indique si l'établissement est ouvert. Pour les horaires d'ouverture secondaires et les horaires d'ouverture secondaires actuels, ce champ indique si les horaires secondaires de cet établissement sont actifs. |
Période
Période pendant laquelle le lieu reste ouvert.
Point
Points de changement d'état.
Champs | |
---|---|
date |
Date dans le fuseau horaire local de l'établissement. |
truncated |
Indique si ce point de terminaison a été tronqué ou non. Le troncage se produit lorsque les heures réelles se situent en dehors des limites que nous sommes prêts à renvoyer. Nous les tronquons donc à ces limites. Vous vous assurez ainsi que 24 * 7 heures maximum sont renvoyées à partir de minuit le jour de la demande. |
day |
Jour de la semaine, sous la forme d'un entier compris entre 0 et 6. 0 représente dimanche, 1 représente lundi, etc. |
hour |
Heure au format 24 heures. Les valeurs vont de 0 à 23. |
minute |
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 de service en drive pour les banques, les restaurants ou les pharmacies. |
HAPPY_HOUR |
L'happy hour. |
DELIVERY |
Heure de livraison. |
TAKEOUT |
Heure de la 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 |
Horaires d'accès aux lieux de stockage. |
SENIOR_HOURS |
Les horaires d'ouverture exceptionnels pour les personnes âgées. |
ONLINE_SERVICE_HOURS |
Horaires d'ouverture du service en ligne. |
SpecialDay
Informations structurées pour les jours spéciaux compris 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 établissement (par exemple, le jour de Noël).
Champs | |
---|---|
date |
Date de ce jour spécial. |
ParkingOptions
Informations sur les options de stationnement du lieu. Un parking peut accepter plusieurs options en même temps.
Champs | |
---|---|
free_parking_lot |
Le lieu dispose de parkings sans frais. |
paid_parking_lot |
Le lieu propose des parkings payants. |
free_street_parking |
Le parking dans la rue est sans frais. |
paid_street_parking |
Le parking est payant dans la rue. |
valet_parking |
Un parking avec service de voiturier est disponible. |
free_garage_parking |
Le parking couvert est sans frais. |
paid_garage_parking |
Un parking couvert payant est disponible. |
PaymentOptions
Options de paiement acceptées par l'établissement
Champs | |
---|---|
accepts_credit_cards |
L'établissement accepte les cartes de crédit comme mode de paiement. |
accepts_debit_cards |
L'établissement accepte les cartes de débit comme mode de paiement. |
accepts_cash_only |
Le lieu n'accepte que les espèces comme mode de paiement. Les établissements associés à cet attribut peuvent toutefois accepter d'autres modes de paiement. |
accepts_nfc |
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 moins, et un code composé, qui remplace le préfixe par un lieu de référence.
Champs | |
---|---|
global_code |
Code global (complet) du lieu, par exemple "9FWM33GV+HQ", représentant une zone de 1/8 000e de degré par 1/8 000e de degré (environ 14 m x 14 m). |
compound_code |
Code composé du lieu, par exemple "33GV+HQ, Ramberg, Norway ", 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. |
SubDestination
Les sous-destinations sont des lieux spécifiques associés à un lieu principal. Ils fournissent des destinations plus spécifiques aux utilisateurs qui recherchent 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 de lieu et le nom de la ressource de lieu, qui peuvent être utilisés dans les requêtes Place Details (New) ultérieures pour extraire des informations plus détaillées, y compris le nom à afficher et l'emplacement de la sous-destination.
Champs | |
---|---|
name |
Nom de la ressource de la sous-destination. |
id |
ID du lieu de la sous-destination. |
Polyline
Polyligne de parcours. Compatible uniquement avec une polyligne encodée, qui 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 |
Une polyligne encodée, telle que renvoyée par l'API Routes par défaut. Consultez les outils encodeur et décodeur. |
PriceLevel
Niveau de prix du lieu.
Enums | |
---|---|
PRICE_LEVEL_UNSPECIFIED |
Le niveau de prix de l'établissement n'est pas spécifié ou est inconnu. |
PRICE_LEVEL_FREE |
L'établissement propose des services sans frais. |
PRICE_LEVEL_INEXPENSIVE |
L'établissement propose des services abordables. |
PRICE_LEVEL_MODERATE |
L'établissement propose des services à des prix raisonnables. |
PRICE_LEVEL_EXPENSIVE |
L'établissement propose des services onéreux. |
PRICE_LEVEL_VERY_EXPENSIVE |
L'établissement propose des services très onéreux. |
PriceRange
Plage 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 $").
Références
Fonctionnalité expérimentale: pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
Référence à laquelle le contenu génératif est associé.
Champs | |
---|---|
reviews[] |
Avis qui servent de références |
places[] |
Liste des noms de ressources des lieux référencés. Ce nom peut être utilisé dans d'autres API qui acceptent des noms de ressources Place. |
Récapitulatif
Informations sur un avis sur un lieu
Champs | |
---|---|
name |
Référence représentant cet avis sur un lieu, qui peut être utilisée pour le rechercher à nouveau (également appelé "ressource" de l'API: |
relative_publish_time_description |
Chaîne d'heure récente mise en forme, exprimant l'heure de l'avis par rapport à l'heure actuelle dans un format adapté à la langue et au pays. |
text |
Texte localisé de l'avis. |
original_text |
Texte de l'avis dans sa langue d'origine. |
rating |
Nombre compris entre 1,0 et 5,0, également appelé nombre d'étoiles. |
author_attribution |
Auteur de cet avis. |
publish_time |
Code temporel de l'avis. |
flag_content_uri |
Lien permettant aux utilisateurs de signaler un problème avec l'avis |
google_maps_uri |
Lien permettant d'afficher l'avis sur Google Maps. |
RouteModifiers
Encapsule un ensemble de conditions facultatives à respecter lors du calcul des itinéraires.
Champs | |
---|---|
avoid_tolls |
Facultatif. Si cette valeur est définie sur "true", les routes à péage sont évitées dans la mesure du possible, et les itinéraires sans route à péage sont privilégiés. S'applique uniquement aux |
avoid_highways |
Facultatif. Si cette valeur est définie sur "true", les itinéraires sans voies rapides sont privilégiés. S'applique uniquement aux |
avoid_ferries |
Facultatif. Si cette valeur est définie sur "true", les ferries sont évités dans la mesure du possible, et les itinéraires sans ferry sont privilégiés. S'applique uniquement aux |
avoid_indoor |
Facultatif. Si cette valeur est définie sur "True", la navigation en intérieur est évitée dans la mesure du possible, et les itinéraires ne comportant pas de navigation en intérieur sont privilégiés. Ne s'applique qu'à |
RoutingParameters
Paramètres permettant de configurer les calculs d'itinéraire 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 des résultats.
Champs | |
---|---|
origin |
Facultatif. Point de départ 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 |
Facultatif. Mode de transport. |
route_modifiers |
Facultatif. Modificateurs de l'itinéraire. |
routing_preference |
Facultatif. Indique comment calculer les récapitulatifs de routage. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer l'itinéraire. La préférence de routage tenant compte du trafic n'est disponible que pour les |
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'est 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 circulation n'ont pas d'importance ou ne s'appliquent pas. Cette valeur offre la latence la plus faible. Remarque: Pour , 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 des performances. Cette valeur génère la latence la plus élevée. |
RoutingSummary
Durée et distance entre le point de départ du calcul d'itinéraire et un lieu dans la réponse, ainsi qu'une deuxième étape entre ce lieu et la destination, le cas échéant. Remarque:L'ajout de routingSummaries
dans le masque de champ sans inclure le paramètre routingParameters.origin
ou le paramètre searchAlongRouteParameters.polyline.encodedPolyline
dans la requête génère une erreur.
Champs | |
---|---|
legs[] |
Les étapes du trajet. Lorsque vous calculez la durée et la distance du trajet à partir d'un point de départ défini, |
directions_uri |
Lien permettant d'afficher un itinéraire dans Google Maps à l'aide des points de cheminement du récapitulatif d'itinéraire donné. Il n'est pas garanti que le parcours généré par ce lien soit identique à celui utilisé pour générer le résumé du parcours. Le lien utilise les informations fournies dans la requête, à partir de champs tels que |
Pied
Une étape correspond à une partie d'un trajet entre un point de départ et une destination.
Champs | |
---|---|
duration |
Temps nécessaire pour effectuer cette partie du trajet. |
distance_meters |
Distance de cette étape du trajet. |
SearchNearbyRequest
Fichier proto de requête pour Nearby Search.
Champs | |
---|---|
language_code |
Les informations sur le lieu s'affichent 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 dans n'importe quelle langue peuvent être renvoyées, en privilégiant l'anglais si de telles informations existent. Liste actuelle des langues disponibles: https://developers.google.com/maps/faq#languagesupport. |
region_code |
Code de pays/région Unicode (CLDR) de l'emplacement d'où provient la requête. Ce paramètre permet d'afficher les détails du lieu, comme le nom du lieu spécifique à la 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 de région à trois chiffres ne sont pas acceptés pour le moment. |
included_types[] |
Type d'établissement inclus (par exemple, "restaurant" ou "station_service") sur https://developers.google.com/maps/documentation/places/web-service/place-types. Vous pouvez spécifier jusqu'à 50 types de la table A. Si des types sont en conflit, c'est-à-dire qu'un type apparaît à la fois dans "included_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 répondent à toutes les restrictions sont renvoyés. Par exemple, si nous avons {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, les lieux affichés proposent des services liés aux restaurants, mais ne sont pas principalement des restaurants. |
excluded_types[] |
Type d'établissement exclu (par exemple, "restaurant" ou "station_service") sur https://developers.google.com/maps/documentation/places/web-service/place-types. Vous pouvez spécifier jusqu'à 50 types de la table A. Si le client fournit à la fois included_types (par exemple, "restaurant") et excluded_types (par exemple, "café"), la réponse doit inclure les établissements qui sont des restaurants, mais pas des cafés. La réponse inclut les lieux correspondant à 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 "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 affichés proposent des services liés aux restaurants, mais ne sont pas principalement des restaurants. |
included_primary_types[] |
Type d'établissement principal inclus (par exemple, "restaurant" ou "station_service") sur https://developers.google.com/maps/documentation/places/web-service/place-types. Un lieu ne peut être associé qu'à un seul type principal de la table des types acceptés. Vous pouvez spécifier jusqu'à 50 types de la table A. Si des types principaux sont en conflit, c'est-à-dire qu'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 affichés proposent des services liés aux restaurants, mais ne sont pas principalement des restaurants. |
excluded_primary_types[] |
Type d'établissement principal exclu (par exemple, "restaurant" ou "station_service") de https://developers.google.com/maps/documentation/places/web-service/place-types. Vous pouvez spécifier jusqu'à 50 types de la table A. Si des types principaux sont en conflit, c'est-à-dire qu'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 affichés proposent des services liés aux restaurants, mais ne sont pas principalement des restaurants. |
max_result_count |
Nombre maximal de résultats sur une page. Il doit être compris entre 1 et 20 (par défaut), inclus. Si le nombre n'est pas défini, la valeur par défaut est la limite supérieure. Si le nombre est défini sur une valeur négative ou dépasse la limite supérieure, une erreur INVALID_ARGUMENT est renvoyée. |
location_restriction |
Obligatoire. Région à rechercher. |
rank_preference |
Méthode de classement des résultats dans la réponse. |
routing_parameters |
Facultatif. Paramètres qui affectent l'acheminement vers les résultats de recherche. |
LocationRestriction
Région à rechercher.
Champs | |
---|---|
Champ d'union
|
|
circle |
Cercle défini par un point central et un rayon. |
RankPreference
Méthode de classement des résultats dans la réponse.
Enums | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
Valeur RankPreference non définie. Par défaut, l'ordre est basé sur la popularité. |
DISTANCE |
Classifie les résultats par distance. |
POPULARITY |
Classement des résultats par popularité. |
SearchNearbyResponse
Proto de réponse pour la recherche à proximité.
Champs | |
---|---|
places[] |
Liste des lieux répondant aux exigences de l'utilisateur, comme les types de lieux, le nombre de lieux et les restrictions géographiques spécifiques. |
routing_summaries[] |
Liste des récapitulatifs d'itinéraires, où chaque entrée est associée au lieu correspondant au même indice dans le champ |
SearchTextRequest
Requête d'un protocole pour SearchText.
Champs | |
---|---|
text_query |
Obligatoire. Requête textuelle pour la recherche textuelle. |
language_code |
Les informations sur le lieu s'affichent 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 dans n'importe quelle langue peuvent être renvoyées, en privilégiant l'anglais si de telles informations existent. Liste actuelle des langues disponibles: https://developers.google.com/maps/faq#languagesupport. |
region_code |
Code de pays/région Unicode (CLDR) de l'emplacement d'où provient la requête. Ce paramètre permet d'afficher les détails du lieu, comme le nom du lieu spécifique à la 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 de région à trois chiffres ne sont pas acceptés pour le moment. |
rank_preference |
Méthode de classement des résultats dans la réponse. |
included_type |
Type de lieu demandé. Liste complète des types acceptés: https://developers.google.com/maps/documentation/places/web-service/place-types. N'accepte qu'un seul type inclus. |
open_now |
Permet de limiter la recherche aux lieux qui sont actuellement ouverts. La valeur par défaut est "false" (inactif). |
min_rating |
Filtrez les résultats dont la note moyenne est strictement inférieure à cette limite. Une valeur valide doit être une valeur flottante comprise entre 0 et 5 (inclus) à une cadence de 0,5, c'est-à-dire [0, 0,5, 1,0, ..., 5,0] inclus. La note saisie est arrondie à la décimale la plus proche(plafond). Par exemple, une note de 0,6 élimine tous les résultats dont la note est inférieure à 1,0. |
max_result_count |
Obsolète: utilisez Nombre maximal de résultats par page pouvant être renvoyés. Si le nombre de résultats disponibles est supérieur à Si les options |
page_size |
Facultatif. Nombre maximal de résultats par page pouvant être renvoyés. Si le nombre de résultats disponibles est supérieur à Si les options |
page_token |
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 |
price_levels[] |
Permet de limiter la recherche aux établissements associés à 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 |
Permet de définir un filtrage strict du type pour "included_type". Si cette valeur est définie sur "true", seuls les résultats du même type seront renvoyés. La valeur par défaut est "false". |
location_bias |
Région à rechercher. Cet emplacement sert de biais, ce qui signifie que des résultats autour de cet emplacement peuvent être renvoyés. Ne peut pas être défini avec "location_restriction". |
location_restriction |
Région à rechercher. Cet emplacement sert de restriction, ce qui signifie que les résultats en dehors de l'emplacement donné ne seront pas renvoyés. Ne peut pas être défini avec "location_bias". |
ev_options |
Facultatif. Définissez les options de recherche EV d'une requête de recherche de lieu. |
routing_parameters |
Facultatif. Paramètres supplémentaires pour acheminer vers les résultats. |
search_along_route_parameters |
Facultatif. Proto de paramètres supplémentaires pour la recherche sur un trajet. |
include_pure_service_area_businesses |
Facultatif. Inclut les établissements de services de proximité à domicile si le champ est défini sur "true". Un établissement de services de proximité à domicile 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 lieu sur Google Maps. Places ne renverra pas les champs |
EVOptions
Options de VE disponibles à rechercher dans une requête de recherche de lieu.
Champs | |
---|---|
minimum_charging_rate_kw |
Facultatif. Taux de recharge minimal requis en kilowatts. Les lieux dont le tarif de recharge est inférieur au tarif spécifié sont filtrés. |
connector_types[] |
Facultatif. Liste des types de connecteurs de VE privilégiés. Les lieux qui ne sont compatibles avec aucun des types de connecteurs listés sont filtrés. |
LocationBias
Région à rechercher. Cet emplacement sert de biais, ce qui signifie que des résultats autour de cet emplacement peuvent être renvoyés.
Champs | |
---|---|
Champ d'union
|
|
rectangle |
Cadre rectangulaire défini par les angles nord-est et sud-ouest. |
circle |
Cercle défini par un point central et un rayon. |
LocationRestriction
Région à rechercher. Cet emplacement sert de restriction, ce qui signifie que les résultats en dehors de l'emplacement donné ne seront pas renvoyés.
Champs | |
---|---|
Champ d'union
|
|
rectangle |
Cadre rectangulaire défini par les angles nord-est et sud-ouest. |
RankPreference
Méthode 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 l'option par défaut. Pour les requêtes non catégoriques telles que "Mountain View, CA", nous vous recommandons de ne pas définir rankPreference. |
DISTANCE |
Classifie les résultats par distance. |
RELEVANCE |
Classement des 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. Effectuer une recherche le long d'un itinéraire est semblable à utiliser l'option de requête locationBias
ou locationRestriction
pour biaiser les résultats de recherche. Toutefois, alors que les options locationBias
et locationRestriction
vous permettent de spécifier une région pour biaiser les résultats de recherche, cette option vous permet de biaiser les résultats sur un trajet.
Les résultats ne sont pas nécessairement situés sur l'itinéraire fourni, mais sont classés dans la zone de recherche définie par la polyligne et, éventuellement, par les locationBias
ou locationRestriction
en fonction des temps de déviation minimaux entre le point de départ et la destination. Les résultats peuvent suivre un itinéraire bis, en particulier si la polyligne fournie ne définit pas un itinéraire optimal entre le point de départ et la destination.
Champs | |
---|---|
polyline |
Obligatoire. Polyligne du trajet. |
SearchTextResponse
Protocole de réponse pour SearchText.
Champs | |
---|---|
places[] |
Liste des lieux qui répondent aux critères de recherche textuelle de l'utilisateur. |
routing_summaries[] |
Liste des récapitulatifs d'itinéraires, où chaque entrée est associée au lieu correspondant au même indice dans le champ |
contextual_contents[] |
Fonctionnalité expérimentale: 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 dans le même index du champ "lieux". Les contenus pertinents pour l' |
next_page_token |
Jeton pouvant être envoyé en tant que |
search_uri |
Un lien permet à l'utilisateur de rechercher avec la même requête textuelle que celle spécifiée dans la requête sur Google Maps. |
TravelMode
Options de mode de transport. Ces options correspondent à ce que propose l'API Routes.
Enums | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
Aucun mode de transport n'est spécifié. La valeur par défaut est DRIVE . |
DRIVE |
Se déplacer en voiture de tourisme |
BICYCLE |
Se déplacer à 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 à deux roues motorisés de toutes sortes, comme les scooters et les motos. Notez que ce mode de transport est différent du mode de transport BICYCLE , qui couvre les transports à propulsion humaine. Non compatible avec search_along_route_parameters . Disponible uniquement dans les pays listés dans la section Pays et régions dans lesquels les véhicules à deux roues sont acceptés. |