Place (beta)

Classe Place

Classe google.maps.places.Place

Accédez au compte en appelant 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 en fonction du numéro de téléphone donné. Renvoie un tableau en raison de rares cas où un même numéro de téléphone peut être associé à plusieurs lieux.
BetafindPlaceFromQuery
findPlaceFromQuery(request)
Paramètres:
Valeur renvoyée:  Promise<{places:Array<Place>}>
Recherche un lieu en fonction de la requête textuelle indiquée. Renvoie un tableau en raison de cas où la requête est légèrement ambiguë et où plusieurs lieux sont renvoyés. Cette méthode n'est pas destinée aux recherches pour lesquelles plusieurs résultats sont attendus.
addressComponents
Type:Array<AddressComponent> optional
Ensemble de composants d'adresse pour l'emplacement de ce lieu. Objet vide en l'absence de données d'adresse connues. undefined si les données d'adresse n'ont pas été appelées depuis le serveur.
adrFormatAddress
Type:string optional
Représentation de l'adresse de l'établissement dans le microformat adr.
attributions
Type:Array<Attribution> optional
Texte d'attribution à afficher pour ce résultat de lieu.
businessStatus
Type:BusinessStatus optional
État opérationnel de l'établissement. null si l'état n'est pas connu. undefined, si les données d'état n'ont pas été chargées depuis le serveur.
displayName
Type:string optional
Nom à afficher du lieu. null s'il n'y a pas de nom. undefined si les données de nom n'ont pas été chargées depuis le 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 un lieu dispose d'un service de Drive. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
hasDelivery
Type:boolean optional
Indique si un lieu propose la livraison. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
hasDineIn
Type:boolean optional
Indique si un lieu est ouvert sur place. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
hasTakeout
Type:boolean optional
Indique si un établissement propose des plats à emporter. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
hasWheelchairAccessibleEntrance
Type:boolean optional
Indique si un lieu dispose d'une entrée accessible en fauteuil roulant. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "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 de 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 un lieu peut être réservé. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "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 l'une des valeurs suivantes :
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
rating
Type:number optional
Note comprise entre 1, 0 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 sur ce lieu.
servesBeer
Type:boolean optional
Indique si un lieu sert de la bière. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
servesBreakfast
Type:boolean optional
Indique si un lieu sert le petit-déjeuner. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
servesBrunch
Type:boolean optional
Indique si un lieu sert un brunch. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
servesDinner
Type:boolean optional
Indique si un lieu sert le dîner. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
servesLunch
Type:boolean optional
Indique si un établissement sert le déjeuner. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
servesVegetarianFood
Type:boolean optional
Cet établissement sert-il des plats végétariens ? Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
servesWine
Type:boolean optional
Indique si un lieu sert du vin. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
svgIconMaskURI
Type:string optional
URI de la ressource de masque d'image svg pouvant 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 ayant contribué au Place.rating de ce lieu.
utcOffsetMinutes
Type:number optional
Décalage par rapport au fuseau horaire UTC du fuseau horaire actuel du lieu, en minutes. Par exemple, en heure d'été d'Australie (GMT+10), l'heure d'été est en avance de 11 heures sur l'heure UTC, et la valeur utc_offset_minutes sera 660. Pour les fuseaux horaires derrière 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 lors de l'affichage de ce lieu sur une carte.
websiteURI
Type:string optional
Site Web faisant autorité pour ce lieu, comme la page d'accueil d'un établissement.
BetafetchFields
fetchFields(options)
Paramètres:
Valeur renvoyée:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
Paramètres:
  • dateDate optional
Valeur renvoyée:  Promise<Date optional>
Calcule la date représentant la prochaine heure d'ouverture. Renvoie la valeur "undefined" si les données sont insuffisantes pour calculer le résultat, ou si ce lieu n'est pas opérationnel.
BetaisOpen
isOpen([date])
Paramètres:
  • dateDate optional est défini par défaut sur "now" (maintenant).
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 effectuer ce calcul, par exemple si les horaires d'ouverture ne sont pas enregistrés.
toJSON
toJSON()
Paramètres:aucun
Valeur renvoyée:Object un objet JSON avec toutes les propriétés Places demandées.

