REST Resource: places

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

string

Nom de la ressource de ce lieu, au format places/{placeId}. Permet de rechercher le lieu.

string

Identifiant unique d'un lieu.

object (LocalizedText)

Nom localisé du lieu, sous la forme d'une courte description lisible par l'humain. Exemples : "Google Sydney", "Starbucks", "Pyrmont", etc.

string

Ensemble de tags de type pour ce résultat. Exemples : "political" et "locality". 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.

string

Type principal du résultat donné. Ce type doit correspondre à l'un des types compatibles avec l'API Places. Exemples : "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.

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.

string

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

string

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

string

Adresse complète et lisible de ce lieu.

string

Adresse courte et lisible de ce lieu.

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 un nombre de composants plus élevé que le tableau 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 requête la latitude/longitude de l'adresse 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 composants 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.

object (PlusCode)

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

object (LatLng)

Position de ce lieu.

object (Viewport)

Fenêtre d'affichage permettant d'afficher le lieu sur une carte de taille moyenne.

number

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

string

URL fournissant plus d'informations sur ce lieu.

string

Site Web officiel de ce lieu (par exemple, la page d'accueil d'une entreprise). Notez que pour les établissements appartenant à une chaîne (un magasin IKEA, par exemple), il s'agit généralement du site Web du magasin individuel, et non de celui de la chaîne dans son ensemble.

object (Review)

Liste d'avis concernant ce lieu, triés par pertinence. Un maximum de cinq avis peut être renvoyé.

object (OpeningHours)

Horaires d'ouverture habituels

object (Photo)

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

string

Adresse du lieu au microformat adr: http://microformats.org/wiki/adr.

enum (BusinessStatus)

État de l'établissement pour le lieu.

enum (PriceLevel)

Niveau de prix du lieu.

object (Attribution)

Ensemble du fournisseur de données à afficher avec ce résultat.

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 (par exemple, ".svg" ou ".png").

string

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

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" correspondant à toutes les heures. Il est défini pour les dates qui présentent des horaires exceptionnels.

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 standards d'un établissement. Par exemple, un restaurant peut définir des horaires de drive ou de 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 lieux. Ce champ inclut le sous-champ "specialDays" correspondant à toutes les heures. Il est défini pour les dates qui présentent des horaires exceptionnels.

object (OpeningHours)

Contient un tableau d'entrées pour les informations sur les horaires secondaires habituels d'un établissement. Les horaires secondaires sont différents des horaires standards d'un établissement. Par exemple, un restaurant peut définir des horaires de drive ou de 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 lieux.

object (LocalizedText)

Contient un résumé du lieu. Un résumé se compose d'un résumé textuel et inclut également le code de langue correspondant, le cas échéant. Le texte récapitulatif doit être présenté tel quel et ne peut être ni modifié, ni altéré.

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 correspondant n'est pas défini.

object (ParkingOptions)

Options de stationnement fournies par le lieu.

object (SubDestination)

Liste des sous-destinations associées au lieu.

object (FuelOptions)

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

object (EVChargeOptions)

Informations sur les options de recharge VE.

integer

Nombre de minutes (en minutes) que le fuseau horaire de ce lieu est actuellement décalé par rapport à UTC. Cette valeur est exprimée en minutes afin de prendre en charge les fuseaux horaires qui sont décalés de quelques fractions d'heure (par exemple, X heures et 15 minutes).

integer

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

boolean

Indique si l'établissement accepte la vente à emporter.

boolean

Indique si l'établissement propose la livraison.

boolean

Indique si l'établissement propose des tables en salle ou en terrasse.

boolean

Indique si l'établissement accepte le drive.

boolean

Indique si le lieu accepte les réservations.

boolean

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

boolean

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

boolean

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

boolean

Indique si le lieu sert de la bière.

boolean

Indique si le lieu sert du vin.

boolean

Indique si l'établissement sert des brunchs.

boolean

Indique si le lieu sert de la nourriture végétarienne.

boolean

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

boolean

Des concerts sont organisés.

boolean

Cet établissement propose un menu pour enfants.

boolean

L'établissement sert des cocktails.

boolean

Établissement servant des desserts.

boolean

L'établissement sert du café.

boolean

L'emplacement est idéal pour les enfants.

boolean

Les chiens sont acceptés.

boolean

Il y a des toilettes.

boolean

L'établissement peut accueillir des groupes.

boolean

Ce lieu permet de regarder des événements sportifs.

object (AccessibilityOptions)

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

{
  "text": string,
  "languageCode": string
}

string

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

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.

{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}

string

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

string

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

string

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

string

Langue utilisée pour formater ce composant, au format CLDR.

{
  "globalCode": string,
  "compoundCode": string
}

string

Code global (complet) du lieu, tel que "9FWM33GV+HQ", représentant une zone de 1/8 000 x 1/8 000 degrés (environ 14 x 14 mètres)

string

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

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

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

object (LatLng)

Obligatoire. Point haut de la fenêtre d'affichage.

{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}

string

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

string

Chaîne de date récente mise en forme, qui représente l'heure de l'examen par rapport à l'heure actuelle, dans un format adapté à la langue et au pays.

