REST Resource: places

Ressource: Place

Toutes les informations représentant un lieu.

Représentation JSON 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  },
  "pureServiceAreaBusiness": boolean
}
Champs
name

string

Nom de la ressource de cet établissement, au format places/{placeId}. Peut être utilisé pour rechercher le lieu.
id

string

Identifiant unique d'un lieu.
displayName

object (LocalizedText)

Nom localisé du lieu, qui peut servir de courte description lisible par l'humain. (par exemple, "Google Sydney", "Starbucks", "Pyrmont", etc.)
types[]

string

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

string

Type principal du résultat donné. Ce type doit être l'un des types acceptés par l'API Places. (par exemple, "restaurant", "café", "aéroport", etc.). Un lieu ne peut avoir qu'un seul type principal. Pour obtenir la liste complète des valeurs possibles, consultez les tableaux A et B sur la page https://developers.google.com/maps/documentation/places/web-service/place-types.
primaryTypeDisplayName

object (LocalizedText)

Nom à afficher du type principal, localisé dans la langue de la requête, le cas échéant. Pour obtenir la liste complète des valeurs possibles, consultez les tableaux A et B sur la page https://developers.google.com/maps/documentation/places/web-service/place-types.
nationalPhoneNumber

string

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

string

Numéro de téléphone intelligible du lieu, au format international.
formattedAddress

string

Adresse complète et lisible de cet établissement.
shortFormattedAddress

string

Adresse courte et lisible de cet établissement.
addressComponents[]

object (AddressComponent)

Composants répétés pour chaque niveau de localité. Notez les informations suivantes concernant le tableau addressComponents[] : - 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 formattedAddress. 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.
plusCode

object (PlusCode)

Plus Code de l'emplacement du lieu (latitude/longitude).
location

object (LatLng)

Position de cet établissement.
viewport

