Place (beta)

Classe Place

Classe google.maps.places.Place

Pour y accéder, appelez const {Place} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
Place
Place(options)
Paramètres: 
BetafindPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request)
Paramètres: 
Valeur renvoyée:  Promise<{places:Array<Place>}>
Recherche un lieu à partir du numéro de téléphone indiqué. Renvoie un tableau en raison de rares cas où plusieurs lieux peuvent partager le même numéro de téléphone.
BetafindPlaceFromQuery
findPlaceFromQuery(request)
Paramètres: 
Valeur renvoyée:  Promise<{places:Array<Place>}>
Recherche un lieu en fonction de la requête textuelle donnée. Renvoie un tableau en raison des cas où la requête est légèrement ambiguë et que plusieurs lieux sont renvoyés. Cette méthode n'est pas destinée aux recherches qui attendent plusieurs résultats.
addressComponents
Type:Array<AddressComponent> optional
Ensemble de composants d'adresse pour l'emplacement de ce lieu. Objet vide si aucune donnée d'adresse connue n'est disponible. undefined si les données d'adresse n'ont pas été appelées à partir du serveur.
adrFormatAddress
Type:string optional
Représentation de l'adresse du lieu au microformat adr.
attributions
Type:Array<Attribution> optional
Texte de la mention à afficher pour ce résultat de lieu.
businessStatus
Type:BusinessStatus optional
État opérationnel de l'établissement. null si aucun état n'est connu. undefined si les données d'état n'ont pas été chargées à partir du serveur.
displayName
Type:string optional
Nom à afficher pour l'établissement. null si le nom n'est pas défini. undefined si les données de nom n'ont pas été chargées à partir du serveur.
formattedAddress
Type:string optional
Adresse complète des établissements.
googleMapsURI
Type:string optional
URL de la page Google officielle de ce lieu. Il s'agit de la page Google contenant les informations les plus pertinentes disponibles sur le lieu.
hasCurbsidePickup
Type:boolean optional
Indique si l'établissement propose un service de drive. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
hasDelivery
Type:boolean optional
Indique si un établissement propose la livraison. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
hasDineIn
Type:boolean optional
Indique si l'établissement propose des repas sur place. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
hasTakeout
Type:boolean optional
Indique si l'établissement propose des plats à emporter. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
hasWheelchairAccessibleEntrance
Type:boolean optional
Indique si le lieu dispose d'une entrée accessible en fauteuil roulant. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
iconBackgroundColor
Type:string optional
Code couleur hexadécimale par défaut pour la catégorie du lieu.
id
Type:string
ID de lieu unique.
internationalPhoneNumber
Type:string optional
Numéro de téléphone du lieu au format international. Le format international inclut l'indicatif du pays, précédé du signe plus (+).
isReservable
Type:boolean optional
Indique si le lieu peut être réservé. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
location
Type:LatLng optional
Position du lieu.
nationalPhoneNumber
Type:string optional
Numéro de téléphone du lieu, au format conforme à la norme régionale.
openingHours
Type:OpeningHours optional
photos
Type:Array<Photo> optional
Photos de ce lieu. La collection contiendra jusqu'à 10 objets Photo.
plusCode
Type:PlusCode optional
priceLevel
Type:PriceLevel optional
Niveau de prix du lieu. Cette propriété peut renvoyer les valeurs suivantes :
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
rating
Type:number optional
Note comprise entre 1 et 5,0 basée sur les avis des utilisateurs sur ce lieu.
requestedLanguage
Type:string optional
Langue demandée pour ce lieu.
requestedRegion
Type:string optional
Région demandée pour ce lieu.
reviews
Type:Array<Review> optional
Liste d'avis pour ce lieu.
servesBeer
Type:boolean optional
Indique si un lieu sert de la bière. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
servesBreakfast
Type:boolean optional
Indique si un établissement propose le petit-déjeuner. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
servesBrunch
Type:boolean optional
Indique si un établissement sert des brunchs. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
servesDinner
Type:boolean optional
Indique si un lieu sert le dîner. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
servesLunch
Type:boolean optional
Indique si un établissement sert le déjeuner. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
servesVegetarianFood
Type:boolean optional
Indique si un établissement sert une cuisine végétarienne. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
servesWine
Type:boolean optional
Indique si un lieu sert du vin. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Renvoie "undefined" si ce champ n'a pas encore été demandé.
svgIconMaskURI
Type:string optional
URI de la ressource de masque d'image SVG qui peut être utilisé pour représenter la catégorie d'un lieu.
types
Type:Array<string> optional
Tableau des types pour ce lieu (par exemple, ["political", "locality"] ou ["restaurant", "establishment"]).
userRatingCount
Type:number optional
Nombre de notes des visiteurs qui ont contribué au Place.rating de ce lieu.
utcOffsetMinutes
Type:number optional
Décalage par rapport à l'heure UTC du fuseau horaire actuel du lieu, en minutes. Par exemple, en heure d'été, l'heure normale de l'Est de l'Australie (GMT+10) est en avance de 11 heures sur l'heure UTC. La valeur utc_offset_minutes sera donc 660. Pour les fuseaux horaires par rapport à UTC, le décalage est négatif. Par exemple, utc_offset_minutes est -60 pour le Cap-Vert.
viewport
Type:LatLngBounds optional
Fenêtre d'affichage préférée pour l'affichage de ce lieu sur une carte.
websiteURI
Type:string optional
Site Web officiel de ce lieu (page d'accueil d'un établissement, par exemple).
BetafetchFields
fetchFields(options)
Paramètres: 
Valeur renvoyée:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
Paramètres: 
  • date:  Date optional
Valeur renvoyée:  Promise<Date optional>
Calcule la date représentant la prochaine heure d'ouverture (OpeningHoursTime). Renvoie "non défini" si les données sont insuffisantes pour calculer le résultat ou si cet emplacement n'est pas opérationnel.
BetaisOpen
isOpen([date])
Paramètres: 
  • date:  Date optional est actuellement défini par défaut.
Valeur renvoyée:  Promise<boolean optional>
Vérifiez si le lieu est ouvert à la date et à l'heure indiquées. Renvoie undefined si les données connues pour l'établissement sont insuffisantes pour le calculer (par exemple, si les horaires d'ouverture ne sont pas enregistrés).
toJSON
toJSON()
Paramètres:aucun
Return Value (Valeur renvoyée) : Object est un objet JSON contenant toutes les propriétés de lieu demandées.

PlaceOptions

Interface google.maps.places.PlaceOptions

Options de construction d'un lieu.
id
Type:string
ID de lieu unique.
requestedLanguage optional
Type:string optional
Identifiant de la langue dans laquelle les informations doivent être renvoyées. Consultez la liste des langues disponibles.
requestedRegion optional
Type:string optional
Code régional de la région de l'utilisateur. Cela peut avoir une incidence sur les photos renvoyées, voire sur d'autres éléments. Le code régional accepte une valeur ccTLD ("domaine de premier niveau") à deux caractères. La plupart des codes ccTLD sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD du Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord").

Classe AddressComponent

Classe google.maps.places.AddressComponent

Pour y accéder, appelez const {AddressComponent} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
longText
Type:string optional
Texte complet du composant d'adresse.
shortText
Type:string optional
Texte court et abrégé du composant d'adresse donné.
types
Type:Array<string>
Tableau de chaînes indiquant le type de ce composant d'adresse. Pour consulter la liste des types valides, cliquez ici.

Attribution

Classe google.maps.places.Attribution

Pour y accéder, appelez const {Attribution} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
provider
Type:string optional
Texte de la mention à afficher pour ce résultat de lieu.
providerURI
Type:string optional

Interface FetchFieldsRequest

Interface google.maps.places.FetchFieldsRequest

Options d'extraction des champs de lieu.
fields
Type:Array<string>
Liste des champs à récupérer.
sessionToken optional
Référence unique utilisée pour associer la requête de détails à une session de saisie semi-automatique.

Classe OpeningHours

Classe google.maps.places.OpeningHours

Pour y accéder, appelez const {OpeningHours} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
periods
Périodes d'ouverture couvrant tous les jours de la semaine, à partir du dimanche, dans l'ordre chronologique N'inclut pas les jours où l'établissement n'est pas ouvert.
weekdayDescriptions
Type:Array<string>
Tableau de sept chaînes représentant les horaires d'ouverture mis en forme pour chaque jour de la semaine. Le service Places met en forme et localise les horaires d'ouverture en fonction de la langue actuelle. L'ordre des éléments dans ce tableau dépend de la langue. Pour certaines langues, le premier jour de la semaine est le lundi. Pour d'autres, c'est le dimanche.

Classe OpeningHoursPeriod

Classe google.maps.places.OpeningHoursPeriod

Pour y accéder, appelez const {OpeningHoursPeriod} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
close
Type:OpeningHoursPoint optional
Heure de fermeture du lieu.
open
Heure d'ouverture du lieu.

Classe OpeningHoursPoint

Classe google.maps.places.OpeningHoursPoint

Pour y accéder, appelez const {OpeningHoursPoint} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
day
Type:number
Jour de la semaine, sous la forme d'un nombre compris dans la plage [0, 6], commençant le dimanche. Par exemple, 2 signifie Mardi.
hour
Type:number
Heure d'OpeningHoursPoint.time sous forme de nombre, compris dans la plage [0, 23]. Le fuseau horaire du lieu sera indiqué.
minute
Type:number
Minute de OpeningHoursPoint.time sous forme de nombre, compris dans la plage [0, 59]. Le fuseau horaire du lieu sera indiqué.

Classe Photo

Classe google.maps.places.Photo

Pour y accéder, appelez const {Photo} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
authorAttributions
Texte de la mention à afficher pour cette photo.
heightPx
Type:number
Hauteur de la photo en pixels.
widthPx
Type:number
Largeur de la photo en pixels.
getURI
getURI([options])
Paramètres: 
Valeur renvoyée:  string
Renvoie l'URL de l'image correspondant aux options spécifiées.

Classe AuthorAttribution

Classe google.maps.places.AuthorAttribution

Pour y accéder, appelez const {AuthorAttribution} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
displayName
Type:string
Nom de l'auteur de ce résultat.
photoURI
Type:string optional
URI de la photo de l'auteur pour ce résultat. Cette option n'est pas toujours disponible.
uri
Type:string optional
URI du profil de l'auteur pour ce résultat.

La classe PlusCode

Classe google.maps.places.PlusCode

Pour y accéder, appelez const {PlusCode} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
compoundCode
Type:string optional
Code plus code comprenant un 1/8 000e de degré par 1/8 000e d'une zone de degré, où les quatre premiers caractères (l'indicatif) sont supprimés et remplacés par une description de la localité. Exemple : "9G8F+5W Zurich, Suisse".
globalCode
Type:string optional
Plus code avec un 1/8 000e de degré par 1/8 000e de degré. Exemple : "8FVC9G8F+5W".

Classe Review

Classe google.maps.places.Review

Pour y accéder, appelez const {Review} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
authorAttribution
Type:AuthorAttribution optional
L'auteur de l'avis.
publishTime
Type:Date optional
rating
Type:number optional
Note de cet avis, à savoir un nombre compris entre 1,0 et 5,0 (inclus).
relativePublishTimeDescription
Type:string optional
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. Par exemple : "Il y a un mois".
text
Type:string optional
Texte d'un avis.
textLanguageCode
Type:string optional
Code de langue IETF indiquant la langue dans laquelle l'avis est rédigé. Notez que ce code n'inclut que le tag principal de la langue sans aucun tag secondaire indiquant le pays ou la région. Par exemple, tous les avis en anglais sont associés au libellé 'en', et non à "en-AU" ou "en-UK".

Constantes PriceLevel

Constantes google.maps.places.PriceLevel

Énumération du niveau de prix pour les objets Place.

Pour y accéder, appelez const {PriceLevel} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.
EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE