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)
  },
  "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)
  }
}
Champs
name

string

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

string

Identifiant unique d'un lieu.
displayName

object (LocalizedText)

Nom localisé du lieu. Il peut s'agir d'une brève description lisible par l'humain. Exemples : "Google Sydney", "Starbucks", "Pyrmont", etc.
types[]

string

Un ensemble de tags de type pour ce résultat. Par exemple, "politiques". et "Localité". Pour obtenir la liste complète des valeurs possibles, consultez les tableaux A et B à l'adresse https://developers.google.com/maps/documentation/places/web-service/place-types.
primaryType

string

Type principal du résultat donné. Ce type doit correspondre à l'un des types compatibles avec 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 à l'adresse 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 à l'adresse 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 lisible du lieu, au format international.
formattedAddress

string

Adresse complète et intelligible de ce lieu.
shortFormattedAddress

string

Adresse courte et intelligible de ce lieu.
addressComponents[]

object (AddressComponent)

Composants répétés pour chaque niveau de localité. Remarques concernant le tableau addressComponents[] : - Le tableau de composants d'adresse peut contenir plus de composants que formattedAddress. - 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 latitude/longitude de l'adresse à la requête en tant que paramètre. - Il n'est pas garanti que le format de la réponse reste le même entre les requêtes. En particulier, le nombre de "addressComponents" varie en fonction de l'adresse demandée et peut changer au fil du temps pour la même adresse. Un composant peut changer de position dans le tableau. Le type du composant peut changer. Un composant particulier peut être manquant dans une réponse ultérieure.
plusCode

object (PlusCode)

Plus code de la position du lieu (latitude/longitude).
location

object (LatLng)

Position de ce lieu.
viewport

object (Viewport)

Fenêtre d'affichage adaptée pour afficher le lieu sur une carte de taille moyenne.
rating

number

Note comprise entre 1 et 5, 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, une entreprise page d'accueil. Notez que pour les établissements qui font partie d'une chaîne (un magasin IKEA, par exemple), il s'agit généralement de son site Web, et non de la chaîne dans son ensemble.
reviews[]

object (Review)

Liste d'avis sur ce lieu, triés par pertinence. Vous pouvez renvoyer jusqu'à cinq avis.
regularOpeningHours

object (OpeningHours)

Horaires d'ouverture habituels
photos[]

object (Photo)

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

string

Adresse du lieu au 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 devant être affiché avec ce résultat.
iconMaskBaseUri

string

URL tronquée qui correspond à 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 de l'icon_mask au format hexadécimal, par exemple #909CE1.
currentOpeningHours

object (OpeningHours)

les horaires d'ouverture pour les sept prochains jours (y compris aujourd'hui) ; La période commence à minuit le jour de la demande et se termine à 23 h 59 six jours plus tard. Ce champ inclut le sous-champ "specialDays" pour toutes les heures, défini pour les dates avec des horaires exceptionnels.
currentSecondaryOpeningHours[]

object (OpeningHours)

Contient un tableau des entrées pour les sept prochains jours, y compris des informations sur les horaires secondaires d'une entreprise. Les horaires secondaires sont différents des horaires standards d'un établissement. Par exemple, un restaurant peut indiquer des horaires de drive ou de livraison en tant qu'horaires secondaires. Ce champ renseigne le sous-champ de type. Il est issu d'une liste prédéfinie de types d'horaires d'ouverture (par exemple, drive_THROUGH, PICKUP ou TakeOUT) en fonction des types de lieu. Ce champ inclut le sous-champ "specialDays" pour toutes les heures, défini pour les dates avec des horaires exceptionnels.
regularSecondaryOpeningHours[]

object (OpeningHours)

Contient un tableau d'entrées contenant des informations sur les horaires secondaires normaux d'un établissement. Les horaires secondaires sont différents des horaires standards d'un établissement. Par exemple, un restaurant peut indiquer des horaires de drive ou de livraison en tant qu'horaires secondaires. Ce champ renseigne le sous-champ de type. Il est issu d'une liste prédéfinie de types d'horaires d'ouverture (par exemple, drive_THROUGH, PICKUP ou TakeOUT) en fonction des types de lieu.
editorialSummary

object (LocalizedText)

Contient un résumé du lieu. Un résumé comprend une présentation textuelle et inclut également le code de langue associé, le cas échéant. Le résumé doit être présenté tel quel. Il ne peut être ni modifié, ni altéré.
paymentOptions

object (PaymentOptions)

Modes de paiement acceptés par le lieu. Si aucune donnée n'est disponible, 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 options de carburant disponibles dans une station-service. Ces informations sont mises à jour régulièrement.
evChargeOptions

object (EVChargeOptions)

Informations sur les options de recharge pour VE.
generativeSummary

object (GenerativeSummary)

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

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

object (AreaSummary)

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

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

integer

Le nombre de minutes du fuseau horaire de ce lieu est actuellement décalé par rapport à UTC. Il est exprimé en minutes afin de prendre en charge les fuseaux horaires décalés par des fractions d'une heure, par exemple X heures et 15 minutes.
userRatingCount

integer

Nombre total d'avis (avec ou sans texte) sur ce lieu.
takeout

boolean

Indique si l'établissement accepte la récupération.
delivery

boolean

Indique si l'entreprise accepte la livraison.
dineIn

boolean

Indique si l'établissement propose des places en intérieur ou en extérieur.
curbsidePickup

boolean

Indique si l'entreprise propose le drive.
reservable

boolean

Indique si le lieu accepte les réservations.
servesBreakfast

boolean

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

boolean

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

boolean

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

boolean

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

boolean

Indique si l'établissement sert du vin.
servesBrunch

boolean

Indique si l'établissement sert des brunchs.
servesVegetarianFood

boolean

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

boolean

L'établissement possède une terrasse aménagée.
liveMusic

boolean

Cet établissement accueille 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

Cet établissement sert du café.
goodForChildren

boolean

L'établissement est bon pour les enfants.
allowsDogs

boolean

Les chiens sont acceptés dans l'établissement.
restroom

boolean

L'établissement dispose de toilettes.
goodForGroups

boolean

L'établissement peut accueillir des groupes.
goodForWatchingSports

boolean

Lieu adapté au visionnage d'événements sportifs.
accessibilityOptions

object (AccessibilityOptions)

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

LocalizedText

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

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 forment l'adresse formatée, si ces informations sont disponibles.

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

string

Description complète ou nom du composant de l'adresse. Par exemple, un composant d'adresse pour l'Australie peut avoir le nom long "Australia".
shortText

string

Nom textuel abrégé pour le composant de l'adresse, le cas échéant. Par exemple, un composant d'adresse pour l'Australie peut avoir le nom abrégé "AU".
types[]

string

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

string

Langage utilisé pour mettre en forme ces composants, au format CLDR.

PlusCode

Le Plus Code (http://plus.codes) est une référence d'emplacement sous deux formats: le code global définissant un rectangle de 14mx14m (1/8000e de degré) ou plus petit, et le 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", qui représente une zone de 1/8000 x 1/8000 degré (environ 14 x 14 mètres).
compoundCode

string

Code composé du lieu, tel que "33GV+HQ, Ramberg, Norvège", contenant le suffixe du code global et le remplacement du préfixe par le nom mis en forme d'une entité de référence.

LatLng

Objet représentant une paire latitude/longitude. Elle 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 opposés en diagonale. Une fenêtre d'affichage est considérée comme une région fermée (elle inclut ses limites). 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 différents cas de figure:

  • Si low = high, la fenêtre d'affichage est constituée de ce seul point.

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

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

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

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

Les champs low et high doivent tous les deux être renseignés, et la zone représentée ne peut pas être vide (comme spécifié dans les définitions ci-dessus). Si la fenêtre d'affichage est vide, cela génère une erreur.

Par exemple, cette fenêtre d'affichage englobe entièrement 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 haut 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
}
Champs
name

string

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

string

Chaîne indiquant l'heure récente mise en forme, exprimant la durée de l'examen 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

Un nombre compris entre 1 et 5, é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".

AuthorAttribution

Informations sur l'auteur des données de contenu généré 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 Photo ou Review.
uri

string

URI de l'auteur de Photo ou Review.
photoUri

string

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

OpeningHours

Informations sur les horaires d'ouverture du lieu.

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

object (Period)

Périodes d'ouverture de ce lieu en semaine. Les périodes sont indiquées par ordre chronologique et commencent par dimanche dans le fuseau horaire du lieu. Une valeur vide (mais non absente) indique un lieu qui n'est jamais ouvert (par exemple, car il est fermé temporairement pour des travaux de rénovation.
weekdayDescriptions[]

string

Chaînes localisées décrivant les horaires d'ouverture de ce lieu (une chaîne pour chaque jour de la semaine). Ce champ sera vide si les horaires sont inconnus ou n'ont pas pu être convertis en texte localisé. Exemple : "Sun: 18:00–06:00"
secondaryHoursType

enum (SecondaryHoursType)

Chaîne de type permettant d'identifier le type d'horaires secondaires.
specialDays[]

object (SpecialDay)

Informations structurées pour les jours exceptionnels qui se situent dans la période couverte par les horaires d'ouverture renvoyés. Les jours spéciaux sont les jours qui peuvent avoir un impact sur les horaires d'ouverture d'un lieu (par exemple, Jour de Noël. Définissez ce champ sur currentOpeningHours et currentSecondaryOpeningHours en cas d'horaires exceptionnels.
openNow

boolean

Ce lieu est-il ouvert actuellement ? Toujours présent, sauf si nous ne disposons pas de données sur l'heure de la journée ou le fuseau horaire pour ces horaires d'ouverture.

Période

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

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

object (Point)

Heure à laquelle le lieu est d'abord ouvert.
close

object (Point)

L'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. La troncation se produit lorsque les heures réelles sont en dehors des heures auxquelles nous sommes prêts à renvoyer des heures entre les deux, c'est pourquoi nous tronquons les heures pour revenir à ces limites. Ainsi, un délai maximal de 24 x 7 heures à partir de minuit de la journée de la requête est renvoyé.
day

integer

Jour de la semaine, sous la forme d'un entier compris entre 0 et 6. 0 correspond à dimanche, 1 à lundi, etc.
hour

integer

Heure à deux chiffres. Cette valeur est comprise entre 00 et 23.
minute

integer

Minutes à deux chiffres. Cette valeur est comprise entre 00 et 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 zéro.
  • 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. Doit être comprise entre 1 et 9999, ou 0 pour indiquer une date sans année.
month

integer

Mois de l'année. La valeur doit être comprise entre 1 et 12, ou égale à 0 pour spécifier une année sans mois ni jour.
day

integer

Jour du mois. Doit être compris entre 1 et 31, et valide pour l'année et le mois, ou 0 pour indiquer 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'horaires 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 drive pour les banques, les restaurants et les pharmacies.
HAPPY_HOUR Happy hour.
DELIVERY Heure de livraison.
TAKEOUT Heure de vente à emporter.
KITCHEN L'heure de la cuisine
BREAKFAST Heure du petit-déjeuner.
LUNCH L'heure du déjeuner.
DINNER L'heure du dîner.
BRUNCH L'heure du brunch.
PICKUP Heure de retrait.
ACCESS Heures d'accès aux lieux de stockage.
SENIOR_HOURS Horaires d'ouverture exceptionnels pour les seniors.
ONLINE_SERVICE_HOURS Les horaires de service en ligne.

SpecialDay

Informations structurées pour les jours exceptionnels qui se situent dans la période couverte par les horaires d'ouverture renvoyés. Les jours spéciaux sont les jours qui peuvent avoir un impact sur les horaires d'ouverture d'un lieu (par exemple, Jour de Noël.

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

object (Date)

Date de ce jour spécial.

Photo

Informations sur la photo d'un lieu.

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

string

Identifiant. Référence représentant cette photo de lieu, qui peut être utilisée pour rechercher à nouveau cette photo de lieu (également appelée "nom de 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.

BusinessStatus

État de l'établissement pour le lieu.

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

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

Attribution

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

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

Modes de paiement acceptés 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

Ce lieu accepte uniquement les paiements en espèces. Les lieux présentant cet attribut peuvent toujours accepter d'autres modes de paiement.
acceptsNfc

boolean

L'établissement accepte les paiements NFC.

ParkingOptions

Informations sur les possibilités de stationnement pour le lieu. Un parking peut accueillir plusieurs options à la fois.

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

boolean

Des parkings sont disponibles sans frais.
paidParkingLot

boolean

Cet établissement propose des parkings payants.
freeStreetParking

boolean

Le stationnement dans la rue est sans frais.
paidStreetParking

boolean

Le stationnement dans la rue est payant.
valetParking

boolean

Un service de voiturier est proposé.
freeGarageParking

boolean

Le parking couvert est sans frais.
paidGarageParking

boolean

L'établissement propose un parking couvert (payant).

SubDestination

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

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

string

Nom de ressource de la sous-destination.
id

string

Identifiant de 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 dispose d'un parking accessible en fauteuil roulant.
wheelchairAccessibleEntrance

boolean

Certaines comprennent une entrée accessible en fauteuil roulant.
wheelchairAccessibleRestroom

boolean

L'établissement comprend des toilettes accessibles en fauteuil roulant.
wheelchairAccessibleSeating

boolean

Cet établissement dispose de sièges accessibles en fauteuil roulant.

FuelOptions

Informations les plus récentes sur les options de carburant 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 dont dispose cette station. Il y a une entrée par type de carburant dans cette borne. L'ordre n'est pas important.

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

Enums
FUEL_TYPE_UNSPECIFIED Type de carburant non spécifié.
DIESEL Carburant diesel.
REGULAR_UNLEADED Sans plomb standard.
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 Camion diesel.

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 dans la norme ISO 4217.
units

string (int64 format)

Unités entières du montant. Par exemple, si currencyCode correspond à "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 sur place. La terminologie est la suivante : https://afdc.energy.gov/fuels/electricity_infrastructure.html, un port permet de recharger une voiture à la fois. Un port comporte un ou plusieurs connecteurs. Une station possède un ou plusieurs ports.

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

integer

Nombre de connecteurs à cette borne. Toutefois, certains ports peuvent avoir plusieurs connecteurs, mais ne peuvent charger qu'un seul véhicule à la fois (par exemple, le nombre de connecteurs peut être supérieur au nombre total de voitures pouvant se charger simultanément).
connectorAggregation[]

object (ConnectorAggregation)

Liste d'agrégations de connecteurs de recharge de VE contenant des connecteurs du même type et du même taux de recharge.

ConnectorAggregation

Informations sur la recharge de VE regroupées par [type, maxChargeRateKw]. Affiche l'agrégation des frais de VE pour les connecteurs ayant le même type et le même taux de facturation maximal en mots clés.

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 facturation 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é du connecteur de 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 actuellement hors service dans cette agrégation.

EVConnectorType

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

Enums
EV_CONNECTOR_TYPE_UNSPECIFIED Connecteur non spécifié.
EV_CONNECTOR_TYPE_OTHER Autres types de connecteurs
EV_CONNECTOR_TYPE_J1772 Connecteur J1772 de type 1.
EV_CONNECTOR_TYPE_TYPE_2 Connecteur CEI 62196 de type 2. Souvent appelés MENACES.
EV_CONNECTOR_TYPE_CHADEMO Connecteur de type CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Système de recharge combiné (CA et CC). D'après la SAE. Connecteur J-1772 de type 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Système de recharge combiné (CA et CC). Basé sur le connecteur Mennekes de type 2
EV_CONNECTOR_TYPE_TESLA Connecteur TESLA générique. Il s'agit d'un service NACS en Amérique du Nord, mais d'un autre type 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. Elle correspond davantage à la possibilité de recharger un véhicule de marque Tesla à une borne de recharge appartenant à Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T Le type GB/T correspond à la norme GB/T en Chine. Ce type couvre tous les types GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Prise murale non spécifiée.

GenerativeSummary

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

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

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

object (LocalizedText)

Présentation du lieu
description

object (LocalizedText)

Description détaillée du lieu.
references

object (References)

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

Références

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

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

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

object (Review)

Avis servant 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 les noms de ressources Place.

AreaSummary

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

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

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

object (ContentBlock)

Blocs de contenu qui composent le résumé de zone. Chaque bloc est associé à un sujet distinct sur la zone concernée.

ContentBlock

Bloc de contenu pouvant être diffusé individuellement.

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

string

Sujet du contenu (par exemple, "présentation") ou "restaurant".
content

object (LocalizedText)

Contenus liés au thème.
references

object (References)

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

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

Méthodes

autocomplete

 Affiche des prédictions pour l'entrée donnée.

get

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

searchNearby

 Recherchez des lieux à proximité de lieux.

searchText

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