object (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

number

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

string

URL fournissant plus d'informations sur ce lieu.
websiteUri

string

Site Web faisant autorité pour ce lieu, par exemple la page d'accueil d'un établissement. Notez que pour les établissements 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[]

object (Review)

Liste des avis sur cet établissement, triés par pertinence. Vous ne pouvez pas renvoyer plus de cinq avis.
regularOpeningHours

object (OpeningHours)

Horaires d'ouverture habituels. Notez que si un établissement est toujours ouvert (24 heures sur 24), le champ close ne sera pas défini. Les clients peuvent représenter un lieu toujours ouvert (24 heures) par une période [open][google.foo.OpeningHours.Period.open] contenant [day][google.foo.Point.day] avec la valeur 0, [hour][google.foo.Point.hour] avec la valeur 0 et [minute][google.foo.Point.minute] avec la valeur 0.
photos[]

object (Photo)

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

string

Adresse de l'établissement au format microformat ADR: http://microformats.org/wiki/adr.
businessStatus

enum (BusinessStatus)

État de l'établissement pour le lieu.
priceLevel

enum (PriceLevel)

Niveau de prix du lieu.
attributions[]

object (Attribution)

Ensemble de fournisseurs de données à afficher avec ce résultat.
iconMaskBaseUri

string

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

string

Couleur d'arrière-plan pour icon_mask au format hexadécimal, par exemple #909CE1.
currentOpeningHours

object (OpeningHours)

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 "specialDays" de toutes les heures, défini pour les dates pour lesquelles des horaires exceptionnels sont définis.
currentSecondaryOpeningHours[]

object (OpeningHours)

Contient un tableau d'entrées pour les sept prochains jours, y compris des informations sur les horaires secondaires d'un établissement. Les horaires secondaires sont différents des horaires principaux d'un établissement. Par exemple, un restaurant peut indiquer les horaires du drive ou de la livraison comme horaires secondaires. Ce champ renseigne le sous-champ "type", qui 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 "specialDays" de toutes les heures, défini pour les dates pour lesquelles des horaires exceptionnels sont définis.
regularSecondaryOpeningHours[]

object (OpeningHours)

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 du drive ou de la 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.
editorialSummary

object (LocalizedText)

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é.
paymentOptions

object (PaymentOptions)

Options de paiement acceptées par le lieu Si les données d'une option de paiement ne sont pas disponibles, le champ de l'option de paiement n'est pas défini.
parkingOptions

object (ParkingOptions)

Options de stationnement proposées par l'établissement.
subDestinations[]

object (SubDestination)

Liste des sous-destinations associées au lieu.
fuelOptions

object (FuelOptions)

Informations les plus récentes sur les carburants disponibles dans une station-service. Ces informations sont mises à jour régulièrement.
evChargeOptions

object (EVChargeOptions)

Informations sur les options de recharge de VE
generativeSummary

object (GenerativeSummary)

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

Résumé de l'établissement généré par IA.
areaSummary

object (AreaSummary)

Fonctionnalité expérimentale: pour en savoir plus, consultez la page 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.
containingPlaces[]

object (ContainingPlace)

Liste des lieux dans lesquels se trouve l'emplacement actuel.
addressDescriptor

object (AddressDescriptor)

Déscripteur d'adresse du lieu. Les descripteurs d'adresse incluent des informations supplémentaires qui aident à décrire un lieu à l'aide de repères 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.
priceRange

object (PriceRange)

Plage de prix associée à un lieu.
utcOffsetMinutes

integer

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

integer

Nombre total d'avis (avec ou sans texte) pour cet établissement.
takeout

boolean

Indique si l'établissement propose des plats à emporter.
delivery

boolean

Indique si l'établissement propose la livraison.
dineIn

boolean

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

boolean

Indique si l'établissement propose le retrait en drive.
reservable

boolean

Indique si l'établissement accepte les réservations.
servesBreakfast

boolean

Indique si l'établissement sert le petit-déjeuner.
servesLunch

boolean

Indique si l'établissement sert à déjeuner.
servesDinner

boolean

Indique si l'établissement sert à dîner.
servesBeer

boolean

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

boolean

Indique si l'établissement propose du vin.
servesBrunch

boolean

Indique si l'établissement sert des brunchs.
servesVegetarianFood

boolean

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

boolean

L'établissement dispose d'une terrasse.
liveMusic

boolean

Le lieu propose des concerts.
menuForChildren

boolean

L'établissement propose un menu enfant.
servesCocktails

boolean

L'établissement sert des cocktails.
servesDessert

boolean

L'établissement propose des desserts.
servesCoffee

boolean

L'établissement sert du café.
goodForChildren

boolean

L'endroit est adapté aux enfants.
allowsDogs

boolean

Les chiens sont acceptés.
restroom

boolean

L'établissement dispose de toilettes.
goodForGroups

boolean

L'établissement accepte les groupes.
goodForWatchingSports

boolean

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

object (AccessibilityOptions)

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

boolean

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

LocalizedText

Variante localisée d'un texte dans une langue spécifique.

Représentation JSON 
{
  "text": string,
  "languageCode": string
}
Champs
text

string

Chaîne localisée dans la langue correspondant à languageCode ci-dessous.
languageCode

string

Code de langue BCP-47 du texte, tel que "en-US" ou "sr-Latn".

Pour en savoir plus, consultez la page http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

AddressComponent

Composants structurés qui constituent l'adresse mise en forme, le cas échéant.

Représentation JSON 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Champs
longText

string

Description complète ou nom du composant d'adresse. Par exemple, un composant d'adresse pour l'Australie peut avoir "Australie" comme long_name.
shortText

string

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[]

string

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

string

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

PlusCode

Un Plus Code (http://plus.codes) est une référence de lieu qui se présente sous deux formats: un code global qui définit 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.

Représentation JSON 
{
  "globalCode": string,
  "compoundCode": string
}
Champs
globalCode

string

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).
compoundCode

string

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.

LatLng

Objet représentant une paire latitude/longitude. Cette valeur est exprimée par une paire de doubles représentant les degrés de latitude et de longitude. Sauf indication contraire, cet objet doit être conforme à la norme WGS84. Les valeurs doivent se situer dans les limites normalisées.

Représentation JSON 
{
  "latitude": number,
  "longitude": number
}
Champs
latitude

number

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].
longitude

number

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

Fenêtre d'affichage

