Places Widgets

Classe PlaceAutocompleteElement

Classe google.maps.places.PlaceAutocompleteElement

PlaceAutocompleteElement est une sous-classe HTMLElement qui fournit un composant d'UI pour l'API Places Autocomplete.

 PlaceAutocompleteElement utilise automatiquement des AutocompleteSessionToken en interne pour regrouper les phases de requête et de sélection d'une recherche de saisie semi-automatique d'un utilisateur.

 Le premier appel à Place.fetchFields sur un Place renvoyé par PlacePrediction.toPlace inclura automatiquement le jeton de session utilisé pour récupérer le PlacePrediction.

 Pour en savoir plus sur le fonctionnement des sessions, consultez https://developers.google.com/maps/documentation/places/web-service/place-session-tokens.

Élément personnalisé :
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-place-autocomplete>

Cette classe étend HTMLElement.

Cette classe implémente PlaceAutocompleteElementOptions.

Accédez-y en appelant le const {PlaceAutocompleteElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Paramètres :
includedPrimaryTypes
Type : Array<string> optional
Type de lieu principal inclus (par exemple, "restaurant" ou "gas_station").

 Un lieu n'est renvoyé que si son type principal est inclus dans cette liste. Vous pouvez spécifier jusqu'à cinq valeurs. Si aucun type n'est spécifié, tous les types de lieux sont renvoyés.
Attribut HTML :
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes
Type : Array<string> optional
Incluez uniquement les résultats dans les régions spécifiées, sous forme de 15 codes de région CLDR à deux caractères maximum. Un ensemble vide ne limitera pas les résultats. Si locationRestriction et includedRegionCodes sont tous les deux définis, les résultats se trouveront dans la zone d'intersection.
Attribut HTML :
  • <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias
Type : LocationBias optional
Limite ou indication souple à utiliser lors de la recherche de lieux.
locationRestriction
Type : LocationRestriction optional
Limites pour contraindre les résultats de recherche.
name
Type : string optional
Nom à utiliser pour l'élément d'entrée. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name. Il suit le même comportement que l'attribut "name" pour les entrées. Notez qu'il s'agit du nom qui sera utilisé lorsqu'un formulaire sera envoyé. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
Attribut HTML :
  • <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin
Origine à partir de laquelle calculer la distance. Si aucune valeur n'est spécifiée, la distance n'est pas calculée. L'altitude, si elle est indiquée, n'est pas utilisée dans le calcul.
Attribut HTML :
  • <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete>
  • <gmp-place-autocomplete origin="lat,lng,altitude"></gmp-place-autocomplete>
requestedLanguage
Type : string optional
Identifiant de la langue dans laquelle les résultats doivent être renvoyés, si possible. Les résultats dans la langue sélectionnée peuvent être mieux classés, mais les suggestions ne sont pas limitées à cette langue. Consultez la liste des langues disponibles.
Attribut HTML :
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
Type : string optional
Code de région utilisé pour la mise en forme et le filtrage des résultats. Cela ne limite pas les suggestions à ce pays. 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").
Attribut HTML :
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
unitSystem
Type : UnitSystem optional
Système d'unités utilisé pour afficher les distances. Si elle n'est pas spécifiée, le système d'unités est déterminé par requestedRegion.
Attribut HTML :
  • <gmp-place-autocomplete unit-system="metric"></gmp-place-autocomplete>
  • <gmp-place-autocomplete unit-system="imperial"></gmp-place-autocomplete>
prediction-item
Élément du menu déroulant des prédictions qui représente une seule prédiction.
prediction-item-icon
Icône affichée à gauche de chaque élément dans la liste des prédictions.
prediction-item-main-text
Partie d'un élément de prédiction qui constitue le texte principal de la prédiction. Pour les emplacements géographiques, cet élément contient le nom du lieu, par exemple "Sydney", ou le nom et le numéro d'une rue, comme "10 King Street". Par défaut, le texte principal de l'élément de prédiction est noir. Si l'élément de prédiction contient du texte supplémentaire, il se trouve en dehors de prediction-item-main-text et hérite son style de prediction-item. Par défaut, il apparaît en gris. Le texte additionnel est généralement une adresse.
prediction-item-match
Partie de la prédiction renvoyée qui correspond à ce qu'a saisi l'utilisateur. Par défaut, le texte correspondant apparaît en gras. Notez que le texte correspondant peut se trouver n'importe où dans prediction-item. Il ne fait pas nécessairement partie de prediction-item-main-text.
prediction-item-selected
Élément vers lequel l'utilisateur accède à l'aide du clavier. Remarque : Les éléments sélectionnés seront affectés à la fois par les styles de cette partie et par les styles de la partie "prediction-item".
prediction-list
Élément visuel contenant la liste des prédictions renvoyées par le service Place Autocomplete. Cette liste apparaît sous forme de liste déroulante sous PlaceAutocompleteElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.
gmp-error
function(errorEvent)
Arguments : 
Cet événement est déclenché lorsqu'une requête envoyée au backend a été refusée (par exemple, clé API incorrecte). Cet événement ne remonte pas.
gmp-select
function(placePredictionSelectEvent)
Arguments : 
Cet événement est déclenché lorsqu'un utilisateur sélectionne une prédiction de lieu. Contient un objet PlacePrediction qui peut être converti en objet Place.

PlaceAutocompleteElementOptions interface

Interface google.maps.places.PlaceAutocompleteElementOptions

Options de construction d'un PlaceAutocompleteElement. Pour obtenir la description de chaque propriété, consultez la propriété du même nom dans la classe PlaceAutocompleteElement.
locationBias optional
Type : LocationBias optional
locationRestriction optional
Type : LocationRestriction optional
name optional
Type : string optional
requestedLanguage optional
Type : string optional

Classe PlacePredictionSelectEvent

Classe google.maps.places.PlacePredictionSelectEvent

Cet événement est créé une fois que l'utilisateur a sélectionné un élément de prédiction avec PlaceAutocompleteElement. Accédez à la sélection avec event.placePrediction.

 Convertissez placePrediction en Place en appelant PlacePrediction.toPlace.

Cette classe étend Event.

Accédez-y en appelant le const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
placePrediction
Convertissez-le en Place en appelant PlacePrediction.toPlace.

PlaceAutocompleteRequestErrorEvent class

Classe google.maps.places.PlaceAutocompleteRequestErrorEvent

Cet événement est émis par PlaceAutocompleteElement en cas de problème avec la requête réseau.

Cette classe étend Event.

Accédez-y en appelant le const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.

Classe PlaceContextualElement

Classe google.maps.places.PlaceContextualElement

Widget qui utilise le jeton de contexte pour afficher une vue contextuelle de la réponse d'ancrage avec Google Maps.

Élément personnalisé :
<gmp-place-contextual context-token="string"></gmp-place-contextual>

Cette classe étend HTMLElement.

Cette classe implémente PlaceContextualElementOptions.

Accédez-y en appelant le const {PlaceContextualElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
contextToken
Type : string optional
Jeton de contexte.
Attribut HTML :
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

Interface PlaceContextualElementOptions

Interface google.maps.places.PlaceContextualElementOptions

Options pour PlaceContextualElement.
contextToken optional
Type : string optional
Jeton de contexte fourni par la réponse "Ancrage avec Google Maps".

PlaceContextualListConfigElement class

Classe google.maps.places.PlaceContextualListConfigElement

Élément HTML qui configure les options de la vue Liste de l'élément contextuel de lieu.

Élément personnalisé :
<gmp-place-contextual-list-config layout="compact" map-hidden></gmp-place-contextual-list-config>

Cette classe étend HTMLElement.

Cette classe implémente PlaceContextualListConfigElementOptions.

Accédez-y en appelant le const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
layout
Type : PlaceContextualListLayout optional
La mise en page.
Attribut HTML :
  • <gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>
mapHidden
Type : boolean optional
Indique si la carte est masquée.
Attribut HTML :
  • <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

Interface PlaceContextualListConfigElementOptions

Interface google.maps.places.PlaceContextualListConfigElementOptions

Options pour PlaceContextualListConfigElement.
layout optional
Type : PlaceContextualListLayout optional
La mise en page. La valeur par défaut est PlaceContextualListLayout.VERTICAL.
mapHidden optional
Type : boolean optional
Indique si la carte est masquée. Par défaut, la carte est affichée (valeur "false").

Constantes PlaceContextualListLayout

google.maps.places.PlaceContextualListLayout constantes

Liste des mises en page que l'élément contextuel de lieu accepte pour la vue Liste.

Accédez-y en appelant le const {PlaceContextualListLayout} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
COMPACT Mise en page de liste compacte : les éléments de liste sont affichés sous forme de liens sur une seule ligne, avec les éléments en trop dans une liste déroulante.
VERTICAL Mise en page en liste verticale : les éléments de la liste sont affichés sous forme de cartes dans une liste verticale.

Classe PlaceDetailsElement

Classe google.maps.places.PlaceDetailsElement

Élément HTML qui affiche les détails d'un lieu. Utilisez les méthodes configureFromPlace() ou configureFromLocation() pour spécifier le contenu à afficher. Pour utiliser l'élément Détails du lieu, activez l'API Places UI Kit pour votre projet dans la console Google Cloud.

Élément personnalisé :
<gmp-place-details size="small"></gmp-place-details>

Cette classe étend HTMLElement.

Cette classe implémente PlaceDetailsElementOptions.

Accédez-y en appelant le const {PlaceDetailsElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceDetailsElement
PlaceDetailsElement([options])
Paramètres :
place
Type : Place optional
Lecture seule. Objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu actuellement affiché.
size
Type : PlaceDetailsSize optional
Variante de taille de PlaceDetailsElement. Par défaut, l'élément affiche PlaceDetailsSize.X_LARGE.
Attribut HTML :
  • <gmp-place-details size="small"></gmp-place-details>
  • <gmp-place-details size="medium"></gmp-place-details>
  • <gmp-place-details size="large"></gmp-place-details>
  • <gmp-place-details size="x-large"></gmp-place-details>
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
configureFromLocation
configureFromLocation(location)
Paramètres :
Valeur de renvoi : Promise<void>. Promesse qui se résout une fois que les données du lieu sont chargées et affichées.
Configure le widget à partir d'un LatLng à l'aide du geocoding inversé.
configureFromPlace
configureFromPlace(place)
Paramètres :
  • place : Place|{id:string} lieu pour lequel afficher les détails.
Valeur de renvoi : Promise<void>. Promesse qui se résout une fois que les données du lieu sont chargées et affichées.
Configure le widget à partir d'un objet Place ou d'un ID de lieu.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.
gmp-load
function(event)
Arguments : 
Cet événement est déclenché lorsque l'élément charge et affiche son contenu. Cet événement ne remonte pas.
gmp-requesterror
function(event)
Arguments : 
Cet événement est déclenché lorsqu'une requête envoyée au backend a été refusée (par exemple, clé API incorrecte). Cet événement ne remonte pas.

Interface PlaceDetailsElementOptions

Interface google.maps.places.PlaceDetailsElementOptions

Options pour PlaceDetailsElement.
size optional
Type : PlaceDetailsSize optional
Voir les PlaceDetailsElement.size

Constantes PlaceDetailsSize

google.maps.places.PlaceDetailsSize constantes

Variantes de taille pour PlaceDetailsElement.

Accédez-y en appelant le const {PlaceDetailsSize} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
LARGE Variante de grande taille incluant une grande image, des informations de base et des coordonnées.
MEDIUM Variante moyenne incluant une grande image et des informations de base.
SMALL Petite variante incluant une petite image et des informations de base.
X_LARGE Variante extra-large incluant un collage de photos, des avis et des informations complètes sur le lieu.

Classe PlaceDetailsCompactElement

Classe google.maps.places.PlaceDetailsCompactElement

Affiche les détails d'un lieu dans une mise en page compacte. Ajoutez un PlaceDetailsPlaceRequestElement pour spécifier le lieu à afficher. Ajoutez PlaceContentConfigElement, PlaceStandardContentElement ou PlaceAllContentElement pour spécifier le contenu à afficher.

 Pour utiliser cet élément, activez l'API Places UI Kit pour votre projet dans la console Google Cloud.

Élément personnalisé :
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

Cette classe étend HTMLElement.

Cette classe implémente PlaceDetailsCompactElementOptions.

Accédez-y en appelant le const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
Paramètres :
orientation
Type : PlaceDetailsOrientation optional
Par défaut : PlaceDetailsOrientation.VERTICAL
Variante d'orientation (verticale ou horizontale) de l'élément.
Attribut HTML :
  • <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact>
  • <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place
Type : Place optional
Lecture seule. Objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu actuellement affiché.
truncationPreferred
Type : boolean
Par défaut : false
Si la valeur est "true", le nom et l'adresse du lieu sont tronqués pour tenir sur une seule ligne au lieu d'être renvoyés à la ligne.
Attribut HTML :
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-mat-color-info
Couleur des éléments d'interface utilisateur avec un sentiment informatif. Utilisé pour l'icône de fauteuil roulant.
--gmp-mat-color-negative
Couleur des éléments d'UI avec un sentiment négatif. Utilisé pour le texte "Fermé" dans l'état "Ouvert actuellement".
--gmp-mat-color-neutral-container
Couleur du conteneur pour les éléments d'interface utilisateur neutres remplis. Utilisé pour les espaces réservés aux images.
--gmp-mat-color-on-secondary-container
Couleur du texte et des icônes par rapport à la couleur du conteneur secondaire. Utilisée pour le texte et les icônes du bouton "Ouvrir dans Maps".
--gmp-mat-color-on-surface
Couleur du texte et des icônes par rapport à n'importe quelle couleur de surface. Utilisé pour le texte normal.
--gmp-mat-color-on-surface-variant
Couleur de faible intensité pour le texte et les icônes sur n'importe quelle couleur de surface. Utilisé pour le texte moins important.
--gmp-mat-color-outline-decorative
Couleur du contour des éléments non interactifs. Utilisé pour la bordure de l'élément.
--gmp-mat-color-positive
Couleur des éléments d'UI avec un sentiment positif. Utilisé pour le texte "Ouvert" dans l'état "Ouvert actuellement".
--gmp-mat-color-primary
Couleur du texte et des icônes interactifs par rapport à la couleur de la surface. Utilisé pour le nombre d'avis et les liens dans la boîte de dialogue d'attribution.
--gmp-mat-color-secondary-container
Couleur de remplissage moins visible sur la surface, pour les composants récessifs tels que les boutons tonaux. Utilisé pour l'arrière-plan du bouton "Ouvrir dans Maps".
--gmp-mat-color-surface
Couleur des arrière-plans. Utilisé pour les arrière-plans de l'élément et de la boîte de dialogue d'attribution.
--gmp-mat-font-body-medium
Utilisé pour le corps du texte dans la boîte de dialogue d'attribution.
--gmp-mat-font-body-small
Utilisé pour l'adresse, la note, le type, le prix et l'état (ouvert ou fermé) du lieu.
--gmp-mat-font-family
Famille de polices de base utilisée pour tout le texte.
--gmp-mat-font-headline-medium
Utilisé pour le texte d'en-tête dans la boîte de dialogue d'attribution.
--gmp-mat-font-label-large
Utilisé pour le bouton "Ouvrir dans Maps" et les liens dans la boîte de dialogue d'attribution.
--gmp-mat-font-title-small
Utilisé pour le nom du lieu.
background-color
Remplace la couleur d'arrière-plan de l'élément.
border
Remplace la bordure de l'élément.
border-radius
Remplace le rayon de bordure de l'élément.
color-scheme
Indique le jeu de couleurs dans lequel cet élément peut être affiché. Pour en savoir plus, consultez la documentation color-scheme. La valeur par défaut est color-scheme: light dark.
font-size
Met à l'échelle tous les textes et icônes de l'élément, qui sont définis en ems en interne. La valeur par défaut est 16px.
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.
gmp-error
function(event)
Arguments : 
Cet événement est déclenché lorsqu'une requête envoyée au backend a été refusée (par exemple, clé API incorrecte). Cet événement ne remonte pas.
gmp-load
function(event)
Arguments : 
Cet événement est déclenché lorsque l'élément charge et affiche son contenu. Cet événement ne remonte pas.

Interface PlaceDetailsCompactElementOptions

Interface google.maps.places.PlaceDetailsCompactElementOptions

Options pour PlaceDetailsCompactElement.
orientation optional
Type : PlaceDetailsOrientation optional
Consultez les PlaceDetailsCompactElement.orientation.
truncationPreferred optional
Type : boolean optional
Consultez les PlaceDetailsCompactElement.truncationPreferred.

Constantes PlaceDetailsOrientation

google.maps.places.PlaceDetailsOrientation constantes

Variantes d'orientation pour PlaceDetailsCompactElement.

Accédez-y en appelant le const {PlaceDetailsOrientation} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
HORIZONTAL Orientation horizontale.
VERTICAL Orientation verticale.

PlaceDetailsPlaceRequestElement class

Classe google.maps.places.PlaceDetailsPlaceRequestElement

Configure un élément compact d'informations sur un lieu pour charger des données en fonction d'un objet, d'un ID ou d'un nom de ressource de lieu. Ajoutez cet élément en tant qu'enfant d'un PlaceDetailsCompactElement pour charger les données du lieu spécifié.

Élément personnalisé :
<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

Cette classe étend HTMLElement.

Cette classe implémente PlaceDetailsPlaceRequestElementOptions.

Accédez-y en appelant le const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
Paramètres :
place
Type : Place optional
Objet, ID ou nom de ressource du lieu pour lequel afficher les détails dans l'élément compact "Détails du lieu". Cette propriété reflète l'attribut en tant que nom de ressource.
Attribut HTML :
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

PlaceDetailsPlaceRequestElementOptions interface

Interface google.maps.places.PlaceDetailsPlaceRequestElementOptions

Options pour PlaceDetailsPlaceRequestElement.
place optional
Type : Place|string optional
Voir les PlaceDetailsPlaceRequestElement.place

PlaceContentConfigElement class

Classe google.maps.places.PlaceContentConfigElement

Configure le contenu à afficher par un élément compact "Détails du lieu". Pour l'utiliser, ajoutez cet élément en tant qu'enfant d'un PlaceDetailsCompactElement. Ajoutez l'un des éléments suivants à PlaceContentConfigElement pour afficher le contenu correspondant :
PlaceMediaElement, PlaceAddressElement, PlaceRatingElement, PlaceTypeElement, PlacePriceElement, PlaceAccessibleEntranceIconElement, PlaceOpenNowStatusElement, PlaceAttributionElement
L'ordre des enfants n'a pas d'importance. L'élément affiche le contenu dans un ordre standard qui n'est pas personnalisable.

Élément personnalisé :
<gmp-place-content-config></gmp-place-content-config>

Cette classe étend HTMLElement.

Cette classe implémente PlaceContentConfigElementOptions.

Accédez-y en appelant le const {PlaceContentConfigElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceContentConfigElement
PlaceContentConfigElement([options])
Paramètres :
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

PlaceContentConfigElementOptions interface

Interface google.maps.places.PlaceContentConfigElementOptions

Options pour PlaceContentConfigElement.

Classe PlaceMediaElement

Classe google.maps.places.PlaceMediaElement

Configure un élément compact d'informations sur un lieu pour afficher les contenus multimédias d'un lieu, comme des photos. Pour l'utiliser, ajoutez cet élément en tant qu'enfant d'un PlaceContentConfigElement.

Élément personnalisé :
<gmp-place-media lightbox-preferred></gmp-place-media>

Cette classe étend HTMLElement.

Cette classe implémente PlaceMediaElementOptions.

Accédez-y en appelant le const {PlaceMediaElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceMediaElement
PlaceMediaElement([options])
Paramètres :
lightboxPreferred
Type : boolean optional
Par défaut : false
Indique s'il faut activer ou désactiver la lightbox multimédia, dans les cas où les deux options sont prises en charge.
Attribut HTML :
  • <gmp-place-media lightbox-preferred></gmp-place-media>
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

Interface PlaceMediaElementOptions

Interface google.maps.places.PlaceMediaElementOptions

Options pour PlaceMediaElement.
lightboxPreferred optional
Type : boolean optional
Consultez les PlaceMediaElement.lightboxPreferred.

Classe PlaceAddressElement

Classe google.maps.places.PlaceAddressElement

Configure un élément compact "Détails du lieu" pour afficher l'adresse d'un lieu. Pour l'utiliser, ajoutez cet élément en tant qu'enfant d'un PlaceContentConfigElement.

Élément personnalisé :
<gmp-place-address></gmp-place-address>

Cette classe étend HTMLElement.

Cette classe implémente PlaceAddressElementOptions.

Accédez-y en appelant le const {PlaceAddressElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceAddressElement
PlaceAddressElement([options])
Paramètres :
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

PlaceAddressElementOptions interface

Interface google.maps.places.PlaceAddressElementOptions

Options pour PlaceAddressElement.

Classe PlaceRatingElement

Classe google.maps.places.PlaceRatingElement

Configure un élément compact "Détails du lieu" pour afficher la note d'un lieu. Pour l'utiliser, ajoutez cet élément en tant qu'enfant d'un PlaceContentConfigElement.

Élément personnalisé :
<gmp-place-rating></gmp-place-rating>

Cette classe étend HTMLElement.

Cette classe implémente PlaceRatingElementOptions.

Accédez-y en appelant le const {PlaceRatingElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceRatingElement
PlaceRatingElement([options])
Paramètres :
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

PlaceRatingElementOptions interface

Interface google.maps.places.PlaceRatingElementOptions

Options pour PlaceRatingElement.

Classe PlaceTypeElement

Classe google.maps.places.PlaceTypeElement

Configure un élément compact de détails sur un lieu pour afficher le type d'un lieu. Pour l'utiliser, ajoutez cet élément en tant qu'enfant d'un PlaceContentConfigElement.

Élément personnalisé :
<gmp-place-type></gmp-place-type>

Cette classe étend HTMLElement.

Cette classe implémente PlaceTypeElementOptions.

Accédez-y en appelant le const {PlaceTypeElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceTypeElement
PlaceTypeElement([options])
Paramètres :
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

Interface PlaceTypeElementOptions

Interface google.maps.places.PlaceTypeElementOptions

Options pour PlaceTypeElement.

Classe PlacePriceElement

Classe google.maps.places.PlacePriceElement

Configure un élément compact "Détails du lieu" pour afficher le niveau de prix ou la gamme de prix d'un lieu. Pour l'utiliser, ajoutez cet élément en tant qu'enfant d'un PlaceContentConfigElement.

Élément personnalisé :
<gmp-place-price></gmp-place-price>

Cette classe étend HTMLElement.

Cette classe implémente PlacePriceElementOptions.

Accédez-y en appelant le const {PlacePriceElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlacePriceElement
PlacePriceElement([options])
Paramètres :
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

PlacePriceElementOptions interface

Interface google.maps.places.PlacePriceElementOptions

Options pour PlacePriceElement.

Classe PlaceAccessibleEntranceIconElement

Classe google.maps.places.PlaceAccessibleEntranceIconElement

Configure un élément compact de détails sur le lieu pour afficher une icône de fauteuil roulant si le lieu dispose d'une entrée accessible. Pour l'utiliser, ajoutez cet élément en tant qu'enfant d'un PlaceContentConfigElement.

Élément personnalisé :
<gmp-place-accessible-entrance-icon></gmp-place-accessible-entrance-icon>

Cette classe étend HTMLElement.

Cette classe implémente PlaceAccessibleEntranceIconElementOptions.

Accédez-y en appelant le const {PlaceAccessibleEntranceIconElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceAccessibleEntranceIconElement
PlaceAccessibleEntranceIconElement([options])
Paramètres :
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

Interface PlaceAccessibleEntranceIconElementOptions

Interface google.maps.places.PlaceAccessibleEntranceIconElementOptions

Options pour PlaceAccessibleEntranceIconElement.

PlaceOpenNowStatusElement class

Classe google.maps.places.PlaceOpenNowStatusElement

Configure un élément compact Place Details pour afficher l'état actuel d'un lieu (ouvert ou fermé). Pour l'utiliser, ajoutez cet élément en tant qu'enfant d'un PlaceContentConfigElement.

Élément personnalisé :
<gmp-place-open-now-status></gmp-place-open-now-status>

Cette classe étend HTMLElement.

Cette classe implémente PlaceOpenNowStatusElementOptions.

Accédez-y en appelant le const {PlaceOpenNowStatusElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceOpenNowStatusElement
PlaceOpenNowStatusElement([options])
Paramètres :
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

PlaceOpenNowStatusElementOptions interface

Interface google.maps.places.PlaceOpenNowStatusElementOptions

Options pour PlaceOpenNowStatusElement.

Classe PlaceAttributionElement

Classe google.maps.places.PlaceAttributionElement

Permet de personnaliser le texte d'attribution Google Maps dans un élément compact "Détails du lieu". Pour l'utiliser, ajoutez cet élément en tant qu'enfant d'un PlaceContentConfigElement. Si cet élément est omis, l'attribution sera toujours affichée avec les couleurs par défaut.

Élément personnalisé :
<gmp-place-attribution dark-scheme-color="white" light-scheme-color="white"></gmp-place-attribution>

Cette classe étend HTMLElement.

Cette classe implémente PlaceAttributionElementOptions.

Accédez-y en appelant le const {PlaceAttributionElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceAttributionElement
PlaceAttributionElement([options])
Paramètres :
darkSchemeColor
Type : AttributionColor optional
Par défaut : AttributionColor.WHITE
Couleur de l'attribution Google Maps en mode sombre.
Attribut HTML :
  • <gmp-place-attribution dark-scheme-color="white"></gmp-place-attribution>
  • <gmp-place-attribution dark-scheme-color="black"></gmp-place-attribution>
  • <gmp-place-attribution dark-scheme-color="gray"></gmp-place-attribution>
lightSchemeColor
Type : AttributionColor optional
Par défaut : AttributionColor.GRAY
Couleur de l'attribution Google Maps en mode clair.
Attribut HTML :
  • <gmp-place-attribution light-scheme-color="white"></gmp-place-attribution>
  • <gmp-place-attribution light-scheme-color="black"></gmp-place-attribution>
  • <gmp-place-attribution light-scheme-color="gray"></gmp-place-attribution>
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

Interface PlaceAttributionElementOptions

Interface google.maps.places.PlaceAttributionElementOptions

Options pour PlaceAttributionElement.
darkSchemeColor optional
Type : AttributionColor optional
Consultez les PlaceAttributionElement.darkSchemeColor.
lightSchemeColor optional
Type : AttributionColor optional
Consultez les PlaceAttributionElement.lightSchemeColor.

Constantes AttributionColor

google.maps.places.AttributionColor constantes

Options de couleur pour le texte d'attribution Google Maps. L'attribution peut être personnalisée pour utiliser l'une de ces couleurs.

Accédez-y en appelant le const {AttributionColor} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
BLACK Texte d'attribution noir.
GRAY Texte d'attribution gris.
WHITE Texte d'attribution blanc.

Classe PlaceAllContentElement

Classe google.maps.places.PlaceAllContentElement

Configure un élément compact "Détails du lieu" pour afficher tout le contenu disponible. Pour l'utiliser, ajoutez cet élément en tant qu'enfant d'un PlaceDetailsCompactElement.

Élément personnalisé :
<gmp-place-all-content></gmp-place-all-content>

Cette classe étend HTMLElement.

Cette classe implémente PlaceAllContentElementOptions.

Accédez-y en appelant le const {PlaceAllContentElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceAllContentElement
PlaceAllContentElement([options])
Paramètres :
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

Interface PlaceAllContentElementOptions

Interface google.maps.places.PlaceAllContentElementOptions

Options pour PlaceAllContentElement.

Classe PlaceStandardContentElement

Classe google.maps.places.PlaceStandardContentElement

Configure un élément compact d'informations sur un lieu pour afficher un ensemble standard de contenus (média, note, type, prix, icône d'entrée accessible et état "ouvert actuellement"). Pour l'utiliser, ajoutez cet élément en tant qu'enfant d'un PlaceDetailsCompactElement.

Élément personnalisé :
<gmp-place-standard-content></gmp-place-standard-content>

Cette classe étend HTMLElement.

Cette classe implémente PlaceStandardContentElementOptions.

Accédez-y en appelant le const {PlaceStandardContentElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceStandardContentElement
PlaceStandardContentElement([options])
Paramètres :
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.

Interface PlaceStandardContentElementOptions

Interface google.maps.places.PlaceStandardContentElementOptions

Options pour PlaceStandardContentElement.

Classe PlaceListElement

Classe google.maps.places.PlaceListElement

Élément HTML qui affiche les résultats d'une recherche de lieux dans une liste. Utilisez les méthodes configureFromSearchByTextRequest() ou configureFromSearchNearbyRequest() pour spécifier la requête pour laquelle afficher les résultats. Pour utiliser l'élément de liste de lieux, activez l'API Places UI Kit pour votre projet dans la console Google Cloud.

Élément personnalisé :
<gmp-place-list selectable></gmp-place-list>

Cette classe étend HTMLElement.

Cette classe implémente PlaceListElementOptions.

Accédez-y en appelant le const {PlaceListElement} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
PlaceListElement
PlaceListElement([options])
Paramètres :
places
Type : Array<Place>
Lecture seule. Tableau d'objets Place contenant les ID, les emplacements et les fenêtres d'affichage des lieux actuellement affichés.
selectable
Type : boolean
Indique si les éléments de la liste peuvent être sélectionnés. Si la valeur est "true", les éléments de la liste seront des boutons qui déclenchent l'événement gmp-placeselect lorsqu'ils sont cliqués. La navigation et la sélection au clavier accessibles sont également prises en charge.
Attribut HTML :
  • <gmp-place-list selectable></gmp-place-list>
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject L'objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional. Consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener.
configureFromSearchByTextRequest
configureFromSearchByTextRequest(request)
Paramètres :
  • request : SearchByTextRequest requête pour laquelle les résultats doivent être affichés. La propriété fields de SearchByTextRequest n'est pas obligatoire.
Valeur de renvoi : Promise<void>. Promesse qui se résout une fois que les données du lieu sont chargées et affichées.
Configure le widget pour afficher les résultats de recherche d'une requête API Places Text Search.
configureFromSearchNearbyRequest
configureFromSearchNearbyRequest(request)
Paramètres :
  • request : SearchNearbyRequest requête pour laquelle les résultats doivent être affichés. La propriété fields de SearchNearbyRequest n'est pas obligatoire.
Valeur de renvoi : Promise<void>. Promesse qui se résout une fois que les données du lieu sont chargées et affichées.
Configure le widget pour afficher les résultats de recherche d'une requête API Places Nearby Search.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne qui spécifie le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject L'écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional. Consultez les options.
Valeur renvoyée : void
Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener.
gmp-load
function(event)
Arguments : 
Cet événement est déclenché lorsque l'élément charge et affiche son contenu. Cet événement ne remonte pas.
gmp-placeselect
function(event)
Arguments : 
Cet événement est déclenché lorsqu'un utilisateur sélectionne un lieu. Contient un objet Place et l'index du lieu sélectionné dans la liste.
gmp-requesterror
function(event)
Arguments : 
Cet événement est déclenché lorsqu'une requête envoyée au backend a été refusée (par exemple, clé API incorrecte). Cet événement ne remonte pas.

PlaceListElementOptions interface

Interface google.maps.places.PlaceListElementOptions

Options pour PlaceListElement.
selectable optional
Type : boolean optional
Voir les PlaceListElement.selectable

PlaceListPlaceSelectEvent class

Classe google.maps.places.PlaceListPlaceSelectEvent

Cet événement est émis par PlaceListElement lorsque l'utilisateur sélectionne un lieu.

Cette classe étend Event.

Accédez-y en appelant le const {PlaceListPlaceSelectEvent} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
index
Type : number
Index de la liste du lieu sélectionné.
place
Type : Place
Objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu sélectionné.

Classe Autocomplete

Classe google.maps.places.Autocomplete

Widget qui fournit des prédictions de lieux en fonction du texte saisi par l'utilisateur. Il est associé à un élément d'entrée de type text et écoute les saisies de texte dans ce champ. La liste des prédictions s'affiche sous forme de liste déroulante et est mise à jour à mesure que du texte est saisi.

Cette classe étend MVCObject.

Accédez-y en appelant le const {Autocomplete} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
Autocomplete
Autocomplete(inputField[, opts])
Paramètres :
Crée une instance de Autocomplete qui est associée au champ de texte d'entrée spécifié avec les options données.
getBounds
getBounds()
Paramètres : aucun
Valeur renvoyée : LatLngBounds|undefined limites de biais.
Renvoie les limites auxquelles les prédictions sont biaisées.
getFields
getFields()
Paramètres : aucun
Valeur renvoyée : Array<string>|undefined
Renvoie les champs à inclure pour le lieu dans la réponse de détails lorsque les détails sont récupérés avec succès. Pour obtenir la liste des champs, consultez PlaceResult.
getPlace
getPlace()
Paramètres : aucun
Valeur renvoyée : PlaceResult, le lieu sélectionné par l'utilisateur.
Renvoie les détails du lieu sélectionné par l'utilisateur si les détails ont été récupérés avec succès. Sinon, renvoie un objet Place de stub, avec la propriété name définie sur la valeur actuelle du champ d'entrée.
setBounds
setBounds(bounds)
Paramètres :
Valeur renvoyée : aucune
Définit la zone préférée dans laquelle renvoyer les résultats de lieux. Les résultats sont pondérés en faveur de cette zone, mais n'y sont pas restreints.
setComponentRestrictions
setComponentRestrictions(restrictions)
Paramètres :
Valeur renvoyée : aucune
Définit les restrictions des composants. Les restrictions de composants permettent de limiter les prédictions à celles du composant parent. Par exemple, le pays.
setFields
setFields(fields)
Paramètres :
  • fields : Array<string> optional
Valeur renvoyée : aucune
Définit les champs à inclure pour le lieu dans la réponse "Détails" lorsque les détails sont récupérés. Pour obtenir la liste des champs, consultez PlaceResult.
setOptions
setOptions(options)
Paramètres :
Valeur renvoyée : aucune
setTypes
setTypes(types)
Paramètres :
  • types : Array<string> optional types de prédictions à inclure.
Valeur renvoyée : aucune
Définit les types de prédictions à renvoyer. Pour connaître les types acceptés, consultez le guide du développeur. Si aucun type n'est spécifié, tous les types sont renvoyés.
Hérité : addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Arguments : aucun
Cet événement est déclenché lorsqu'un PlaceResult est disponible pour un lieu sélectionné par l'utilisateur.
Si l'utilisateur saisit le nom d'un lieu qui n'a pas été suggéré par le contrôle et appuie sur la touche Entrée, ou si une requête Place Details échoue, PlaceResult contient la saisie de l'utilisateur dans la propriété name, sans aucune autre propriété définie.

Interface AutocompleteOptions

Interface google.maps.places.AutocompleteOptions

Options pouvant être définies sur un objet Autocomplete.
bounds optional
Zone dans laquelle rechercher des lieux.
componentRestrictions optional
Type : ComponentRestrictions optional
Restrictions du composant. Les restrictions de composants permettent de limiter les prédictions à celles du composant parent. Par exemple, le pays.
fields optional
Type : Array<string> optional
Champs à inclure pour le lieu dans la réponse détaillée lorsque les détails sont récupérés avec succès, qui seront facturés. Si ['ALL'] est transmis, tous les champs disponibles seront 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 chemins d'accès (par exemple, "geometry.location"). La valeur par défaut est ['ALL'].
placeIdOnly optional
Type : boolean optional
Indique si seuls les ID de lieu doivent être récupérés. Le PlaceResult mis à disposition lorsque l'événement place_changed est déclenché ne comporte que les champs place_id, types et name, avec le place_id, les types et la description renvoyés par le service Autocomplete. Désactivé par défaut
strictBounds optional
Type : boolean optional
Valeur booléenne indiquant que le widget Autocomplete ne doit renvoyer que les lieux situés dans les limites du widget Autocomplete au moment de l'envoi de la requête. Si vous définissez strictBounds sur false (valeur par défaut), les résultats seront pondérés en faveur des lieux situés entre les limites, mais n'y seront pas restreints.
types optional
Type : Array<string> optional
Types de prédictions à renvoyer. Pour connaître les types acceptés, consultez le guide du développeur. Si aucun type n'est spécifié, tous les types sont renvoyés.

Classe google.maps.places.SearchBox

Widget qui fournit des prédictions de requêtes en fonction du texte saisi par un utilisateur. Il est associé à un élément d'entrée de type text et écoute les saisies de texte dans ce champ. La liste des prédictions s'affiche sous forme de liste déroulante et est mise à jour à mesure que du texte est saisi.

Cette classe étend MVCObject.

Accédez-y en appelant le const {SearchBox} = await google.maps.importLibrary("places").
 Consultez Bibliothèques de l'API Maps JavaScript.
SearchBox
SearchBox(inputField[, opts])
Paramètres :
Crée une instance de SearchBox qui est associée au champ de texte d'entrée spécifié avec les options données.
getBounds
getBounds()
Paramètres : aucun
Valeur renvoyée : LatLngBounds|undefined
Renvoie les limites auxquelles les prédictions de requête sont biaisées.
getPlaces
getPlaces()
Paramètres : aucun
Valeur renvoyée : Array<PlaceResult>|undefined
Renvoie la requête sélectionnée par l'utilisateur à utiliser avec l'événement places_changed.
setBounds
setBounds(bounds)
Paramètres :
Valeur renvoyée : aucune
Définit la région à utiliser pour orienter les prédictions de requête. Les résultats seront uniquement pondérés en faveur de cette zone, mais n'y seront pas complètement restreints.
Hérité : addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Arguments : aucun
Cet événement est déclenché lorsque l'utilisateur sélectionne une requête. getPlaces doit être utilisé pour obtenir de nouveaux lieux.

Interface SearchBoxOptions

Interface google.maps.places.SearchBoxOptions

Options pouvant être définies sur un objet SearchBox.
bounds optional
Zone vers laquelle orienter les prédictions de requête. Les prédictions sont pondérées en faveur des requêtes ciblant ces limites, mais n'y sont pas restreintes.