object (LocalizedText)

Texte localisé de l'avis.

object (LocalizedText)

Le texte de l'avis dans sa langue d'origine.

number

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

object (AuthorAttribution)

Auteur de cet avis.

string (Timestamp format)

Code temporel de l'avis.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

{
  "displayName": string,
  "uri": string,
  "photoUri": string
}

string

Nom de l'auteur du fichier Photo ou Review.

string

URI de l'auteur du fichier Photo ou Review.

string

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

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

object (Period)

Périodes d'ouverture de ce lieu pendant la semaine. Les règles s'affichent dans l'ordre chronologique et commencent le dimanche dans le fuseau horaire local du lieu. Une valeur vide (mais pas absente) indique un lieu qui n'est jamais ouvert (par exemple, parce qu'il est fermé temporairement pour rénovation).

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 est vide si les horaires sont inconnus ou n'ont pas pu être convertis en texte localisé. Exemple: "Dim: 18:00–06:00"

enum (SecondaryHoursType)

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

object (SpecialDay)

Informations structurées pour les jours exceptionnels compris dans la période couverte par les horaires d'ouverture affichés. Les jours spéciaux sont ceux qui peuvent avoir un impact sur les horaires d'ouverture d'un lieu (le jour de Noël, par exemple). Défini pour currentOpeningHours et currentSecondOpeningHours en cas d'horaires exceptionnels.

boolean

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

{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}

object (Point)

Heure à laquelle le lieu commence à être ouvert.

object (Point)

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

{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}

object (Date)

Date dans le fuseau horaire local du lieu.

boolean

Indique si ce point de terminaison a été tronqué ou non. La troncation se produit lorsque les heures réelles sont en dehors de celles pendant lesquelles nous sommes prêts à renvoyer des heures. Nous tronquons donc les heures pour les ramener à ces limites. Cela permet de renvoyer un délai de 24 x 7 heures à partir de minuit le jour de la requête.

integer

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

integer

Heure à deux chiffres. Il est compris entre 00 et 23.

integer

Minute à deux chiffres. Il est compris entre 00 et 59.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Année de la date. La valeur doit être comprise entre 1 et 9 999, ou valeur 0 si vous souhaitez indiquer une date sans année.

integer

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

integer

Jour du mois. La valeur doit être comprise entre 1 et 31, et valide pour l'année et le mois, ou la valeur 0 pour indiquer une année seule, ou une année et un mois où le jour n'est pas significatif.

{
  "date": {
    object (Date)
  }
}

object (Date)

Date de ce jour spécial.

{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}

string

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

integer

Largeur maximale disponible, en pixels.

integer

Hauteur maximale disponible, en pixels.

object (AuthorAttribution)

Auteurs de cette photo.

{
  "provider": string,
  "providerUri": string
}

string

Nom du fournisseur de données du lieu.

string

URI du fournisseur de données du lieu.

{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}

boolean

Place accepte les paiements par carte de crédit.

boolean

Place accepte les cartes de débit comme mode de paiement.

boolean

L'établissement n'accepte que les paiements en espèces. Les établissements qui présentent cet attribut peuvent accepter d'autres modes de paiement.

boolean

Place accepte les paiements NFC.

{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}

boolean

Des parkings sans frais sont à disposition.

boolean

Des parkings payants sont disponibles.

boolean

Le stationnement dans la rue est sans frais.

boolean

Des places de stationnement sont disponibles moyennant un supplément dans la rue.

boolean

Un parking avec service de voiturier est proposé.

boolean

Le parking couvert est sans frais.

boolean

L'établissement propose un parking couvert payant.

{
  "name": string,
  "id": string
}

string

Nom de ressource de la sous-destination.

string

ID de lieu de la sous-destination.

{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}

boolean

L'établissement dispose d'un parking accessible en fauteuil roulant.

boolean

Le lieu dispose d'une entrée accessible en fauteuil roulant.

boolean

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

boolean

Des places assises accessibles en fauteuil roulant sont disponibles dans l'établissement.

{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}

object (FuelPrice)

Dernier prix connu du carburant de chaque type de carburant de cette station. Cette station propose une entrée par type de carburant. L'ordre n'a pas d'importance.

{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}

enum (FuelType)

Type de carburant.

object (Money)

Prix du carburant.

string (Timestamp format)

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

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

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

string (int64 format)

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

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.

{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}

integer

Nombre de connecteurs à cette station. Toutefois, certains ports peuvent avoir plusieurs connecteurs, mais ne peuvent charger qu'une voiture à la fois (par exemple, dans ce cas), le nombre de connecteurs peut être supérieur au nombre total de voitures pouvant être chargées simultanément.

object (ConnectorAggregation)

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

{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}

enum (EVConnectorType)

Type de connecteur de cette agrégation.

number

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

integer

Nombre de connecteurs dans cette agrégation.

string (Timestamp format)

Horodatage de la dernière mise à jour des informations sur la disponibilité du connecteur dans cette agrégation.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

integer

Nombre de connecteurs de cette agrégation qui sont actuellement disponibles.

integer

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