Interface 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 détails doivent être renvoyés. Consultez la liste des langues disponibles.
requestedRegion optional
Type:string optional
Code régional de l'utilisateur. Cela peut affecter les photos pouvant être renvoyées, et éventuellement d'autres éléments. Le code de région accepte une valeur à deux caractères associée à ccTLD ("domaine de premier niveau"). 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), alors que son code ISO 3166-1 est "gb" (pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord").

Classe AddressComponent

Classe google.maps.places.AddressComponent

Accédez au compte en appelant 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.

Classe Attribution

Classe google.maps.places.Attribution

Accédez au compte en appelant const {Attribution} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

provider
Type:string optional
Texte d'attribution à afficher pour ce résultat de lieu.
providerURI
Type:string optional

Interface FetchFieldsRequest

Interface google.maps.places.FetchFieldsRequest

Options de récupération des champs de lieu.

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

Classe OpeningHours

Classe google.maps.places.OpeningHours

Accédez au compte en appelant const {OpeningHours} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

periods
Périodes d'ouverture pour chaque jour de la semaine, à partir du dimanche, dans l'ordre chronologique. N'inclut pas les jours où le lieu n'est pas ouvert.
weekdayDescriptions
Type:Array<string>
Tableau de sept chaînes représentant les horaires d'ouverture formatées pour chaque jour de la semaine. Le service Places formate et localise les horaires d'ouverture de manière appropriée dans 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

Accédez au compte en appelant 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

Accédez au compte en appelant const {OpeningHoursPoint} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

day
Type:number
Jour de la semaine, sous forme de nombre compris entre [0, 6] et le dimanche. Par exemple, 2 signifie Mardi.
hour
Type:number
Heure de l'OpeningHoursPoint.time sous forme de nombre, compris entre 0 et 23. Il sera affiché dans le fuseau horaire du lieu.
minute
Type:number
Minute d'OpeningHoursPoint.time sous forme de nombre (0, 59). Il sera affiché dans le fuseau horaire du lieu.

Classe Photo

Classe google.maps.places.Photo

Accédez au compte en appelant const {Photo} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

attributions
Texte d'attribution à 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 PhotoAttribution

Classe google.maps.places.PhotoAttribution

Accédez au compte en appelant const {PhotoAttribution} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

author
Type:string
Texte d'attribution à afficher pour ce résultat de photo.
authorURI
Type:string optional

Classe PlusCode

Classe google.maps.places.PlusCode

Accédez au compte en appelant const {PlusCode} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

compoundCode
Type:string optional
Un code plus un 1/8000e de degré par 1/8000e de degré, où les quatre premiers caractères (l'indicatif) sont déposés et remplacés par une description de la localité. Exemple : "9G8F+5W Zurich, Suisse".
globalCode
Type:string optional
Un plus code avec une échelle de 1/8000e de degré et 1/8000e de degré Exemple : "8FVC9G8F+5W".

Classe Review

Classe google.maps.places.Review

Accédez au compte en appelant const {Review} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

author
Type:string optional
Nom de l'auteur de l'avis.
authorPhotoURI
Type:string optional
URL de l'image de profil du réviseur.
authorURI
Type:string optional
URL du profil de l'auteur de l'avis.
publishTime
Type:Date optional
rating
Type:number optional
Note attribuée à l'avis, comprise entre 1,0 et 5,0 (inclus).
relativePublishTimeDescription
Type:string optional
Chaîne d'heure récente formatée, exprimant l'heure d'examen par rapport à l'heure actuelle, dans un format adapté à la langue et au pays. Par exemple "Il y a 1 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 ne comprend que le tag de langue principal, sans qu'un tag secondaire indique un pays ou une région. Par exemple, tous les avis en anglais sont associés au libellé 'en' au lieu de "en-AU" ou "en-UK".

Constantes PriceLevel

Constantes google.maps.places.PriceLevel

Énumération au niveau du prix des objets Place.

Accédez au compte en appelant const {PriceLevel} = await google.maps.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE