Place

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: 
searchByText
searchByText(request)
Paramètres: 
Valeur renvoyée:  Promise<{places:Array<Place>}>
Recherche de lieux basée sur une requête textuelle.
accessibilityOptions
Type:AccessibilityOptions optional
Options d'accessibilité de ce lieu. undefined si les données des options d'accessibilité n'ont pas été appelées à partir du serveur.
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.
editorialSummary
Type:string optional
Résumé éditorial de ce lieu. null s'il n'y a pas de résumé éditorial undefined si ce champ n'a pas encore été demandé.
editorialSummaryLanguageCode
Type:string optional
Langue du résumé éditorial de ce lieu. null s'il n'y a pas de résumé éditorial undefined si ce champ n'a pas encore été demandé.
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é.
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.
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.
regularOpeningHours
Type:OpeningHours optional
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).
openingHours
Type:OpeningHours optional
fetchFields
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 (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: 
  • dateDate 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").

AccessibilityOptions.

Classe google.maps.places.AccessibilityOptions

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

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.
hasWheelchairAccessibleParking
Type:boolean optional
Indique si un lieu dispose d'un parking accessible en fauteuil roulant. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue.
hasWheelchairAccessibleRestroom
Type:boolean optional
Indique si l'établissement dispose de toilettes accessibles en fauteuil roulant. Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue.
hasWheelchairAccessibleSeating
Type:boolean optional
Indique si l'établissement dispose de places assises accessibles en fauteuil roulant Renvoie "true" ou "false" si la valeur est connue. Renvoie la valeur "null" si la valeur est inconnue.

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.

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

SearchByTextRequest.

Interface google.maps.places.SearchByTextRequest

Interface de requête pour Place.searchByText.

fields
Type:Array<string>
Champs à inclure dans la réponse, qui sera facturée. Si ['*'] est transmis, tous les champs disponibles sont renvoyés et facturés (non recommandé pour les déploiements de production). Pour obtenir la liste des champs, consultez PlaceResult. Les champs imbriqués peuvent être spécifiés avec des points (par exemple, "geometry.location").
includedType optional
Type:string optional
Type de lieu demandé. Liste complète des types compatibles: https://developers.google.com/maps/documentation/places/web-service/place-types. Un seul type inclus est accepté. Voir SearchByTextRequest.useStrictTypeFiltering
isOpenNow optional
Type:boolean optional
Par défaut:false
Permet de limiter la recherche aux lieux actuellement ouverts.
language optional
Type:string optional
Les détails du lieu s'afficheront dans la langue préférée, le cas échéant. La langue définie par défaut est celle du navigateur. Liste des langues actuellement acceptées: https://developers.google.com/maps/faq#languagesupport.
locationBias optional
Région dans laquelle effectuer la recherche. Cette position sert de biais, ce qui signifie que des résultats situés à proximité d'un lieu donné peuvent être renvoyés. Ne peut pas être défini avec locationRestriction.
locationRestriction optional
Région dans laquelle effectuer la recherche. Cette zone géographique fait office de restriction, ce qui signifie que les résultats situés en dehors de la zone géographique indiquée ne seront pas renvoyés. Ne peut pas être défini avec locationBias.
maxResultCount optional
Type:number optional
Nombre maximal de résultats sur une page. Elle doit être comprise entre 1 et 20 inclus.
minRating optional
Type:number optional
Filtrez les résultats dont la note moyenne des visiteurs est strictement inférieure à cette limite. Une valeur valide doit être un nombre décimal compris entre 0 et 5 (inclus) à une cadence de 0,5, c'est-à-dire [0, 0,5, 1,0, ..., 5,0] (inclus). La note d'entrée est arrondie au 0,5 plafond supérieur le plus proche. Par exemple, une note de 0,6 élimine tous les résultats inférieurs à 1,0.
priceLevels optional
Type:Array<PriceLevel> optional
Utilisé pour limiter la recherche aux lieux signalés comme étant associés à certains niveaux de prix. Vous pouvez choisir n'importe quelle combinaison de niveaux de prix. La valeur par défaut s'applique à tous les niveaux de prix.
query optional
Type:string optional
BetarankBy optional
rankPreference optional
Par défaut:SearchByTextRankPreference.DISTANCE
Mode de classement des résultats dans la réponse.
region optional
Type:string optional
Le code pays/région Unicode (CLDR) de l'emplacement d'où provient la requête. Ce paramètre permet d'afficher des détails sur le lieu, comme son nom spécifique à une région, le cas échéant. Le paramètre peut avoir une incidence sur les résultats en fonction de la législation applicable. Pour en savoir plus, consultez la page https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Notez que les codes régionaux à trois chiffres ne sont pas acceptés pour le moment.
textQuery optional
Type:string optional
Obligatoire. Requête textuelle pour la recherche textuelle.
useStrictTypeFiltering optional
Type:boolean optional
Par défaut:false
Permet de définir un filtrage strict de type pour SearchByTextRequest.includedType. Si elle est définie sur "true", seuls les résultats du même type sont renvoyés.

Constantes SearchByTextRankPreference

Constantes google.maps.places.SearchByTextRankPreference

Énumération RankPreference pour SearchByTextRequest.

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

DISTANCE Classe les résultats par distance.
RELEVANCE Il classe les résultats par pertinence.