Fenêtre d'affichage de latitude-longitude, représentée par deux points low et high diagonalement opposés. Une fenêtre d'affichage est considérée comme une région fermée, c'est-à-dire qu'elle inclut sa limite. Les limites de latitude doivent être comprises entre -90 et 90 degrés, inclus, et les limites de longitude entre -180 et 180 degrés, inclus. Voici quelques exemples :

  • Si low = high, la fenêtre d'affichage ne comprend qu'un seul point.

  • Si low.longitude > high.longitude, la plage de longitude est inversée (la fenêtre d'affichage croise la ligne de longitude de 180 degrés).

  • Si low.longitude est égal à -180 degrés et high.longitude à 180 degrés, la fenêtre d'affichage inclut toutes les longitudes.

  • Si low.longitude est défini sur 180 degrés et high.longitude sur -180 degrés, la plage de longitudes est vide.

  • Si low.latitude > high.latitude, la plage de latitude est vide.

low et high doivent être renseignés, et la zone représentée ne doit pas être vide (comme indiqué dans les définitions ci-dessus). Un viewport vide entraînera une erreur.

Par exemple, ce viewport englobe entièrement la ville de New York :

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Représentation JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Champs
low

object (LatLng)

Obligatoire. Point bas de la fenêtre d'affichage.
high

object (LatLng)

Obligatoire. Point le plus élevé de la fenêtre d'affichage.

Récapitulatif

Informations sur un avis sur un lieu

Représentation JSON 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string,
  "flagContentUri": string,
  "googleMapsUri": string
}
Champs
name

string

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: places/{placeId}/reviews/{review}).
relativePublishTimeDescription

string

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

object (LocalizedText)

Texte localisé de l'avis.
originalText

object (LocalizedText)

Texte de l'avis dans sa langue d'origine.
rating

number

Nombre compris entre 1,0 et 5,0, également appelé nombre d'étoiles.
authorAttribution

object (AuthorAttribution)

Auteur de cet avis.
publishTime

string (Timestamp format)

Code temporel de l'avis.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
flagContentUri

string

Lien permettant aux utilisateurs de signaler un problème avec l'avis
googleMapsUri

string

Lien permettant d'afficher l'avis sur Google Maps.

AuthorAttribution

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

Représentation JSON 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
Champs
displayName

string

Nom de l'auteur de l'Photo ou de l'Review.
uri

string

URI de l'auteur de la Photo ou de la Review.
photoUri

string

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

OpeningHours

Informations sur les horaires d'ouverture de l'établissement.

Représentation JSON 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
Champs
periods[]

object (Period)

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.
weekdayDescriptions[]

string

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"
secondaryHoursType

enum (SecondaryHoursType)

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

object (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). Définissez-le pour currentOpeningHours et currentSecondaryOpeningHours si des horaires exceptionnels s'appliquent.
nextOpenTime

string (Timestamp format)

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.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
nextCloseTime

string (Timestamp format)

La prochaine fois que les horaires d'ouverture actuels prendront fin, 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.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
openNow

boolean

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.

Représentation JSON 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
Champs
open

object (Point)

Heure de début de l'ouverture de l'établissement.
close

object (Point)

Heure à laquelle le lieu commence à être fermé.

Point

Points de changement d'état.

Représentation JSON 
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
Champs
date

object (Date)

Date dans le fuseau horaire local du lieu.
truncated

boolean

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. Cela garantit que 24 * 7 heures maximum sont renvoyées à partir de minuit le jour de la requête.
day

integer

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

integer

Heure au format 24 heures. Les valeurs vont de 0 à 23.
minute

integer

La minute. Les valeurs vont de 0 à 59.

Date

Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date est donnée selon le calendrier grégorien. Il peut s'agir de l'un des éléments suivants:

  • Une date complète, avec des valeurs non nulles pour l'année, le mois et le jour.
  • un mois et un jour, avec une année nulle (par exemple, un anniversaire).
  • une année seule, avec un mois et un jour nuls ;
  • Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).

Types associés :

Représentation JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Champs
year

integer

Année de la date. Elle doit être comprise entre 1 et 9999, ou égale à 0 si vous spécifiez une date sans année.
month

integer

Mois d'une année. Il doit être compris entre 1 et 12, ou égal à 0 pour spécifier une année sans mois ni jour.
day

integer

Jour d'un mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 pour spécifier une année seule, ou une année et un mois où le jour n'est pas significatif.

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

Représentation JSON 
{
  "date": {
    object (Date)
  }
}
Champs
date

object (Date)

Date de ce jour spécial.

Photo

Informations sur une photo d'un lieu

Représentation JSON 
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ],
  "flagContentUri": string,
  "googleMapsUri": string
}
Champs
name

string

Identifiant. Référence représentant cette photo de lieu, qui peut être utilisée pour la rechercher à nouveau (également appelée "ressource" de l'API: places/{placeId}/photos/{photo}).
widthPx

integer

Largeur maximale disponible, en pixels.
heightPx

integer

Hauteur maximale disponible, en pixels.
authorAttributions[]

object (AuthorAttribution)

Auteurs de cette photo
flagContentUri

string

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

string

Lien permettant d'afficher la photo sur Google Maps.

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.

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.

Attribution

Informations sur les fournisseurs de données de cet établissement.

Représentation JSON 
{
  "provider": string,
  "providerUri": string
}
Champs
provider

string

Nom du fournisseur de données du lieu.
providerUri

string

URI du fournisseur de données du lieu.

PaymentOptions

Options de paiement acceptées par le lieu

Représentation JSON 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
Champs
acceptsCreditCards

boolean

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

boolean

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

boolean

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

boolean

L'établissement accepte les paiements NFC.

ParkingOptions

Informations sur les options de stationnement du lieu. Un parking peut accepter plusieurs options en même temps.

Représentation JSON 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Champs
freeParkingLot

boolean

Le lieu propose des parkings sans frais.
paidParkingLot

boolean

Le lieu propose des parkings payants.
freeStreetParking

boolean

Le parking dans la rue est sans frais.
paidStreetParking

boolean

Le parking est payant dans la rue.
valetParking

boolean

Un parking avec service de voiturier est disponible.
freeGarageParking

boolean

Le parking couvert est sans frais.
paidGarageParking

boolean

Un parking couvert payant est disponible.

SubDestination

Nom et ID de la ressource de lieu et des sous-destinations associées au lieu. Par exemple, les différents terminaux correspondent aux différentes destinations d'un aéroport.

Représentation JSON 
{
  "name": string,
  "id": string
}
Champs
name

string

Nom de la ressource de la sous-destination.
id

string

ID du lieu de la sous-destination.

AccessibilityOptions

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

Représentation JSON 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
Champs
wheelchairAccessibleParking

boolean

L'établissement propose un parking accessible en fauteuil roulant.
wheelchairAccessibleEntrance

boolean

L'établissement dispose d'une entrée accessible en fauteuil roulant.
wheelchairAccessibleRestroom

boolean

L'établissement dispose de toilettes accessibles en fauteuil roulant.
wheelchairAccessibleSeating

boolean

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

FuelOptions

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

Représentation JSON 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
Champs
fuelPrices[]

object (FuelPrice)

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

Représentation JSON 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
Champs
type

enum (FuelType)

Type de carburant.
price

object (Money)

Prix du carburant.
updateTime

string (Timestamp format)

Heure de la dernière mise à jour du prix du carburant.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

FuelType

Types de carburants

Enums
FUEL_TYPE_UNSPECIFIED Type de carburant non spécifié.
DIESEL Carburant diesel
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 GPL
E80 E 80.
E85 E 85.
METHANE Méthane
BIO_DIESEL Biodiesel
TRUCK_DIESEL Diesel de camion.

Valeur monétaire

Représente un montant associé à un type de devise.

Représentation JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Champs
currencyCode

string

Code de devise à trois lettres défini par la norme ISO 4217.
units

string (int64 format)

Unités entières du montant. Par exemple, si currencyCode est défini sur "USD", une unité correspond à un dollar américain.
nanos

integer

Nombre de nano-unités (10^-9) du montant. La valeur doit être comprise entre -999 999 999 et +999 999 999 inclus. Si units est positif, nanos doit être positif ou nul. Si units est égal à zéro, nanos peut être positif, nul ou négatif. Si units est négatif, nanos doit être négatif ou nul. Par exemple, -1,75 $ est représenté par units=-1 et nanos=-750 000 000.

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.

Représentation JSON 
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
Champs
connectorCount

integer

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.
connectorAggregation[]

object (ConnectorAggregation)

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, maxChargeRateKw]. Indique l'agrégation de la recharge des VE pour les connecteurs du même type et du même taux de recharge maximal en kW.

Représentation JSON 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
Champs
type

enum (EVConnectorType)

Type de connecteur de cette agrégation.
maxChargeRateKw

number

Taux de recharge maximal statique en kW de chaque connecteur de l'agrégation.
count

integer

Nombre de connecteurs dans cette agrégation.
availabilityLastUpdateTime

string (Timestamp format)

Code temporel de la dernière mise à jour des informations de disponibilité des connecteurs dans cette agrégation.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
availableCount

integer

Nombre de connecteurs actuellement disponibles dans cette agrégation.
outOfServiceCount

integer

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.

GenerativeSummary

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

Résumé de l'établissement généré par IA.

Représentation JSON 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "description": {
    object (LocalizedText)
  },
  "descriptionFlagContentUri": string,
  "references": {
    object (References)
  }
}
Champs
overview

object (LocalizedText)

Présentation du lieu.
overviewFlagContentUri

string

Lien permettant aux utilisateurs de signaler un problème avec le résumé de la vue d'ensemble.
description

object (LocalizedText)

Description détaillée du lieu.
descriptionFlagContentUri

string

Lien permettant aux utilisateurs de signaler un problème avec le résumé de la description.
references

object (References)

Références utilisées pour générer la description récapitulative.

Références

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

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

Représentation JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
Champs
reviews[]

object (Review)

Avis qui servent de références
places[]

string

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.

AreaSummary

Fonctionnalité expérimentale: pour en savoir plus, consultez la page 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.

Représentation JSON 
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ],
  "flagContentUri": string
}
Champs
contentBlocks[]

object (ContentBlock)

Blocs de contenu qui composent le récapitulatif de l'emplacement. Chaque bloc contient un sujet distinct sur la zone.
flagContentUri

string

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

ContentBlock

Bloc de contenu pouvant être diffusé individuellement.

Représentation JSON 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Champs
topic

string

Thème du contenu (par exemple, "présentation" ou "restaurant").
content

object (LocalizedText)

Contenu en rapport avec le sujet.
references

object (References)

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

Références associées à ce bloc de contenu.

ContainingPlace

Informations sur le lieu dans lequel se trouve ce lieu.

Représentation JSON 
{
  "name": string,
  "id": string
}
Champs
name

string

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

string

ID du lieu dans lequel se trouve cet établissement.

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.

Représentation JSON 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
Champs
landmarks[]

object (Landmark)

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[]

object (Area)

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

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.

Représentation JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
Champs
name

string

Nom de la ressource du repère.
placeId

string

ID du lieu du repère.
displayName

object (LocalizedText)

Nom à afficher du repère.
types[]

string

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

enum (SpatialRelationship)

Définit la relation spatiale entre l'emplacement cible et le repère.
straightLineDistanceMeters

number

Distance en ligne droite, en mètres, entre le point central de la cible et celui du repère. Dans certains cas, cette valeur peut être plus longue que travelDistanceMeters.
travelDistanceMeters

number

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.

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.

Représentation JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
Champs
name

string

Nom de la ressource de la zone.
placeId

string

ID de lieu de la zone.
displayName

object (LocalizedText)

Nom à afficher de la zone.
containment

enum (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é.

PriceRange

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

Représentation JSON 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
Champs
startPrice

object (Money)

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

object (Money)

Prix le plus élevé de la gamme (exclusif). Le prix doit être inférieur à ce montant.

Méthodes

autocomplete

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

get

 Obtenez les informations d'un lieu en fonction de son nom de ressource, qui est une chaîne au format places/{place_id}.

searchNearby

 Rechercher des lieux à proximité de lieux

searchText

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