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.Attribution
(message)Place.BusinessStatus
(enum)Place.ConsumerAlert
(message)Place.ConsumerAlert.Details
(message)Place.ConsumerAlert.Details.Link
(message)Place.ContainingPlace
(message)Place.EvChargeAmenitySummary
(message)Place.GenerativeSummary
(message)Place.GoogleMapsLinks
(message)Place.NeighborhoodSummary
(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.ReviewSummary
(message)Place.SubDestination
(message)Polyline
(message)PriceLevel
(enum)PriceRange
(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 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 |
---|
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 détails d'un lieu en fonction de son nom de ressource, qui est une chaîne au format
|
SearchNearby |
---|
Recherchez des lieux à proximité d'adresses.
|
SearchText |
---|
Recherche de lieux basée sur une requête textuelle.
|
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[] |
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[] |
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 |
Nom de 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 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 |
Nom de ressource du point de repère. |
place_id |
ID de lieu du point de repère. |
display_name |
Nom à afficher du point de repère. |
types[] |
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 |
Définit la relation spatiale entre le lieu cible et le point de 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 supérieure à |
travel_distance_meters |
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 |
|
uri |
|
photo_uri |
|
AutocompletePlacesRequest
Requête proto pour AutocompletePlaces.
Champs | |
---|---|
input |
Obligatoire. Chaîne de texte sur laquelle effectuer la recherche. |
location_bias |
Facultatif. Limiter les résultats à un lieu spécifié. Vous ne devez définir qu'un seul élément |
location_restriction |
Facultatif. Limiter les résultats à un emplacement spécifié Vous ne devez définir qu'un seul élément |
included_primary_types[] |
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 |
included_region_codes[] |
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 |
language_code |
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 |
region_code |
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 |
origin |
Facultatif. Point d'origine à partir duquel calculer la distance géodésique jusqu'à la destination (renvoyée sous la forme |
input_offset |
Facultatif. Décalage de caractère Unicode basé sur zéro ( Si ce champ est vide, la valeur par défaut est la longueur de |
include_query_predictions |
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 |
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 Nous vous recommandons de respecter les consignes suivantes:
|
include_pure_service_area_businesses |
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 |
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
|
|
rectangle |
Fenêtre d'affichage définie par un angle nord-est et un angle sud-ouest. |
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
|
|
rectangle |
Fenêtre d'affichage définie par un angle nord-est et un angle sud-ouest. |
circle |
Cercle défini par un point central et un rayon. |
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 mis en forme.
Champs | |
---|---|
text |
Texte qui peut être utilisé tel quel ou mis en forme avec |
matches[] |
Liste des plages de chaînes identifiant les correspondances de la requête d'entrée dans Ces valeurs sont des décalages de caractères Unicode de |
PlacePrediction
Résultats de prédiction pour une prédiction Place Autocomplete.
Champs | |
---|---|
place |
Nom de ressource du lieu suggéré. Ce nom peut être utilisé dans d'autres API qui acceptent les 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 |
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.
Il peut différer du La réponse peut être dans plusieurs langues si la demande |
structured_format |
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).
|
types[] |
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 |
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 qui pourrait être utilisée dans un point de terminaison de recherche (par exemple, la recherche de texte).
La réponse peut être dans plusieurs langues si les requêtes |
structured_format |
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).
|
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 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 |
Représente le nom du lieu ou de la requête. |
secondary_text |
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 |
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 |
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 |
Contenus liés au thème. |
referenced_places[] |
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[] |
Liste des avis sur ce lieu, en fonction du contexte de la requête sur le lieu. |
photos[] |
Informations (y compris les références) sur les photos de ce lieu, en fonction de la requête sur le lieu. |
justifications[] |
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
|
|
review_justification |
Expérimental : pour en savoir plus, consultez https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. |
business_availability_attributes_justification |
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 |
Si un établissement propose des plats à emporter. |
delivery |
Si un établissement propose la livraison. |
dine_in |
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 |
|
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 |
|
highlighted_text_ranges[] |
Liste des plages du texte mis en surbrillance. |
HighlightedTextRange
Plage de texte mis en surbrillance.
Champs | |
---|---|
start_index |
|
end_index |
|
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 |
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[] |
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 |
Type de connecteur de cette agrégation. |
max_charge_rate_kw |
Taux de recharge maximal statique en kW de chaque connecteur dans l'agrégation. |
count |
Nombre de connecteurs dans cette agrégation. |
availability_last_update_time |
Horodatage de la dernière mise à jour des informations sur la disponibilité du connecteur 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 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[] |
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 |
Type de carburant. |
price |
Prix du carburant. |
update_time |
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 |
Obligatoire. Nom de ressource d'un élément multimédia photo au format suivant : Le nom de ressource d'une photo tel qu'il est renvoyé dans le champ |
max_width_px |
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 |
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 |
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 |
Obligatoire. Nom de ressource d'un lieu, au format |
language_code |
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 |
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 |
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 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 retrouver (également appelée nom de "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 concernant la photo. |
google_maps_uri |
Un lien permettant d'afficher la photo sur Google Maps. |
PhotoMedia
Photo provenant de l'API Places.
Champs | |
---|---|
name |
Nom de ressource d'un élément multimédia photo au format suivant : |
photo_uri |
URI à courte durée de vie qui peut être utilisé pour afficher la photo. |
Lieu
Toutes les informations représentant un lieu.
Champs | |
---|---|
name |
Nom de ressource de ce lieu, au format |
id |
Identifiant unique d'un lieu. |
display_name |
Nom localisé du lieu, adapté à une courte description intelligible. Par exemple, "Google Sydney", "Starbucks", "Pyrmont", etc. |
types[] |
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 |
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 |
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. Le type principal peut être manquant si le type principal du lieu n'est pas accepté. |
national_phone_number |
Numéro de téléphone du lieu, lisible, au format national. |
international_phone_number |
Numéro de téléphone du lieu, lisible par un humain et au format international. |
formatted_address |
Adresse complète et lisible de ce lieu. |
short_formatted_address |
Adresse courte et lisible de ce lieu. |
postal_address |
Adresse au format postal. |
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 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 |
Plus Code de la latitude et de la longitude du lieu. |
location |
Position de ce lieu. |
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 concernant 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 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[] |
Liste des avis sur ce lieu, triés par pertinence. Un maximum de cinq avis peuvent être renvoyés. |
regular_opening_hours |
Horaires d'ouverture habituels. Notez que si un lieu 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, "America/New_York". |
photos[] |
Informations (y compris les références) sur les photos de ce lieu. Vous pouvez obtenir jusqu'à 10 photos. |
adr_format_address |
Adresse du lieu 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 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 |
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 (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[] |
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[] |
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 |
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 |
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 |
Options de stationnement proposées par le lieu. |
sub_destinations[] |
Liste des sous-destinations associées au lieu. |
fuel_options |
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 |
Informations sur les options de recharge de véhicules électriques |
generative_summary |
Résumé du lieu généré par IA. |
containing_places[] |
Liste des lieux dans lesquels se trouve le lieu actuel. |
address_descriptor |
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. |
google_maps_links |
Liens permettant de déclencher différentes actions Google Maps. |
price_range |
Tranche de prix associée à un lieu. |
review_summary |
Résumé du lieu généré par l'IA à partir des avis des utilisateurs. |
ev_charge_amenity_summary |
Résumé des commodités à proximité de la borne de recharge pour véhicules électriques. |
neighborhood_summary |
Résumé des points d'intérêt à proximité du lieu. |
consumer_alert |
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 |
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 |
Nombre total d'avis (avec ou sans texte) pour ce lieu. |
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 places assises à l'intérieur ou à l'extérieur. |
curbside_pickup |
Indique si l'établissement propose le retrait en voiture. |
reservable |
Indique si le lieu accepte les réservations. |
serves_breakfast |
Indique si l'établissement sert le petit-déjeuner. |
serves_lunch |
Indique si l'établissement sert le 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 sert du vin. |
serves_brunch |
Indique si l'établissement sert des brunchs. |
serves_vegetarian_food |
Indique si l'établissement sert 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 pour enfants. |
serves_cocktails |
L'établissement sert des cocktails. |
serves_dessert |
L'établissement sert des desserts. |
serves_coffee |
Le lieu sert du café. |
good_for_children |
Lieu adapté aux enfants. |
allows_dogs |
Les chiens sont acceptés. |
restroom |
L'établissement dispose de toilettes. |
good_for_groups |
L'établissement peut accueillir des 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 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 |
Le lieu dispose d'un parking accessible en fauteuil roulant. |
wheelchair_accessible_entrance |
Le lieu dispose d'une entrée accessible en fauteuil roulant. |
wheelchair_accessible_restroom |
Lieu disposant de toilettes accessibles en fauteuil roulant. |
wheelchair_accessible_seating |
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 |
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 |
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[] |
Tableau indiquant le ou les types du composant d'adresse. |
language_code |
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 |
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 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 |
Aperçu du message d'alerte consommateur. |
details |
Détails du message d'alerte consommateur.ƒ |
language_code |
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 |
Titre à afficher avec la description. |
description |
Description du message d'alerte aux consommateurs. |
about_link |
Lien à afficher avec la description pour fournir plus d'informations. |
Lien
Lien à afficher avec la description pour fournir plus d'informations.
Champs | |
---|---|
title |
Titre à afficher pour le lien. |
uri |
URI du lien. |
ContainingPlace
Informations sur le lieu dans lequel se trouve cet endroit.
Champs | |
---|---|
name |
Nom de ressource du lieu dans lequel se trouve cet établissement. |
id |
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 |
Présentation des services disponibles. Cette information sera obligatoirement fournie. |
coffee |
Récapitulatif des cafés à proximité. |
restaurant |
Un résumé des restaurants à proximité. |
store |
Résumé des magasins à proximité. |
flag_content_uri |
Lien permettant aux utilisateurs de signaler un problème concernant le résumé. |
disclosure_text |
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 |
Aperçu du lieu. |
overview_flag_content_uri |
Lien permettant aux utilisateurs de signaler un problème concernant le résumé. |
disclosure_text |
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. |
GoogleMapsLinks
Liens permettant de déclencher différentes actions Google Maps.
Champs | |
---|---|
directions_uri |
Lien permettant d'afficher l'itinéraire vers le lieu. Le lien ne renseigne que le lieu de destination et utilise le mode de déplacement 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 dans Google Maps. |
reviews_uri |
Un lien permettant d'afficher les avis sur ce lieu dans Google Maps. |
photos_uri |
Un lien permettant d'afficher les avis sur ce lieu dans Google Maps. |
NeighborhoodSummary
Résumé des points d'intérêt à proximité du lieu.
Champs | |
---|---|
overview |
Un résumé du quartier. |
description |
Description détaillée du quartier. |
flag_content_uri |
Lien permettant aux utilisateurs de signaler un problème concernant le résumé. |
disclosure_text |
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[] |
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 REMARQUE : L'ordre du tableau |
weekday_descriptions[] |
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 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 |
Chaîne de type utilisée pour identifier le type d'heures secondaires. |
special_days[] |
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 |
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 |
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 |
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 |
Heure à laquelle l'établissement ouvre. |
close |
Heure à laquelle le lieu commence à être fermé. |
Point
Points de changement d'état.
Champs | |
---|---|
date |
Date dans le fuseau horaire local du lieu. |
truncated |
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 |
Jour de la semaine, sous la forme d'un entier compris entre 0 et 6. 0 correspond à dimanche, 1 à 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 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 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 |
Le lieu dispose de parkings sans frais. |
paid_parking_lot |
Des parkings payants sont disponibles. |
free_street_parking |
Le parking dans la rue est sans frais. |
paid_street_parking |
Le stationnement dans la rue est payant. |
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 le lieu.
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 moyen de paiement. |
accepts_cash_only |
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 |
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 |
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 |
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 |
Résumé des avis des utilisateurs. |
flag_content_uri |
Lien permettant aux utilisateurs de signaler un problème concernant le résumé. |
disclosure_text |
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 |
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 |
Nom de ressource de la sous-destination. |
id |
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 |
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 |
Valeur inférieure de la tranche de prix (incluse). Le prix doit être égal ou supérieur à ce montant. |
end_price |
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 |
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 : |
relative_publish_time_description |
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 |
Texte localisé de l'avis. |
original_text |
Texte de l'avis dans sa langue d'origine. |
rating |
Nombre compris entre 1 et 5, également appelé "nombre d'étoiles". |
author_attribution |
Auteur de l'avis. |
publish_time |
Code temporel de l'avis. |
flag_content_uri |
Lien permettant aux utilisateurs de signaler un problème lié à l'avis. |
google_maps_uri |
Un lien permettant d'afficher l'avis sur Google Maps. |
visit_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 |
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 |
avoid_highways |
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 |
avoid_ferries |
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 |
avoid_indoor |
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 |
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 |
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 |
Facultatif. Mode de transport. |
route_modifiers |
Facultatif. Modificateurs d'itinéraire. |
routing_preference |
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 |
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 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[] |
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, |
directions_uri |
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 |
Pied
Une étape est une partie d'un trajet entre deux lieux.
Champs | |
---|---|
duration |
Temps nécessaire pour effectuer cette partie du trajet. |
distance_meters |
Distance de cette section du trajet. |
SearchNearbyRequest
Requête proto pour la recherche à proximité.
Champs | |
---|---|
language_code |
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 |
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[] |
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[] |
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[] |
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[] |
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 |
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 |
Obligatoire. Région dans laquelle effectuer la recherche. |
rank_preference |
Comment les résultats seront classés dans la réponse. |
routing_parameters |
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
|
|
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[] |
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[] |
Liste des récapitulatifs d'itinéraire où chaque entrée est associée au lieu correspondant au même index dans le champ |
SearchTextRequest
Requête proto pour SearchText.
Champs | |
---|---|
text_query |
Obligatoire. Requête textuelle pour la recherche textuelle. |
language_code |
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 |
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 |
Comment les résultats seront classés 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. Ne prend en charge qu'un seul type inclus. |
open_now |
Permet de limiter la recherche aux lieux actuellement ouverts. La valeur par défaut est "false" (inactif). |
min_rating |
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 |
Obsolète : utilisez plutôt Nombre maximal de résultats pouvant être renvoyés par page. Si le nombre de résultats disponibles est supérieur à Si les deux champs |
page_size |
Facultatif. Nombre maximal de résultats pouvant être renvoyés par page. Si le nombre de résultats disponibles est supérieur à Si les deux champs |
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 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 |
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 |
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 |
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 |
Facultatif. Définissez les options de recherche de véhicules électriques d'une demande de recherche de lieux. |
routing_parameters |
Facultatif. Paramètres supplémentaires pour le routage vers les résultats. |
search_along_route_parameters |
Facultatif. Proto de paramètres supplémentaires pour la recherche le long d'un itinéraire. |
include_pure_service_area_businesses |
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 |
EVOptions
Options de VE pouvant être recherchées 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 taux de recharge est inférieur à celui spécifié sont filtrés. |
connector_types[] |
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
|
|
rectangle |
Boîte rectangulaire définie par les angles nord-est et sud-ouest. |
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
|
|
rectangle |
Boîte rectangulaire définie par les angles nord-est et sud-ouest. |
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 |
Obligatoire. Polyligne de l'itinéraire. |
SearchTextResponse
Proto de réponse pour SearchText.
Champs | |
---|---|
places[] |
Liste des lieux correspondant aux critères de recherche textuelle de l'utilisateur. |
routing_summaries[] |
Liste des récapitulatifs d'itinéraire où chaque entrée est associée au lieu correspondant au même index dans le champ |
contextual_contents[] |
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 |
next_page_token |
Jeton pouvant être envoyé en tant que |
search_uri |
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. |