Place (beta)

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Place

Classe google.maps.places.Place

Chargez à l'aide du paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {Place} = await google.map.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

Place
Place(options)
Paramètres :
findPlaceFromPhoneNumber
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ù plusieurs lieux peuvent partager un numéro de téléphone.
findPlaceFromQuery
findPlaceFromQuery(request)
Paramètres:
Valeur renvoyée:Promise<{places:Array<Place>}>
Recherche un lieu à partir d'une requête textuelle donné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 conçue pour les recherches pour lesquelles plusieurs résultats sont attendus.
addressComponents
Type:Array<AddressComponent> optional
Collection 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 du lieu au 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 aucun état n'est 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 meilleures informations 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 "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 "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
hasDineIn
Type : boolean optional
Un restaurant sur place. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie "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 "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 est accessible en fauteuil roulant. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
icon
Type:string optional
URL d'une ressource d'image pouvant représenter la catégorie de cet établissement.
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 "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:number optional
Niveau de tarification du lieu, sur une échelle de 0 à 4. Les niveaux de prix sont interprétés comme suit:
  • 0: offert
  • 1: petit prix
  • 2: modéré
  • 3 : coûteux
  • 4 : très cher
rating
Type:number optional
Note comprise entre 1 et 5, 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 des avis pour 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 "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
servesBreakfast
Type : boolean optional
Indique si un établissement sert le petit-déjeuner. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie "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 "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 "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
servesLunch
Type : boolean optional
Indique si un lieu sert le déjeuner. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie "null" si la valeur est inconnue. Affiche "undefined" si ce champ n'a pas encore été demandé.
servesVegetarianFood
Type:boolean optional
Indique si un établissement sert des plats végétariens. Affiche la valeur "true" ou "false" si la valeur est connue. Renvoie "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 "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 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"]).
userRatingsCount
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 au UTC du fuseau horaire actuel du lieu, en minutes. Par exemple, l'heure normale de l'Est (GMT+10) est à 11 heures avant l'heure UTC, donc la valeur de utc_offset_minutes sera 660. Pour les fuseaux horaires de type UTC, le décalage est négatif. Par exemple, utc_offset_minutes est -60 pour le Cap-Vert.
viewport
Type : LatLngBounds optional
Vue actuelle 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.
fetchFields
fetchFields(options)
Paramètres :
Valeur renvoyée:Promise<{place:Place}>
getNextOpeningTime
getNextOpeningTime([date])
Paramètres :
  • date : Date optional
Valeur renvoyée:Promise<Date optional>
Calcule l'horodatage (en millisecondes depuis l'époque, adapté à une utilisation avec new Date()) représentant le prochain OpeningHoursTime. Renvoie "non défini" si les données sont insuffisantes pour calculer le résultat, ou si ce lieu n'est pas opérationnel.
isOpen
isOpen([date])
Paramètres :
  • dateDate optional la valeur par défaut est "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 de l'établissement sont insuffisantes pour calculer cette valeur, par exemple si les horaires d'ouverture ne sont pas enregistrés.

Interface PlaceOptions

google.maps.places.PlaceOptions interface

Options de construction d'un lieu.

Chargez à l'aide du paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

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 de région de l'utilisateur. Cela peut affecter les photos renvoyées, voire d'autres éléments. Le code de région 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) alors 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

Chargez à l'aide du paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {AddressComponent} = await google.map.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

Chargez à l'aide du paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {Attribution} = await google.map.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

google.maps.places.FetchFieldsRequest interface

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

Chargez à l'aide du paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

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.

OpeningHours

Classe google.maps.places.OpeningHours

Chargez à l'aide du paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {OpeningHours} = await google.map.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

periods
Ouverture de 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 heures d'ouverture formatées pour chaque jour de la semaine. Le service Places met en forme et localise les horaires d'ouverture dans la langue actuelle. L'ordre des éléments dans ce tableau dépend de la langue. Certaines langues commencent la semaine le lundi, tandis que d'autres le dimanche.

OpeningHoursPeriod

Classe google.maps.places.OpeningHoursPeriod

Chargez à l'aide du paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {OpeningHoursPeriod} = await google.map.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.

OpeningHoursPoint

Classe google.maps.places.OpeningHoursPoint

Chargez à l'aide du paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {OpeningHoursPoint} = await google.map.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

day
Type:number
Jour de la semaine, sous forme de nombre compris entre 0 et 6, à partir du dimanche. Par exemple, 2 signifie Mardi.
hour
Type:number
Heure de l'ouverture de OpeningHoursPoint.time sous forme de nombre compris entre 0 et 23. Il sera indiqué dans le fuseau horaire du lieu.
minute
Type : number
Minute de OpeningHoursPoint.time sous forme de nombre, comprise entre 0 et 59. Il sera indiqué dans le fuseau horaire du lieu.

cours Photo

Classe google.maps.places.Photo

Chargez à l'aide du paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {Photo} = await google.map.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.

PhotoAttribution

Classe google.maps.places.PhotoAttribution

Chargez à l'aide du paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {PhotoAttribution} = await google.map.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

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

PlusCode

Classe google.maps.places.PlusCode

Chargez à l'aide du paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {PlusCode} = await google.map.importLibrary("places"). Consultez Bibliothèques dans l'API Maps JavaScript.

compoundCode
Type : string optional
Un code plus avec 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 localité. Exemple : "9G8F+5W Zurich, Suisse".
globalCode
Type:string optional
Un code plus avec un 1/8000e de degré par 1/8000e de degré. Exemple : "8FVC9G8F+5W".

Review

Classe google.maps.places.Review

Chargez à l'aide du paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

Lorsque vous utilisez v=beta, vous pouvez y accéder en appelant const {Review} = await google.map.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 visiteur.
authorURI
Type : string optional
URL du profil du contributeur.
publishTime
Type : Date optional
rating
Type : number optional
Note attribuée à cet avis (entre 1 et 5).
relativePublishTimeDescription
Type:string optional
Chaîne d'heure récente mise en forme qui exprime 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 cet avis est rédigé. Notez que ce code n'inclut que la balise de langue principale, sans aucune balise secondaire indiquant le pays ou la région. Par exemple, tous les avis en anglais sont associés au libellé 'en' au lieu de "en-AU" ou "en-UK".