Places Widgets

Classe PlaceAutocompleteElement

class google.maps.places.PlaceAutocompleteElement extends HTMLElement implements PlaceAutocompleteElementOptions
library "places"

PlaceAutocompleteElement est une sous-classe HTMLElement qui fournit un composant d'interface utilisateur 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.

<gmp-place-autocomplete
  description="string"
  disabled
  future-opening-businesses-included
  included-primary-types="type1 type2 type3..."
  included-region-codes="c1 c2 c3..."
  internal-usage-attribution-ids="space separated strings"
  maxlength="number"
  name="string"
  no-clear-button
  no-input-icon
  origin="lat,lng"
  placeholder="string"
  pure-service-area-businesses-included
  readonly
  requested-language="string"
  requested-region="string"
  unit-system="value-name">
</gmp-place-autocomplete>
const {PlaceAutocompleteElement} = await google.maps.importLibrary("places");
PlaceAutocompleteElement
PlaceAutocompleteElement([options])
Paramètres :
description
attr: description
Type : string optional
Description à utiliser pour l'élément d'entrée. Les lecteurs d'écran le détecteront lorsque l'élément d'entrée sera sélectionné. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby.
Attribut HTML : description="string"
disabled
attr: disabled
Type d'entrée : boolean optional
Type de sortie : boolean
Indique si l'élément d'entrée est désactivé. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#disabled.
Attribut HTML : disabled
futureOpeningBusinessesIncluded
attr: future-opening-businesses-included
Type : boolean optional
Indique si vous souhaitez inclure les lieux qui ne sont pas encore ouverts, mais qui devraient l'être à l'avenir.
Attribut HTML : future-opening-businesses-included
includedPrimaryTypes
attr: included-primary-types
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 : included-primary-types="type1 type2 type3..."
includedRegionCodes
attr: included-region-codes
Type : Array<string> optional
Incluez uniquement les résultats dans les régions spécifiées, sous la 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 deux définis, les résultats se trouveront dans la zone d'intersection.
Attribut HTML : included-region-codes="c1 c2 c3..."
internalUsageAttributionIds
attr: internal-usage-attribution-ids
Type d'entrée : Iterable<string> optional
Type de sortie : Array<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
Attribut HTML : internal-usage-attribution-ids="space separated strings"
locationBias
Type : LocationBias optional
Limite souple ou indice à utiliser lors de la recherche de lieux.
locationRestriction
Type : LocationRestriction optional
Limites pour restreindre les résultats de recherche.
maxlength
attr: maxlength
Type : number optional
Nombre maximal de caractères que l'utilisateur peut saisir. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength.
Attribut HTML : maxlength="number"
name
attr: 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. Suit le même comportement que l'attribut "name" pour les entrées. Notez qu'il s'agit du nom qui sera utilisé lors de l'envoi d'un formulaire. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
Attribut HTML : name="string"
noClearButton
attr: no-clear-button
Type d'entrée : boolean optional
Type de sortie : boolean
Indique si le bouton d'effacement doit être masqué.
Attribut HTML : no-clear-button
noInputIcon
attr: no-input-icon
Type d'entrée : boolean optional
Type de sortie : boolean
Indique si l'icône de saisie doit être masquée.
Attribut HTML : no-input-icon
origin
attr: origin
Type d'entrée : LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
Type de sortie : LatLngAltitude optional
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 :
  • origin="lat,lng"
  • origin="lat,lng,altitude"
placeholder
attr: placeholder
Type : string optional
Texte d'espace réservé à utiliser pour l'élément d'entrée. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder.
Attribut HTML : placeholder="string"
pureServiceAreaBusinessesIncluded
attr: pure-service-area-businesses-included
Type : boolean optional
Indique si les lieux qui sont des établissements de services de proximité doivent être inclus.
Attribut HTML : pure-service-area-businesses-included
readonly
attr: readonly
Type d'entrée : boolean optional
Type de sortie : boolean
Indique si l'élément d'entrée est en lecture seule. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#readonly.
Attribut HTML : readonly
requestedLanguage
attr: requested-language
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 : requested-language="string"
requestedRegion
attr: requested-region
Type : string optional
Code de région utilisé pour la mise en forme et le filtrage des résultats. Elle 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 : requested-region="string"
unitSystem
attr: unit-system
Type d'entrée : UnitSystem optional
Type de sortie : UnitSystem optional
Système d'unités utilisé pour afficher les distances. Si ce paramètre n'est pas spécifié, le système d'unités est déterminé par requestedRegion.
Attribut HTML : unit-system="value-name"
value
Type d'entrée : string optional
Type de sortie : string
Valeur de l'élément d'entrée.
clear-icon
Place l'élément d'emplacement à la position de l'icône d'effacement. Le bouton d'effacement s'affiche à la fin de la zone de saisie lorsqu'elle contient du texte.
input-icon
Place l'élément inséré à la position de l'icône d'entrée. L'icône de saisie s'affiche au début du champ de saisie en mode intégré.
prediction-item-icon
Cet emplacement accepte exactement un élément <template> à afficher en tant qu'icône à côté de l'élément de prédiction.
focus-ring
Élément utilisé pour afficher l'anneau de sélection autour de l'élément sélectionné (entrée ou éléments de prédiction)
input
Élément d'entrée pour l'élément de saisie semi-automatique.
prediction-item
Élément de la liste déroulante 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 de l'é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, prediction-item-main-text est coloré en noir. Si le champ prediction-item 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 n'est mis en surbrillance que dans prediction-item-main-text.
prediction-item-nonmatch
Partie du texte principal de la prédiction qui ne correspond pas à ce qu'a saisi l'utilisateur.
prediction-item-secondary-text
Partie de l'élément de prédiction qui correspond au texte secondaire de la prédiction. Le texte additionnel est généralement une adresse.
prediction-item-selected
Élément vers lequel l'utilisateur navigue avec le clavier. Remarque : Les éléments sélectionnés seront affectés 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.
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 la bordure de l'élément.
color
Remplace la police 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 sur color-scheme. La valeur par défaut est color-scheme: light dark.
font
Remplace la police de l'élément.
font-family
Remplace la police de l'élément.
font-size
Remplace la police de l'élément.
font-style
Remplace la police de l'élément.
font-weight
Remplace la police de l'élément.
line-height
Remplace la police de l'élément.
Hérité : addEventListener, removeEventListener
gmp-error
function(errorEvent)
Arguments :
  • errorEvent: Event optional
Cet événement est déclenché lorsqu'une requête adressée au backend est refusée (par exemple, clé API incorrecte). Cet événement ne se propage 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.

Interface PlaceAutocompleteElementOptions

interface google.maps.places.PlaceAutocompleteElementOptions
implémentée par PlaceAutocompleteElement

Options de construction d'un PlaceAutocompleteElement. Pour obtenir la description de chaque propriété, reportez-vous à la propriété du même nom dans la classe PlaceAutocompleteElement.

description
facultatif
Type : string optional
Description à utiliser pour l'élément d'entrée. Les lecteurs d'écran le détecteront lorsque l'élément d'entrée sera sélectionné.
disabled
facultatif
Type : boolean optional
futureOpeningBusinessesIncluded
facultatif
Type : boolean optional
includedPrimaryTypes
facultatif
Type : Array<string> optional
includedRegionCodes
facultatif
Type : Array<string> optional
internalUsageAttributionIds
facultatif
Type : Iterable<string> optional
locationBias
facultatif
Type : LocationBias optional
locationRestriction
facultatif
Type : LocationRestriction optional
maxlength
facultatif
Type : number optional
name
facultatif
Type : string optional
noClearButton
facultatif
Type : boolean optional
noInputIcon
facultatif
Type : boolean optional
origin
facultatif
placeholder
facultatif
Type : string optional
pureServiceAreaBusinessesIncluded
facultatif
Type : boolean optional
readonly
facultatif
Type : boolean optional
requestedLanguage
facultatif
Type : string optional
requestedRegion
facultatif
Type : string optional
unitSystem
facultatif
Type : UnitSystem optional
value
facultatif
Type : string optional
Valeur de l'élément d'entrée.

Classe PlacePredictionSelectEvent

class google.maps.places.PlacePredictionSelectEvent extends Event
library "places"

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.

const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places");
placePrediction
readonly
Convertissez-le en Place en appelant PlacePrediction.toPlace.

BasicPlaceAutocompleteElement

class google.maps.places.BasicPlaceAutocompleteElement extends HTMLElement implements BasicPlaceAutocompleteElementOptions
library "places"

BasicPlaceAutocompleteElement est une sous-classe HTMLElement qui fournit un composant d'interface utilisateur pour l'API Places Autocomplete.

<gmp-basic-place-autocomplete
  description="string"
  disabled
  future-opening-businesses-included
  included-primary-types="type1 type2 type3..."
  included-region-codes="c1 c2 c3..."
  internal-usage-attribution-ids="space separated strings"
  maxlength="number"
  name="string"
  no-clear-button
  no-input-icon
  origin="lat,lng"
  placeholder="string"
  pure-service-area-businesses-included
  readonly
  requested-language="string"
  requested-region="string"
  unit-system="value-name">
</gmp-basic-place-autocomplete>
const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places");
BasicPlaceAutocompleteElement
BasicPlaceAutocompleteElement([options])
Paramètres :
description
attr: description
Type : string optional
Description à utiliser pour l'élément d'entrée. Les lecteurs d'écran le détecteront lorsque l'élément d'entrée sera sélectionné. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby.
Attribut HTML : description="string"
disabled
attr: disabled
Type d'entrée : boolean optional
Type de sortie : boolean
Indique si l'élément d'entrée est désactivé. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#disabled.
Attribut HTML : disabled
futureOpeningBusinessesIncluded
attr: future-opening-businesses-included
Type : boolean optional
Indique si vous souhaitez inclure les lieux qui ne sont pas encore ouverts, mais qui devraient l'être à l'avenir.
Attribut HTML : future-opening-businesses-included
includedPrimaryTypes
attr: included-primary-types
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 : included-primary-types="type1 type2 type3..."
includedRegionCodes
attr: included-region-codes
Type : Array<string> optional
Incluez uniquement les résultats dans les régions spécifiées, sous la 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 deux définis, les résultats se trouveront dans la zone d'intersection.
Attribut HTML : included-region-codes="c1 c2 c3..."
internalUsageAttributionIds
attr: internal-usage-attribution-ids
Type d'entrée : Iterable<string> optional
Type de sortie : Array<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
Attribut HTML : internal-usage-attribution-ids="space separated strings"
locationBias
Type : LocationBias optional
Limite souple ou indice à utiliser lors de la recherche de lieux.
locationRestriction
Type : LocationRestriction optional
Limites pour restreindre les résultats de recherche.
maxlength
attr: maxlength
Type : number optional
Nombre maximal de caractères que l'utilisateur peut saisir. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength.
Attribut HTML : maxlength="number"
name
attr: 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. Suit le même comportement que l'attribut "name" pour les entrées. Notez qu'il s'agit du nom qui sera utilisé lors de l'envoi d'un formulaire. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
Attribut HTML : name="string"
noClearButton
attr: no-clear-button
Type d'entrée : boolean optional
Type de sortie : boolean
Indique si le bouton d'effacement doit être masqué.
Attribut HTML : no-clear-button
noInputIcon
attr: no-input-icon
Type d'entrée : boolean optional
Type de sortie : boolean
Indique si l'icône de saisie doit être masquée.
Attribut HTML : no-input-icon
origin
attr: origin
Type d'entrée : LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
Type de sortie : LatLngAltitude optional
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 :
  • origin="lat,lng"
  • origin="lat,lng,altitude"
placeholder
attr: placeholder
Type : string optional
Texte d'espace réservé à utiliser pour l'élément d'entrée. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder.
Attribut HTML : placeholder="string"
pureServiceAreaBusinessesIncluded
attr: pure-service-area-businesses-included
Type : boolean optional
Indique si les lieux qui sont des établissements de services de proximité doivent être inclus.
Attribut HTML : pure-service-area-businesses-included
readonly
attr: readonly
Type d'entrée : boolean optional
Type de sortie : boolean
Indique si l'élément d'entrée est en lecture seule. Pour en savoir plus, consultez https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#readonly.
Attribut HTML : readonly
requestedLanguage
attr: requested-language
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 : requested-language="string"
requestedRegion
attr: requested-region
Type : string optional
Code de région utilisé pour la mise en forme et le filtrage des résultats. Elle 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 : requested-region="string"
unitSystem
attr: unit-system
Type d'entrée : UnitSystem optional
Type de sortie : UnitSystem optional
Système d'unités utilisé pour afficher les distances. Si ce paramètre n'est pas spécifié, le système d'unités est déterminé par requestedRegion.
Attribut HTML : unit-system="value-name"
clear-icon
Place l'élément d'emplacement à la position de l'icône d'effacement. Le bouton d'effacement s'affiche à la fin de la zone de saisie lorsqu'elle contient du texte.
input-icon
Place l'élément inséré à la position de l'icône d'entrée. L'icône de saisie s'affiche au début du champ de saisie en mode intégré.
prediction-item-icon
Cet emplacement accepte exactement un élément <template> à afficher en tant qu'icône à côté de l'élément de prédiction.
focus-ring
Élément utilisé pour afficher l'anneau de sélection autour de l'élément sélectionné (entrée ou éléments de prédiction)
input
Élément d'entrée pour l'élément de saisie semi-automatique.
prediction-item
Élément de la liste déroulante 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 de l'é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, prediction-item-main-text est coloré en noir. Si le champ prediction-item 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 n'est mis en surbrillance que dans prediction-item-main-text.
prediction-item-nonmatch
Partie du texte principal de la prédiction qui ne correspond pas à ce qu'a saisi l'utilisateur.
prediction-item-secondary-text
Partie de l'élément de prédiction qui correspond au texte secondaire de la prédiction. Le texte additionnel est généralement une adresse.
prediction-item-selected
Élément vers lequel l'utilisateur navigue avec le clavier. Remarque : Les éléments sélectionnés seront affectés 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.
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 la bordure de l'élément.
color
Remplace la police 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 sur color-scheme. La valeur par défaut est color-scheme: light dark.
font
Remplace la police de l'élément.
font-family
Remplace la police de l'élément.
font-size
Remplace la police de l'élément.
font-style
Remplace la police de l'élément.
font-weight
Remplace la police de l'élément.
line-height
Remplace la police de l'élément.
Hérité : addEventListener, removeEventListener
gmp-error
function(errorEvent)
Arguments :
  • errorEvent: Event optional
Cet événement est déclenché lorsqu'une requête adressée au backend est refusée (par exemple, clé API incorrecte). Cet événement ne se propage pas.
gmp-select
function(placeSelectEvent)
Arguments :
Cet événement est déclenché lorsqu'un utilisateur sélectionne une prédiction de lieu. Contient un objet Place.

BasicPlaceAutocompleteElementOptions

interface google.maps.places.BasicPlaceAutocompleteElementOptions
implémentée par BasicPlaceAutocompleteElement

Options de construction d'un BasicPlaceAutocompleteElement.

description
facultatif
Type : string optional
Description à utiliser pour l'élément d'entrée. Les lecteurs d'écran le détecteront lorsque l'élément d'entrée sera sélectionné.
disabled
facultatif
Type : boolean optional
futureOpeningBusinessesIncluded
facultatif
Type : boolean optional
includedPrimaryTypes
facultatif
Type : Array<string> optional
includedRegionCodes
facultatif
Type : Array<string> optional
internalUsageAttributionIds
facultatif
Type : Iterable<string> optional
locationBias
facultatif
Type : LocationBias optional
locationRestriction
facultatif
Type : LocationRestriction optional
maxlength
facultatif
Type : number optional
name
facultatif
Type : string optional
noClearButton
facultatif
Type : boolean optional
noInputIcon
facultatif
Type : boolean optional
origin
facultatif
placeholder
facultatif
Type : string optional
pureServiceAreaBusinessesIncluded
facultatif
Type : boolean optional
readonly
facultatif
Type : boolean optional
requestedLanguage
facultatif
Type : string optional
requestedRegion
facultatif
Type : string optional
unitSystem
facultatif
Type : UnitSystem optional

Classe PlaceDetailsElement

classe google.maps.places.PlaceDetailsElement étend HTMLElement implémente PlaceDetailsElementOptions
étendu par AdvancedPlaceDetailsElement
bibliothèque "places"

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

Exemple :

 <gmp-place-details>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-details>

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

<gmp-place-details
  internal-usage-attribution-ids="space separated strings">
</gmp-place-details>
const {PlaceDetailsElement} = await google.maps.importLibrary("places");
PlaceDetailsElement
PlaceDetailsElement([options])
Paramètres :
internalUsageAttributionIds
attr: internal-usage-attribution-ids
Type d'entrée : Iterable<string> optional
Type de sortie : Array<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
Attribut HTML : internal-usage-attribution-ids="space separated strings"
place
readonly
Type : Place optional
Lecture seule. Objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu actuellement affiché.
--gmp-button-border-color
Couleur de la bordure du bouton "Ouvrir dans Maps".
--gmp-button-border-radius
Rayon de la bordure du bouton "Ouvrir dans Maps".
--gmp-button-border-width
Largeur de la bordure du bouton "Ouvrir dans Maps".
--gmp-collage-border-radius-outer
Rayon de bordure des angles extérieurs du collage multimédia.
--gmp-dialog-border-radius
Rayon de la bordure de la boîte de dialogue de divulgation Google Maps.
--gmp-mat-color-disabled-surface
Couleur de surface destinée à indiquer les états désactivés ou l'absence. Utilisé pour les étoiles d'avis vides.
--gmp-mat-color-info
Couleur des éléments d'interface utilisateur avec un sentiment d'information. Utilisé pour l'icône de fauteuil roulant.
--gmp-mat-color-negative
Couleur des éléments d'interface utilisateur 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 remplis de manière neutre. Utilisé pour les espaces réservés aux images et le badge de date de publication de l'avis.
--gmp-mat-color-on-neutral-container
Couleur du texte et des icônes par rapport à la couleur neutre du conteneur. Utilisé pour le badge de date de publication de l'avis et le badge de disponibilité de la borne pour véhicules électriques lorsqu'elle n'est pas disponible.
--gmp-mat-color-on-positive-container
Couleur des textes et des icônes par rapport à la couleur du conteneur positif. Utilisé pour le badge de disponibilité de la borne pour véhicules électriques, lorsqu'il est disponible.
--gmp-mat-color-on-secondary-container
Couleur du texte et des icônes par rapport à la couleur du conteneur secondaire. Utilisé pour le texte et les icônes du bouton "Ouvrir dans Maps".
--gmp-mat-color-on-surface
Couleur du texte et des icônes sur n'importe quelle couleur de surface. Utilisé pour le texte standard.
--gmp-mat-color-on-surface-variant
Couleur moins accentuée pour le texte et les icônes sur n'importe quelle couleur de surface. Utilisé pour le texte moins mis en avant.
--gmp-mat-color-outline-decorative
Couleur du contour des éléments non interactifs. Utilisée pour la bordure de l'élément.
--gmp-mat-color-positive
Couleur des éléments d'interface utilisateur avec un sentiment positif. Utilisé pour le texte "Ouvert" dans l'état "Ouvert actuellement".
--gmp-mat-color-positive-container
Couleur du conteneur pour les éléments d'interface utilisateur qui transmettent un sentiment positif. Utilisé pour le badge de disponibilité de la borne pour véhicules électriques, lorsqu'il est disponible.
--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, les liens dans la boîte de dialogue des informations Google Maps, le lien vers le site Web, les icônes de l'onglet "Aperçu" et (survol/sélection/couleur du texte) sur les titres de la barre d'onglets.
--gmp-mat-color-secondary-container
Couleur de remplissage moins visible sur la surface, pour les composants récessifs tels que les boutons tonaux. Utilisée 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 des informations Google Maps.
--gmp-mat-font-body-medium
Utilisé pour l'adresse, la note, le type, le prix, l'état d'ouverture, les horaires d'ouverture, l'avis, le numéro de téléphone, le site Web, le Plus Code, les principales caractéristiques et le corps du texte du lieu dans la boîte de dialogue des informations Google Maps.
--gmp-mat-font-body-small
Utilisé pour le corps du texte dans la liste des fonctionnalités de l'onglet "À propos".
--gmp-mat-font-display-small
Utilisé pour le nom du lieu et le texte de chaque titre de caractéristique dans l'onglet "À propos".
--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 des informations Google Maps.
--gmp-mat-font-label-large
Utilisé pour les titres des onglets, le bouton "Ouvrir dans Maps", le texte d'attribution de l'auteur de l'avis dans la galerie photo, le texte d'attribution de l'auteur de l'avis dans la section des avis et les liens dans la boîte de dialogue des informations Google Maps.
--gmp-mat-font-label-medium
Utilisé pour le badge du nombre de photos et le badge de la date de publication de l'avis.
--gmp-mat-font-title-small
Utilisé pour le titre de chaque section de l'onglet "À propos".
--gmp-mat-spacing-extra-large
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-extra-small
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-large
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-medium
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-small
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-two-extra-large
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-star-rating-color
Couleur des étoiles pleines dans la note.
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 la 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 sur color-scheme. La valeur par défaut est color-scheme: light dark.
font-size
Met à l'échelle l'ensemble du texte et des icônes de l'élément, qui sont définis en interne en ems. La valeur par défaut est 16px.
Hérité : addEventListener, removeEventListener
gmp-error
function(event)
Arguments :
Cet événement est déclenché lorsqu'une requête adressée au backend est refusée (par exemple, clé API incorrecte). Cet événement ne se propage 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 se propage pas.

PlaceDetailsElementOptions

interface google.maps.places.PlaceDetailsElementOptions
étendue par AdvancedPlaceDetailsElementOptions
implémentée par AdvancedPlaceDetailsElement, PlaceDetailsElement

Options pour PlaceDetailsElement.

internalUsageAttributionIds
facultatif
Type : Iterable<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.

Classe PlaceDetailsCompactElement

classe google.maps.places.PlaceDetailsCompactElement étend HTMLElement implémente PlaceDetailsCompactElementOptions
étendu par AdvancedPlaceDetailsCompactElement
bibliothèque "places"

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

Exemple :

 <gmp-place-details-compact>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-details-compact>

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

<gmp-place-details-compact
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  truncation-preferred>
</gmp-place-details-compact>
const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places");
PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
Paramètres :
internalUsageAttributionIds
attr: internal-usage-attribution-ids
Type d'entrée : Iterable<string> optional
Type de sortie : Array<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
Attribut HTML : internal-usage-attribution-ids="space separated strings"
orientation
attr: orientation
Type : PlaceDetailsOrientation optional
Par défaut : PlaceDetailsOrientation.VERTICAL
Variante d'orientation (verticale ou horizontale) de l'élément.
Attribut HTML : orientation="value-name"
place
readonly
Type : Place optional
Lecture seule. Objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu actuellement affiché.
truncationPreferred
attr: truncation-preferred
Type d'entrée : boolean optional
Type de sortie : 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 : truncation-preferred
--gmp-button-border-color
Couleur de la bordure du bouton "Ouvrir dans Maps".
--gmp-button-border-radius
Rayon de la bordure du bouton "Ouvrir dans Maps".
--gmp-button-border-width
Largeur de la bordure du bouton "Ouvrir dans Maps".
--gmp-dialog-border-radius
Rayon de la bordure de la boîte de dialogue de divulgation Google Maps.
--gmp-mat-color-info
Couleur des éléments d'interface utilisateur avec un sentiment d'information. Utilisé pour l'icône de fauteuil roulant.
--gmp-mat-color-negative
Couleur des éléments d'interface utilisateur 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 remplis de manière neutre. Utilisé pour les espaces réservés d'image.
--gmp-mat-color-on-secondary-container
Couleur du texte et des icônes par rapport à la couleur du conteneur secondaire. Utilisé pour le texte et les icônes du bouton "Ouvrir dans Maps".
--gmp-mat-color-on-surface
Couleur du texte et des icônes sur n'importe quelle couleur de surface. Utilisé pour le texte standard.
--gmp-mat-color-on-surface-variant
Couleur moins accentuée pour le texte et les icônes sur n'importe quelle couleur de surface. Utilisé pour le texte moins mis en avant.
--gmp-mat-color-outline-decorative
Couleur du contour des éléments non interactifs. Utilisée pour la bordure de l'élément.
--gmp-mat-color-positive
Couleur des éléments d'interface utilisateur 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, ainsi que pour les liens dans la boîte de dialogue des informations Google Maps.
--gmp-mat-color-secondary-container
Couleur de remplissage moins visible sur la surface, pour les composants récessifs tels que les boutons tonaux. Utilisée 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 des informations Google Maps.
--gmp-mat-font-body-medium
Utilisé pour le corps du texte dans la boîte de dialogue des informations Google Maps.
--gmp-mat-font-body-small
Utilisé pour l'adresse, la note, le type, le prix et l'état d'ouverture 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 des informations Google Maps.
--gmp-mat-font-label-large
Utilisé pour le bouton "Ouvrir dans Maps", ainsi que pour les liens de la boîte de dialogue des informations légales de Google Maps et le texte d'attribution de l'auteur de l'avis dans la galerie photo.
--gmp-mat-font-label-medium
Utilisé pour le badge du nombre de photos.
--gmp-mat-font-title-small
Utilisé pour le nom du lieu.
--gmp-mat-spacing-extra-small
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-large
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-medium
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-small
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-star-rating-color
Couleur des étoiles pleines dans la note.
--gmp-thumbnail-border-radius
Rayon de la bordure de l'image miniature 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 la 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 sur color-scheme. La valeur par défaut est color-scheme: light dark.
font-size
Met à l'échelle l'ensemble du texte et des icônes de l'élément, qui sont définis en interne en ems. La valeur par défaut est 16px.
Hérité : addEventListener, removeEventListener
gmp-error
function(event)
Arguments :
Cet événement est déclenché lorsqu'une requête adressée au backend est refusée (par exemple, clé API incorrecte). Cet événement ne se propage 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 se propage pas.

PlaceDetailsCompactElementOptions interface

interface google.maps.places.PlaceDetailsCompactElementOptions
étendue par AdvancedPlaceDetailsCompactElementOptions
implémentée par AdvancedPlaceDetailsCompactElement, PlaceDetailsCompactElement

Options pour PlaceDetailsCompactElement.

internalUsageAttributionIds
facultatif
Type : Iterable<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
orientation
facultatif
Type : PlaceDetailsOrientation optional
truncationPreferred
facultatif
Type : boolean optional

Classe AdvancedPlaceDetailsElement

class google.maps.places.AdvancedPlaceDetailsElement extends PlaceDetailsElement, HTMLElement implements AdvancedPlaceDetailsElementOptions, PlaceDetailsElementOptions
library "places"

Affiche les détails d'un lieu dans une mise en page complète. Ajoutez PlaceDetailsPlaceRequestElement ou PlaceDetailsLocationRequestElement pour spécifier le lieu à afficher. Ajoutez directement un élément PlaceStandardContentElement, PlaceAllContentElement ou Place Details pour configurer le contenu à afficher.

Exemple :

 <gmp-advanced-place-details>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
  <gmp-place-standard-content>
  </gmp-place-standard-content>
</gmp-advanced-place-details>

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

<gmp-advanced-place-details
  internal-usage-attribution-ids="space separated strings">
</gmp-advanced-place-details>
const {AdvancedPlaceDetailsElement} = await google.maps.importLibrary("places");
AdvancedPlaceDetailsElement
AdvancedPlaceDetailsElement([options])
Paramètres :
internalUsageAttributionIds
attr: internal-usage-attribution-ids
Type d'entrée : Iterable<string> optional
Type de sortie : Array<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
Attribut HTML : internal-usage-attribution-ids="space separated strings"
place
readonly
Type : Place optional
Lecture seule. Objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu actuellement affiché.
action-corner
action-main
Alphabasic-section-bottom
Emplacement pour le contenu HTML personnalisé affiché en bas de la section des informations de base, juste en dessous des boutons d'action principaux.
Alphabasic-section-top
Emplacement pour le contenu HTML personnalisé affiché dans la section des informations de base, directement au-dessus du nom du lieu.
Hérité : --gmp-button-border-color, --gmp-button-border-radius, --gmp-button-border-width, --gmp-collage-border-radius-outer, --gmp-dialog-border-radius, --gmp-mat-color-disabled-surface, --gmp-mat-color-info, --gmp-mat-color-negative, --gmp-mat-color-neutral-container, --gmp-mat-color-on-neutral-container, --gmp-mat-color-on-positive-container, --gmp-mat-color-on-secondary-container, --gmp-mat-color-on-surface, --gmp-mat-color-on-surface-variant, --gmp-mat-color-outline-decorative, --gmp-mat-color-positive, --gmp-mat-color-positive-container, --gmp-mat-color-primary, --gmp-mat-color-secondary-container, --gmp-mat-color-surface, --gmp-mat-font-body-medium, --gmp-mat-font-body-small, --gmp-mat-font-display-small, --gmp-mat-font-family, --gmp-mat-font-headline-medium, --gmp-mat-font-label-large, --gmp-mat-font-label-medium, --gmp-mat-font-title-small, --gmp-mat-spacing-extra-large, --gmp-mat-spacing-extra-small, --gmp-mat-spacing-large, --gmp-mat-spacing-medium, --gmp-mat-spacing-small, --gmp-mat-spacing-two-extra-large, --gmp-star-rating-color, background-color, border, border-radius, color-scheme, font-size
Hérité : addEventListener, removeEventListener
Hérité : gmp-error, gmp-load

Interface AdvancedPlaceDetailsElementOptions

interface google.maps.places.AdvancedPlaceDetailsElementOptions extends PlaceDetailsElementOptions
implemented by AdvancedPlaceDetailsElement

Options pour AdvancedPlaceDetailsElement.

internalUsageAttributionIds
facultatif
Type : Iterable<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.

Classe AdvancedPlaceDetailsCompactElement

class google.maps.places.AdvancedPlaceDetailsCompactElement extends PlaceDetailsCompactElement, HTMLElement implements AdvancedPlaceDetailsCompactElementOptions, PlaceDetailsCompactElementOptions
library "places"

Affiche les détails d'un lieu dans une mise en page compacte. Ajoutez PlaceDetailsPlaceRequestElement ou PlaceDetailsLocationRequestElement pour spécifier l'emplacement à afficher. Ajoutez un PlaceStandardContentElement ou un PlaceAllContentElement, ou spécifiez des enfants de contenu spécifiques pour configurer le contenu à afficher.

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

<gmp-advanced-place-details-compact
  internal-usage-attribution-ids="space separated strings">
</gmp-advanced-place-details-compact>
const {AdvancedPlaceDetailsCompactElement} = await google.maps.importLibrary("places");
AdvancedPlaceDetailsCompactElement
AdvancedPlaceDetailsCompactElement([options])
Paramètres :
internalUsageAttributionIds
attr: internal-usage-attribution-ids
Type d'entrée : Iterable<string> optional
Type de sortie : Array<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
Attribut HTML : internal-usage-attribution-ids="space separated strings"
place
readonly
Type : Place optional
Lecture seule. Objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu actuellement affiché.
Hérité : orientation (attr : orientation), truncationPreferred (attr : truncation-preferred)
action-corner
action-main
Alphabasic-section-bottom
Emplacement pour le contenu HTML personnalisé affiché en bas de la section des informations de base, juste en dessous des boutons d'action principaux.
Alphabasic-section-top
Emplacement pour le contenu HTML personnalisé affiché dans la section des informations de base, directement au-dessus du nom du lieu.
Hérité : --gmp-button-border-color, --gmp-button-border-radius, --gmp-button-border-width, --gmp-dialog-border-radius, --gmp-mat-color-info, --gmp-mat-color-negative, --gmp-mat-color-neutral-container, --gmp-mat-color-on-secondary-container, --gmp-mat-color-on-surface, --gmp-mat-color-on-surface-variant, --gmp-mat-color-outline-decorative, --gmp-mat-color-positive, --gmp-mat-color-primary, --gmp-mat-color-secondary-container, --gmp-mat-color-surface, --gmp-mat-font-body-medium, --gmp-mat-font-body-small, --gmp-mat-font-family, --gmp-mat-font-headline-medium, --gmp-mat-font-label-large, --gmp-mat-font-label-medium, --gmp-mat-font-title-small, --gmp-mat-spacing-extra-small, --gmp-mat-spacing-large, --gmp-mat-spacing-medium, --gmp-mat-spacing-small, --gmp-star-rating-color, --gmp-thumbnail-border-radius, background-color, border, border-radius, color-scheme, font-size
Hérité : addEventListener, removeEventListener
Hérité : gmp-error, gmp-load

AdvancedPlaceDetailsCompactElementOptions

interface google.maps.places.AdvancedPlaceDetailsCompactElementOptions extends PlaceDetailsCompactElementOptions
implemented by AdvancedPlaceDetailsCompactElement

Options pour AdvancedPlaceDetailsCompactElement.

internalUsageAttributionIds
facultatif
Type : Iterable<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
Hérité : orientation, truncationPreferred

PlaceDetailsOrientation constants

google.maps.places.PlaceDetailsOrientation
bibliothèque "places"

Variantes d'orientation pour PlaceDetailsCompactElement.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type PlaceDetailsOrientationString.

const {PlaceDetailsOrientation} = await google.maps.importLibrary("places");
HORIZONTAL Orientation horizontale.
VERTICAL Orientation verticale.

PlaceDetailsPlaceRequestElement

class google.maps.places.PlaceDetailsPlaceRequestElement extends HTMLElement implements PlaceDetailsPlaceRequestElementOptions
library "places"

Configure un PlaceDetailsCompactElement ou un PlaceDetailsElement 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 élément PlaceDetailsCompactElement ou PlaceDetailsElement pour charger les données du lieu spécifié. Exemple :

 <gmp-place-details>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
</gmp-place-details>

<gmp-place-details-place-request
  place="places/###">
</gmp-place-details-place-request>
const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places");
PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
Paramètres :
place
attr: place
Type d'entrée : Place|string optional
Type de sortie : Place optional
Par défaut : null
Objet, ID ou nom de ressource du lieu dont vous souhaitez afficher les détails dans l'élément Place Details Compact. Cette propriété reflète l'attribut en tant que nom de ressource.
Attribut HTML : place="places/###"
Hérité : addEventListener, removeEventListener

Interface PlaceDetailsPlaceRequestElementOptions

interface google.maps.places.PlaceDetailsPlaceRequestElementOptions
implémentée par PlaceDetailsPlaceRequestElement

Options pour PlaceDetailsPlaceRequestElement.

place
facultatif
Type : Place|string optional

Classe PlaceDetailsLocationRequestElement

class google.maps.places.PlaceDetailsLocationRequestElement extends HTMLElement implements PlaceDetailsLocationRequestElementOptions
library "places"

Configure un PlaceDetailsCompactElement ou un PlaceDetailsElement pour charger des données en fonction d'un emplacement. Ajoutez cet élément en tant qu'enfant d'un élément PlaceDetailsCompactElement ou PlaceDetailsElement pour charger les données de l'emplacement spécifié. Exemple :

 <gmp-place-details>
  <gmp-place-details-location-request
    location="37.6207665,-122.4284806"
  ></gmp-place-details-location-request>
</gmp-place-details>

<gmp-place-details-location-request
  location="lat,lng">
</gmp-place-details-location-request>
const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places");
PlaceDetailsLocationRequestElement
PlaceDetailsLocationRequestElement([options])
Paramètres :
location
attr: location
Type d'entrée : LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
Type de sortie : LatLngAltitude optional
Par défaut : null
Lieu pour lequel afficher les détails dans l'élément Place Details. Normalise en LatLngAltitude.
Attribut HTML : location="lat,lng"
Hérité : addEventListener, removeEventListener

Interface PlaceDetailsLocationRequestElementOptions

interface google.maps.places.PlaceDetailsLocationRequestElementOptions
implémentée par PlaceDetailsLocationRequestElement

Options pour PlaceDetailsLocationRequestElement.

location
facultatif
Emplacement pour lequel afficher le lieu.

Classe PlaceSearchElement

classe google.maps.places.PlaceSearchElement étend HTMLElement implémente PlaceSearchElementOptions
étendu par AdvancedPlaceSearchElement
bibliothèque "places"

Affiche les résultats d'une recherche de lieu dans une liste. Ajoutez PlaceTextSearchRequestElement ou PlaceNearbySearchRequestElement pour spécifier la requête pour laquelle afficher les résultats. Ajoutez PlaceContentConfigElement, PlaceStandardContentElement ou PlaceAllContentElement pour spécifier le contenu à afficher.

Exemple :

 <gmp-place-search>
  <gmp-place-text-search-request
    text-query="QUERY"
  ></gmp-place-text-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

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

<gmp-place-search
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  selectable
  truncation-preferred>
</gmp-place-search>
const {PlaceSearchElement} = await google.maps.importLibrary("places");
PlaceSearchElement
PlaceSearchElement([options])
Paramètres :
attributionPosition
attr: attribution-position
Type d'entrée : PlaceSearchAttributionPosition optional
Type de sortie : PlaceSearchAttributionPosition
Par défaut : PlaceSearchAttributionPosition.TOP
Position du logo d'attribution et du bouton de divulgation réglementaire.
Attribut HTML : attribution-position="value-name"
internalUsageAttributionIds
attr: internal-usage-attribution-ids
Type d'entrée : Iterable<string> optional
Type de sortie : Array<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
Attribut HTML : internal-usage-attribution-ids="space separated strings"
orientation
attr: orientation
Type d'entrée : PlaceSearchOrientation optional
Type de sortie : PlaceSearchOrientation
Par défaut : PlaceSearchOrientation.VERTICAL
Variante d'orientation (verticale ou horizontale) de l'élément.
Attribut HTML : orientation="value-name"
places
readonly
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
attr: selectable
Type d'entrée : boolean optional
Type de sortie : boolean
Par défaut : false
Indique si les éléments de la liste sont sélectionnables ou non. Si la valeur est "true", les éléments de la liste seront des boutons qui déclencheront l'événement gmp-select lorsqu'un utilisateur cliquera dessus. La navigation et la sélection accessibles au clavier sont également prises en charge.
Attribut HTML : selectable
truncationPreferred
attr: truncation-preferred
Type d'entrée : boolean optional
Type de sortie : boolean
Par défaut : false
Si la valeur est "true", tronque certaines lignes de contenu pour qu'elles tiennent sur une seule ligne au lieu de passer à la ligne.
Attribut HTML : truncation-preferred
--gmp-button-border-color
Couleur de la bordure du bouton "Ouvrir dans Maps".
--gmp-button-border-radius
Rayon de la bordure du bouton "Ouvrir dans Maps".
--gmp-button-border-width
Largeur de la bordure du bouton "Ouvrir dans Maps".
--gmp-card-border-radius
Rayon de la bordure des fiches de lieu.
--gmp-dialog-border-radius
Rayon de la bordure de la boîte de dialogue de divulgation de Google Maps.
--gmp-mat-color-info
Couleur des éléments d'interface utilisateur avec un sentiment d'information. Utilisé pour l'icône d'entrée accessible.
--gmp-mat-color-negative
Couleur des éléments d'interface utilisateur avec un sentiment négatif. Utilisé pour le libellé "Fermé" des horaires d'ouverture d'un lieu.
--gmp-mat-color-neutral-container
Couleur du conteneur pour les éléments d'interface utilisateur remplis de manière neutre. Utilisé pour les badges de date d'avis et les formes d'espace réservé de chargement.
--gmp-mat-color-on-neutral-container
Couleur du texte et des icônes sur un conteneur neutre. Utilisé pour le texte de la date de l'avis et le texte de l'erreur de chargement.
--gmp-mat-color-on-secondary-container
Couleur du texte et des icônes sur une couleur de conteneur secondaire. Utilisée pour le texte des boutons et les icônes.
--gmp-mat-color-on-surface
Couleur du texte et des icônes sur une couleur de surface. Utilisé pour les titres et le contenu des boîtes de dialogue.
--gmp-mat-color-on-surface-variant
Couleur moins accentuée pour le texte et les icônes sur une couleur de surface. Utilisé pour obtenir des informations sur un lieu.
--gmp-mat-color-outline-decorative
Couleur du contour des éléments non interactifs. Utilisé pour la bordure du conteneur.
--gmp-mat-color-positive
Couleur des éléments d'interface utilisateur avec un sentiment positif. Utilisé pour le libellé "Ouvert" des horaires d'ouverture d'un lieu.
--gmp-mat-color-primary
Couleur du texte et des icônes interactifs par rapport à la couleur de la surface. Utilisé pour les liens, l'indicateur de chargement et les icônes de présentation.
--gmp-mat-color-secondary-container
Couleur de remplissage moins visible sur une surface. Utilisé pour les arrière-plans des boutons.
--gmp-mat-color-surface
Couleur des arrière-plans. Utilisé pour les arrière-plans des conteneurs et des boîtes de dialogue.
--gmp-mat-font-body-small
Utilisé pour obtenir des informations sur un lieu.
--gmp-mat-font-family
Famille de polices de base pour tout le texte.
--gmp-mat-font-headline-medium
Utilisé pour les titres des boîtes de dialogue.
--gmp-mat-font-label-large
Utilisé pour le contenu du bouton.
--gmp-mat-font-title-medium
Utilisé pour le nom du lieu.
--gmp-mat-spacing-extra-small
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-large
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-medium
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-small
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-star-rating-color
Couleur des étoiles pleines dans une note.
--gmp-thumbnail-border-radius
Rayon de la bordure de la miniature 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 la 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 sur color-scheme. La valeur par défaut est color-scheme: light dark.
font-size
Met à l'échelle l'ensemble du texte et des icônes de l'élément. La valeur par défaut est 16px.
Hérité : addEventListener, removeEventListener
gmp-error
function(event)
Arguments :
Cet événement est déclenché lorsqu'une requête adressée au backend est refusée (par exemple, clé API incorrecte). Cet événement ne se propage 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 se propage pas.
gmp-select
function(event)
Arguments :
Cet événement est déclenché lorsqu'un lieu est sélectionné dans la liste. Contient un objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu sélectionné.

Interface PlaceSearchElementOptions

interface google.maps.places.PlaceSearchElementOptions
étendue par AdvancedPlaceSearchElementOptions
implémentée par AdvancedPlaceSearchElement, PlaceSearchElement

Options pour PlaceSearchElement.

attributionPosition
facultatif
internalUsageAttributionIds
facultatif
Type : Iterable<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
orientation
facultatif
Type : PlaceSearchOrientation optional
selectable
facultatif
Type : boolean optional
truncationPreferred
facultatif
Type : boolean optional

Classe PlaceItemElement

classe google.maps.places.PlaceItemElement étend HTMLElement implémente PlaceItemElementOptions
étendu par AdvancedPlaceItemElement
bibliothèque "places"

Wrapper de composant Web public (<gmp-place-item>) pour les éléments de liste de lieux. L'élément personnalisé <gmp-place-item> affiche une fiche de résultat de lieu individuelle dans <gmp-place-search>. Chaque <gmp-place-item> affiche des informations sur un lieu, composées de composants visuels enfants du Kit UI pour Places.

<gmp-place-item></gmp-place-item>
const {PlaceItemElement} = await google.maps.importLibrary("places");
Hérité : addEventListener, removeEventListener

PlaceItemElementOptions

interface google.maps.places.PlaceItemElementOptions
étendue par AdvancedPlaceItemElementOptions
implémentée par AdvancedPlaceItemElement, PlaceItemElement

Options pour PlaceItemElement.

Classe AdvancedPlaceSearchElement

class google.maps.places.AdvancedPlaceSearchElement extends PlaceSearchElement, HTMLElement implements AdvancedPlaceSearchElementOptions, PlaceSearchElementOptions
library "places"

Affiche les résultats d'une recherche de lieu avancée dans une liste. Ajoutez PlaceTextSearchRequestElement ou PlaceNearbySearchRequestElement pour spécifier la requête pour laquelle afficher les résultats. Ajoutez PlaceStandardContentElement, PlaceAllContentElement ou <template slot="details-item"> pour spécifier le contenu à afficher.

Exemple :

 <gmp-advanced-place-search>
  <gmp-place-text-search-request
    text-query="QUERY"
  ></gmp-place-text-search-request>
  <template slot="details-item">
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </template>
</gmp-advanced-place-search>

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

<gmp-advanced-place-search
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  selectable
  truncation-preferred>
</gmp-advanced-place-search>
const {AdvancedPlaceSearchElement} = await google.maps.importLibrary("places");
AdvancedPlaceSearchElement
AdvancedPlaceSearchElement([options])
Paramètres :
attributionPosition
attr: attribution-position
Type d'entrée : PlaceSearchAttributionPosition optional
Type de sortie : PlaceSearchAttributionPosition
Par défaut : PlaceSearchAttributionPosition.TOP
Position du logo d'attribution et du bouton de divulgation réglementaire.
Attribut HTML : attribution-position="value-name"
internalUsageAttributionIds
attr: internal-usage-attribution-ids
Type d'entrée : Iterable<string> optional
Type de sortie : Array<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
Attribut HTML : internal-usage-attribution-ids="space separated strings"
orientation
attr: orientation
Type d'entrée : PlaceSearchOrientation optional
Type de sortie : PlaceSearchOrientation
Par défaut : PlaceSearchOrientation.VERTICAL
Variante d'orientation (verticale ou horizontale) de l'élément.
Attribut HTML : orientation="value-name"
selectable
attr: selectable
Type d'entrée : boolean optional
Type de sortie : boolean
Par défaut : false
Indique si les éléments de la liste sont sélectionnables ou non. Si la valeur est "true", les éléments de la liste seront des boutons qui déclencheront l'événement gmp-select lorsqu'un utilisateur cliquera dessus. La navigation et la sélection accessibles au clavier sont également prises en charge.
Attribut HTML : selectable
truncationPreferred
attr: truncation-preferred
Type d'entrée : boolean optional
Type de sortie : boolean
Par défaut : false
Si la valeur est "true", tronque certaines lignes de contenu pour qu'elles tiennent sur une seule ligne au lieu de passer à la ligne.
Attribut HTML : truncation-preferred
Hérité : places
details-item
Modèle HTML contenant les widgets gmp-place à afficher pour chaque lieu dans les résultats de recherche.
--gmp-button-border-color
Couleur de la bordure du bouton "Ouvrir dans Maps".
--gmp-button-border-radius
Rayon de la bordure du bouton "Ouvrir dans Maps".
--gmp-button-border-width
Largeur de la bordure du bouton "Ouvrir dans Maps".
--gmp-card-border-radius
Rayon de la bordure des fiches de lieu.
--gmp-dialog-border-radius
Rayon de la bordure de la boîte de dialogue de divulgation de Google Maps.
--gmp-mat-color-info
Couleur des éléments d'interface utilisateur avec un sentiment d'information. Utilisé pour l'icône d'entrée accessible.
--gmp-mat-color-negative
Couleur des éléments d'interface utilisateur avec un sentiment négatif. Utilisé pour le libellé "Fermé" des horaires d'ouverture d'un lieu.
--gmp-mat-color-neutral-container
Couleur du conteneur pour les éléments d'interface utilisateur remplis de manière neutre. Utilisé pour les badges de date d'avis et les formes d'espace réservé de chargement.
--gmp-mat-color-on-neutral-container
Couleur du texte et des icônes sur un conteneur neutre. Utilisé pour le texte de la date de l'avis et le texte de l'erreur de chargement.
--gmp-mat-color-on-secondary-container
Couleur du texte et des icônes sur une couleur de conteneur secondaire. Utilisée pour le texte des boutons et les icônes.
--gmp-mat-color-on-surface
Couleur du texte et des icônes sur une couleur de surface. Utilisé pour les titres et le contenu des boîtes de dialogue.
--gmp-mat-color-on-surface-variant
Couleur moins accentuée pour le texte et les icônes sur une couleur de surface. Utilisé pour obtenir des informations sur un lieu.
--gmp-mat-color-outline-decorative
Couleur du contour des éléments non interactifs. Utilisé pour la bordure du conteneur.
--gmp-mat-color-positive
Couleur des éléments d'interface utilisateur avec un sentiment positif. Utilisé pour le libellé "Ouvert" des horaires d'ouverture d'un lieu.
--gmp-mat-color-primary
Couleur du texte et des icônes interactifs par rapport à la couleur de la surface. Utilisé pour les liens, l'indicateur de chargement et les icônes de présentation.
--gmp-mat-color-secondary-container
Couleur de remplissage moins visible sur une surface. Utilisé pour les arrière-plans des boutons.
--gmp-mat-color-surface
Couleur des arrière-plans. Utilisé pour les arrière-plans des conteneurs et des boîtes de dialogue.
--gmp-mat-font-body-small
Utilisé pour obtenir des informations sur un lieu.
--gmp-mat-font-family
Famille de polices de base pour tout le texte.
--gmp-mat-font-headline-medium
Utilisé pour les titres des boîtes de dialogue.
--gmp-mat-font-label-large
Utilisé pour le contenu du bouton.
--gmp-mat-font-title-medium
Utilisé pour le nom du lieu.
--gmp-mat-spacing-extra-small
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-large
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-medium
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-small
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-star-rating-color
Couleur des étoiles pleines dans une note.
--gmp-thumbnail-border-radius
Rayon de la bordure de la miniature 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 la 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 sur color-scheme. La valeur par défaut est color-scheme: light dark.
font-size
Met à l'échelle l'ensemble du texte et des icônes de l'élément. La valeur par défaut est 16px.
Hérité : addEventListener, removeEventListener
gmp-error
function(event)
Arguments :
Cet événement est déclenché lorsqu'une requête adressée au backend est refusée (par exemple, clé API incorrecte). Cet événement ne se propage 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 se propage pas.
gmp-select
function(event)
Arguments :
Cet événement est déclenché lorsqu'un lieu est sélectionné dans la liste. Contient un objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu sélectionné.

Interface AdvancedPlaceSearchElementOptions

interface google.maps.places.AdvancedPlaceSearchElementOptions extends PlaceSearchElementOptions
implemented by AdvancedPlaceSearchElement

Options pour AdvancedPlaceSearchElement.

attributionPosition
facultatif
internalUsageAttributionIds
facultatif
Type : Iterable<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
orientation
facultatif
Type : PlaceSearchOrientation optional
selectable
facultatif
Type : boolean optional
truncationPreferred
facultatif
Type : boolean optional

Classe AdvancedPlaceListElement

class google.maps.places.AdvancedPlaceListElement extends HTMLElement implements AdvancedPlaceListElementOptions
library "places"

Affiche les résultats d'une recherche de lieu dans une liste. Ajoutez un ou plusieurs PlaceDetailsPlaceRequestElement ou définissez la propriété places pour spécifier les lieux à afficher. Ajoutez PlaceStandardContentElement ou PlaceAllContentElement pour spécifier le contenu à afficher.

Exemple :

 <gmp-advanced-place-list>
  <gmp-place-details-place-request
    place="PLACE_ID"
  </gmp-place-details-place-request>
  <template slot="details-item">
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </template>
</gmp-advanced-place-list>

Pour utiliser l'élément de liste de lieux avancée, activez l'API Kit UI pour Places pour votre projet dans la console Google Cloud.

<gmp-advanced-place-list
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  places="space separated strings"
  selectable
  truncation-preferred>
</gmp-advanced-place-list>
const {AdvancedPlaceListElement} = await google.maps.importLibrary("places");
AdvancedPlaceListElement
AdvancedPlaceListElement([options])
Paramètres :
attributionPosition
attr: attribution-position
Type d'entrée : PlaceSearchAttributionPosition optional
Type de sortie : PlaceSearchAttributionPosition
Par défaut : PlaceSearchAttributionPosition.TOP
Position du logo d'attribution et du bouton de divulgation réglementaire.
Attribut HTML : attribution-position="value-name"
internalUsageAttributionIds
attr: internal-usage-attribution-ids
Type d'entrée : Iterable<string> optional
Type de sortie : Array<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
Attribut HTML : internal-usage-attribution-ids="space separated strings"
orientation
attr: orientation
Type d'entrée : PlaceSearchOrientation optional
Type de sortie : PlaceSearchOrientation
Par défaut : PlaceSearchOrientation.VERTICAL
Variante d'orientation (verticale ou horizontale) de l'élément.
Attribut HTML : orientation="value-name"
places
attr: places
Type d'entrée : Iterable<Place|string> optional
Type de sortie : Array<Place>
Liste d'objets Place contenant les ID à afficher dans cet élément. Notez que tous les lieux définis dans la propriété "places" peuvent ne pas s'afficher s'ils n'ont pas pu être affichés(par exemple, ID non valide, erreur de requête réseau, etc.). La propriété "places" peut être lue pour récupérer les lieux actuellement affichés.
Attribut HTML : places="space separated strings"
selectable
attr: selectable
Type d'entrée : boolean optional
Type de sortie : boolean
Par défaut : false
Indique si les éléments de la liste sont sélectionnables ou non. Si la valeur est "true", les éléments de la liste seront des boutons qui déclencheront l'événement gmp-select lorsqu'un utilisateur cliquera dessus. La navigation et la sélection accessibles au clavier sont également prises en charge.
Attribut HTML : selectable
truncationPreferred
attr: truncation-preferred
Type d'entrée : boolean optional
Type de sortie : boolean
Par défaut : false
Si la valeur est "true", tronque certaines lignes de contenu pour qu'elles tiennent sur une seule ligne au lieu de passer à la ligne.
Attribut HTML : truncation-preferred
details-item
Modèle HTML contenant les widgets gmp-place à afficher pour chaque lieu de la liste.
--gmp-button-border-color
Couleur de la bordure du bouton "Ouvrir dans Maps".
--gmp-button-border-radius
Rayon de la bordure du bouton "Ouvrir dans Maps".
--gmp-button-border-width
Largeur de la bordure du bouton "Ouvrir dans Maps".
--gmp-card-border-radius
Rayon de la bordure des fiches de lieu.
--gmp-dialog-border-radius
Rayon de la bordure de la boîte de dialogue de divulgation de Google Maps.
--gmp-mat-color-info
Couleur des éléments d'interface utilisateur avec un sentiment d'information. Utilisé pour l'icône d'entrée accessible.
--gmp-mat-color-negative
Couleur des éléments d'interface utilisateur avec un sentiment négatif. Utilisé pour le libellé "Fermé" des horaires d'ouverture d'un lieu.
--gmp-mat-color-neutral-container
Couleur du conteneur pour les éléments d'interface utilisateur remplis de manière neutre. Utilisé pour les badges de date d'avis et les formes d'espace réservé de chargement.
--gmp-mat-color-on-neutral-container
Couleur du texte et des icônes sur un conteneur neutre. Utilisé pour le texte de la date de l'avis et le texte de l'erreur de chargement.
--gmp-mat-color-on-secondary-container
Couleur du texte et des icônes sur une couleur de conteneur secondaire. Utilisée pour le texte des boutons et les icônes.
--gmp-mat-color-on-surface
Couleur du texte et des icônes sur une couleur de surface. Utilisé pour les titres et le contenu des boîtes de dialogue.
--gmp-mat-color-on-surface-variant
Couleur moins accentuée pour le texte et les icônes sur une couleur de surface. Utilisé pour obtenir des informations sur un lieu.
--gmp-mat-color-outline-decorative
Couleur du contour des éléments non interactifs. Utilisé pour la bordure du conteneur.
--gmp-mat-color-positive
Couleur des éléments d'interface utilisateur avec un sentiment positif. Utilisé pour le libellé "Ouvert" des horaires d'ouverture d'un lieu.
--gmp-mat-color-primary
Couleur du texte et des icônes interactifs par rapport à la couleur de la surface. Utilisé pour les liens, l'indicateur de chargement et les icônes de présentation.
--gmp-mat-color-secondary-container
Couleur de remplissage moins visible sur une surface. Utilisé pour les arrière-plans des boutons.
--gmp-mat-color-surface
Couleur des arrière-plans. Utilisé pour les arrière-plans des conteneurs et des boîtes de dialogue.
--gmp-mat-font-body-small
Utilisé pour obtenir des informations sur un lieu.
--gmp-mat-font-family
Famille de polices de base pour tout le texte.
--gmp-mat-font-headline-medium
Utilisé pour les titres des boîtes de dialogue.
--gmp-mat-font-label-large
Utilisé pour le contenu du bouton.
--gmp-mat-font-title-medium
Utilisé pour le nom du lieu.
--gmp-mat-spacing-extra-small
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-large
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-medium
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-mat-spacing-small
Utilisé pour l'espacement dans l'élément, comme la marge et la marge intérieure autour du texte.
--gmp-star-rating-color
Couleur des étoiles pleines dans une note.
--gmp-thumbnail-border-radius
Rayon de la bordure de la miniature 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 la 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 sur color-scheme. La valeur par défaut est color-scheme: light dark.
font-size
Met à l'échelle l'ensemble du texte et des icônes de l'élément. La valeur par défaut est 16px.
Hérité : addEventListener, removeEventListener
gmp-error
function(event)
Arguments :
Cet événement est déclenché lorsqu'une requête adressée au backend est refusée (par exemple, clé API incorrecte). Cet événement ne se propage 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 se propage pas.
gmp-select
function(event)
Arguments :
Cet événement est déclenché lorsqu'un lieu est sélectionné dans la liste. Contient un objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu sélectionné.

Interface AdvancedPlaceListElementOptions

interface google.maps.places.AdvancedPlaceListElementOptions
implémentée par AdvancedPlaceListElement

Options pour AdvancedPlaceListElement.

attributionPosition
facultatif
internalUsageAttributionIds
facultatif
Type : Iterable<string> optional
Identifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques.
orientation
facultatif
Type : PlaceSearchOrientation optional
places
facultatif
Type : Iterable<Place|string> optional
selectable
facultatif
Type : boolean optional
truncationPreferred
facultatif
Type : boolean optional

Classe AdvancedPlaceItemElement

class google.maps.places.AdvancedPlaceItemElement extends PlaceItemElement, HTMLElement implements AdvancedPlaceItemElementOptions, PlaceItemElementOptions
library "places"

Wrapper de composant Web public (<gmp-advanced-place-item>) pour les éléments de liste de lieux avancés. L'élément personnalisé <gmp-advanced-place-item> affiche une fiche de résultat de lieu enrichi individuelle dans un conteneur de recherche avancée ou de collection, tel que <gmp-advanced-place-search> ou <gmp-advanced-place-list>. Chaque <gmp-advanced-place-item> présente des détails complets sur le lieu, des collages multimédias, des résumés éditoriaux et des boutons d'action interactifs composés de composants visuels enfants du Kit UI pour Places.

<gmp-advanced-place-item></gmp-advanced-place-item>
const {AdvancedPlaceItemElement} = await google.maps.importLibrary("places");
Alphabasic-section-bottom
Emplacement pour le contenu HTML personnalisé affiché en bas de la section des informations de base, juste en dessous des boutons d'action principaux.
Alphabasic-section-top
Emplacement pour le contenu HTML personnalisé affiché dans la section des informations de base, directement au-dessus du nom du lieu.
Hérité : addEventListener, removeEventListener

Interface AdvancedPlaceItemElementOptions

interface google.maps.places.AdvancedPlaceItemElementOptions extends PlaceItemElementOptions
implemented by AdvancedPlaceItemElement

Options pour AdvancedPlaceItemElement.

Constantes PlaceSearchAttributionPosition

google.maps.places.PlaceSearchAttributionPosition
bibliothèque "places"

Positions d'attribution pour PlaceSearchElement.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type PlaceSearchAttributionPositionString.

const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places");
BOTTOM Attribution en bas de PlaceSearchElement
TOP Attribution en haut de PlaceSearchElement

PlaceSearchOrientation constants

google.maps.places.PlaceSearchOrientation
bibliothèque "places"

Variantes d'orientation pour PlaceSearchElement.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type PlaceSearchOrientationString.

const {PlaceSearchOrientation} = await google.maps.importLibrary("places");
HORIZONTAL Orientation horizontale.
VERTICAL Orientation verticale.

Classe PlaceSelectEvent

class google.maps.places.PlaceSelectEvent extends Event
library "places"

Cet événement se déclenche lorsqu'un lieu est sélectionné dans une liste de lieux. Accédez à la sélection avec event.place.

const {PlaceSelectEvent} = await google.maps.importLibrary("places");
place
readonly
Type : Place
Le lieu sélectionné.

Classe PlaceNearbySearchRequestElement

class google.maps.places.PlaceNearbySearchRequestElement extends HTMLElement implements PlaceNearbySearchRequestElementOptions
library "places"

Configure un PlaceSearchElement pour charger les résultats en fonction d'une requête Nearby Search. La propriété locationRestriction est obligatoire pour charger l'élément de recherche. Toutes les autres propriétés configurées seront ignorées si locationRestriction n'est pas défini. Ajoutez cet élément en tant qu'enfant d'un PlaceSearchElement pour charger les résultats. Exemple :

 <gmp-place-search>
  <gmp-place-nearby-search-request
    location-restriction="RADIUS@LAT,LNG"
  ></gmp-place-nearby-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

<gmp-place-nearby-search-request
  excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."
  excluded-types="excluded-type1 excluded-type2..."
  included-primary-types="included-primary-type1 included-primary-type2..."
  included-types="included-type1 included-type2..."
  location-restriction="radius@lat,lng"
  max-result-count="number"
  rank-preference="value-name">
</gmp-place-nearby-search-request>
const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places");
PlaceNearbySearchRequestElement
PlaceNearbySearchRequestElement([options])
Paramètres :
excludedPrimaryTypes
attr: excluded-primary-types
Type d'entrée : Array<string> optional
Type de sortie : Array<string> optional
Par défaut : null
Types de lieux principaux exclus.
Attribut HTML : excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."
excludedTypes
attr: excluded-types
Type d'entrée : Array<string> optional
Type de sortie : Array<string> optional
Par défaut : null
Types de lieux exclus.
Attribut HTML : excluded-types="excluded-type1 excluded-type2..."
futureOpeningBusinessesIncluded
Type d'entrée : boolean optional
Type de sortie : boolean optional
Incluez des prédictions de lieux pour les établissements qui ne sont pas encore ouverts, mais qui devraient l'être à l'avenir.
includedPrimaryTypes
attr: included-primary-types
Type d'entrée : Array<string> optional
Type de sortie : Array<string> optional
Par défaut : null
Type de lieu principal inclus.
Attribut HTML : included-primary-types="included-primary-type1 included-primary-type2..."
includedTypes
attr: included-types
Type d'entrée : Array<string> optional
Type de sortie : Array<string> optional
Par défaut : null
Type de lieu inclus.
Attribut HTML : included-types="included-type1 included-type2..."
locationRestriction
attr: location-restriction
Type d'entrée : Circle|CircleLiteral optional
Type de sortie : Circle optional
Par défaut : null
Région dans laquelle effectuer la recherche. Normalise en Circle.
Attribut HTML : location-restriction="radius@lat,lng"
maxResultCount
attr: max-result-count
Type d'entrée : number optional
Type de sortie : number optional
Par défaut : null
Nombre maximal de résultats à renvoyer.
Attribut HTML : max-result-count="number"
rankPreference
attr: rank-preference
Type d'entrée : SearchNearbyRankPreference optional
Type de sortie : SearchNearbyRankPreference optional
Par défaut : null
Comment les résultats seront classés dans la réponse.
Attribut HTML : rank-preference="value-name"
Hérité : addEventListener, removeEventListener

PlaceNearbySearchRequestElementOptions

interface google.maps.places.PlaceNearbySearchRequestElementOptions
implémentée par PlaceNearbySearchRequestElement

Options pour PlaceNearbySearchRequestElement.

excludedPrimaryTypes
facultatif
Type : Array<string> optional
Types de lieux principaux exclus. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.excludedPrimaryTypes et SearchNearbyRequest.excludedPrimaryTypes.
excludedTypes
facultatif
Type : Array<string> optional
Types de lieux exclus. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.excludedTypes et SearchNearbyRequest.excludedTypes.
futureOpeningBusinessesIncluded
facultatif
Type : boolean optional
Incluez des prédictions de lieux pour les établissements qui ne sont pas encore ouverts, mais qui devraient l'être à l'avenir.
includedPrimaryTypes
facultatif
Type : Array<string> optional
Types de lieux principaux inclus. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.includedPrimaryTypes et SearchNearbyRequest.includedPrimaryTypes.
includedTypes
facultatif
Type : Array<string> optional
Types de lieux inclus. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.includedTypes et SearchNearbyRequest.includedTypes.
locationRestriction
facultatif
Type : Circle|CircleLiteral optional
Région dans laquelle effectuer la recherche. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.locationRestriction et SearchNearbyRequest.locationRestriction.
maxResultCount
facultatif
Type : number optional
Nombre maximal de résultats à renvoyer. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.maxResultCount et SearchNearbyRequest.maxResultCount.
rankPreference
facultatif
Comment les résultats seront classés dans la réponse. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.rankPreference et SearchNearbyRankPreference.

Classe PlaceTextSearchRequestElement

class google.maps.places.PlaceTextSearchRequestElement extends HTMLElement implements PlaceTextSearchRequestElementOptions
library "places"

Configure un PlaceSearchElement pour charger les résultats en fonction d'une requête de recherche textuelle. La propriété textQuery est obligatoire pour charger l'élément de recherche. Toutes les autres propriétés configurées seront ignorées si textQuery n'est pas défini. Ajoutez cet élément en tant qu'enfant d'un PlaceSearchElement pour charger les résultats. Exemple :

 <gmp-place-search>
  <gmp-place-text-search-request
    text-query="QUERY"
  ></gmp-place-text-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

<gmp-place-text-search-request
  ev-connector-types="ev-connector-type1 ev-connector-type2..."
  ev-minimum-charging-rate-kw="number"
  included-type="type"
  is-open-now
  location-bias="lat,lng"
  location-restriction="southwest-lat,southwest-lng|northeast-lat,northeast-lng"
  max-result-count="number"
  min-rating="number"
  price-levels="price-level1 price-level2..."
  rank-preference="value-name"
  text-query="string"
  use-strict-type-filtering>
</gmp-place-text-search-request>
const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places");
PlaceTextSearchRequestElement
PlaceTextSearchRequestElement([options])
Paramètres :
evConnectorTypes
attr: ev-connector-types
Type d'entrée : Array<EVConnectorType> optional
Type de sortie : Array<EVConnectorType> optional
Par défaut : null
Liste des types de connecteurs de VE préférés.
Attribut HTML : ev-connector-types="ev-connector-type1 ev-connector-type2..."
evMinimumChargingRateKw
attr: ev-minimum-charging-rate-kw
Type d'entrée : number optional
Type de sortie : number optional
Par défaut : null
Vitesse de recharge minimale requise en kilowatts.
Attribut HTML : ev-minimum-charging-rate-kw="number"
futureOpeningBusinessesIncluded
Type d'entrée : boolean optional
Type de sortie : boolean optional
Incluez des prédictions de lieux pour les établissements qui ne sont pas encore ouverts, mais qui devraient l'être à l'avenir.
includedType
attr: included-type
Type d'entrée : string optional
Type de sortie : string optional
Par défaut : null
Type de lieu demandé.
Attribut HTML : included-type="type"
isOpenNow
attr: is-open-now
Type d'entrée : boolean optional
Type de sortie : boolean optional
Par défaut : null
Permet de limiter la recherche aux lieux qui sont actuellement ouverts.
Attribut HTML : is-open-now
locationBias
attr: location-bias
Type d'entrée : LocationBias optional
Type de sortie : LatLngAltitude|LatLngBounds|Circle|string optional
Par défaut : null
Biais de localisation pour la recherche.
Attribut HTML :
  • location-bias="lat,lng"
  • location-bias="lat,lng[,altitude]"
  • location-bias="swlat,swlng|nelat,nelng"
  • location-bias="radius@lat,lng"
  • location-bias="IP_BIAS"
locationRestriction
attr: location-restriction
Type d'entrée : LatLngBounds|LatLngBoundsLiteral optional
Type de sortie : LatLngBounds optional
Par défaut : null
Restriction de l'emplacement pour la recherche. Normalise en LatLngBounds.
Attribut HTML : location-restriction="southwest-lat,southwest-lng|northeast-lat,northeast-lng"
maxResultCount
attr: max-result-count
Type d'entrée : number optional
Type de sortie : number optional
Par défaut : null
Nombre maximal de résultats à renvoyer.
Attribut HTML : max-result-count="number"
minRating
attr: min-rating
Type d'entrée : number optional
Type de sortie : number optional
Par défaut : null
Excluez les résultats dont la note moyenne des utilisateurs est strictement inférieure à cette limite.
Attribut HTML : min-rating="number"
priceLevels
attr: price-levels
Type d'entrée : Array<PriceLevel> optional
Type de sortie : Array<PriceLevel> optional
Par défaut : null
Permet de limiter la recherche aux lieux marqués comme correspondant à certains niveaux de prix.
Attribut HTML : price-levels="price-level1 price-level2..."
rankPreference
attr: rank-preference
Type d'entrée : SearchByTextRankPreference optional
Type de sortie : SearchByTextRankPreference optional
Par défaut : null
Comment les résultats seront classés dans la réponse.
Attribut HTML : rank-preference="value-name"
textQuery
attr: text-query
Type d'entrée : string optional
Type de sortie : string optional
Par défaut : null
Requête textuelle pour la recherche textuelle.
Attribut HTML : text-query="string"
useStrictTypeFiltering
attr: use-strict-type-filtering
Type d'entrée : boolean optional
Type de sortie : boolean optional
Par défaut : null
Permet de définir un filtrage de type strict pour "includedType".
Attribut HTML : use-strict-type-filtering
Hérité : addEventListener, removeEventListener

PlaceTextSearchRequestElementOptions interface

interface google.maps.places.PlaceTextSearchRequestElementOptions
implémentée par PlaceTextSearchRequestElement

Options pour PlaceTextSearchRequestElement.

evConnectorTypes
facultatif
Type : Array<EVConnectorType> optional
Liste des types de connecteurs de VE préférés. Pour en savoir plus, consultez SearchByTextRequest.evSearchOptions et PlaceTextSearchRequestElement.evConnectorTypes.
evMinimumChargingRateKw
facultatif
Type : number optional
Vitesse de recharge minimale requise en kilowatts. Pour en savoir plus, consultez SearchByTextRequest.evSearchOptions et PlaceTextSearchRequestElement.evMinimumChargingRateKw.
futureOpeningBusinessesIncluded
facultatif
Type : boolean optional
Incluez des prédictions de lieux pour les établissements qui ne sont pas encore ouverts, mais qui devraient l'être à l'avenir.
includedType
facultatif
Type : string optional
Type de lieu demandé. Pour en savoir plus, consultez SearchByTextRequest.includedType et PlaceTextSearchRequestElement.includedType.
isOpenNow
facultatif
Type : boolean optional
Permet de limiter la recherche aux lieux qui sont actuellement ouverts. Pour en savoir plus, consultez SearchByTextRequest.isOpenNow et PlaceTextSearchRequestElement.isOpenNow.
locationBias
facultatif
Type : LocationBias optional
Biais de localisation pour la recherche. Pour en savoir plus, consultez SearchByTextRequest.locationBias et PlaceTextSearchRequestElement.locationBias.
locationRestriction
facultatif
Restriction de l'emplacement pour la recherche. Pour en savoir plus, consultez SearchByTextRequest.locationRestriction et PlaceTextSearchRequestElement.locationRestriction.
maxResultCount
facultatif
Type : number optional
Nombre maximal de résultats à renvoyer. Pour en savoir plus, consultez SearchByTextRequest.maxResultCount et PlaceTextSearchRequestElement.maxResultCount.
minRating
facultatif
Type : number optional
Excluez les résultats dont la note moyenne des utilisateurs est strictement inférieure à cette limite. Pour en savoir plus, consultez SearchByTextRequest.minRating et PlaceTextSearchRequestElement.minRating.
priceLevels
facultatif
Type : Array<PriceLevel> optional
Permet de limiter la recherche aux lieux marqués comme correspondant à certains niveaux de prix. Pour en savoir plus, consultez SearchByTextRequest.priceLevels et PlaceTextSearchRequestElement.priceLevels.
rankPreference
facultatif
Comment les résultats seront classés dans la réponse. Pour en savoir plus, consultez SearchByTextRequest.rankPreference et PlaceTextSearchRequestElement.rankPreference.
textQuery
facultatif
Type : string optional
Requête textuelle pour la recherche textuelle. Pour en savoir plus, consultez SearchByTextRequest.textQuery et PlaceTextSearchRequestElement.textQuery.
useStrictTypeFiltering
facultatif
Type : boolean optional
Permet de définir un filtrage de type strict pour SearchByTextRequest.includedType. Pour en savoir plus, consultez SearchByTextRequest.useStrictTypeFiltering et PlaceTextSearchRequestElement.useStrictTypeFiltering.

Classe Autocomplete

class google.maps.places.Autocomplete extends MVCObject
library "places"

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

const {Autocomplete} = await google.maps.importLibrary("places");
Autocomplete
Autocomplete(inputField[, opts])
Paramètres :
Crée une instance de Autocomplete qui s'associe au champ de saisie de texte spécifié avec les options données.
getBounds
getBounds()
Paramètres : aucun
Valeur renvoyée : LatLngBounds|undefined Les limites de pondération.
Renvoie les limites vers lesquelles 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. 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 bien été récupérés. Sinon, renvoie un objet Place stub, avec la propriété name définie sur la valeur actuelle du champ de saisie.
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 de 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 de 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 seront renvoyés.
Héritées : 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 l'entrée de l'utilisateur dans la propriété name, sans qu'aucune autre propriété ne soit définie.

Interface AutocompleteOptions

interface google.maps.places.AutocompleteOptions

Options pouvant être définies sur un objet Autocomplete.

bounds
facultatif
Zone dans laquelle rechercher des lieux.
componentRestrictions
facultatif
Type : ComponentRestrictions optional
Restrictions liées aux composants. Les restrictions de composants permettent de limiter les prédictions à celles du composant parent. Par exemple, le pays.
fields
facultatif
Type : Array<string> optional
Champs à inclure pour le lieu dans la réponse de détails lorsque les détails sont récupérés avec succès, qui seront facturés. Si ['ALL'] 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 chemins d'accès séparés par des points (par exemple, "geometry.location"). La valeur par défaut est ['ALL'].
placeIdOnly
facultatif
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 comportera que les champs place_id, types et name, avec les champs place_id, types et description renvoyés par le service Autocomplete. Désactivé par défaut
strictBounds
facultatif
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 ces limites, mais n'y seront pas restreints.
types
facultatif
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 seront renvoyés.

class google.maps.places.SearchBox extends MVCObject
library "places"

Widget qui fournit des prédictions de requête en fonction de la saisie de texte d'un utilisateur. Il s'associe à un élément d'entrée de type text et écoute la saisie de texte dans ce champ. La liste des prédictions est présentée sous la forme d'une liste déroulante et est mise à jour à mesure que du texte est saisi.

const {SearchBox} = await google.maps.importLibrary("places");
SearchBox
SearchBox(inputField[, opts])
Paramètres :
Crée une instance de SearchBox qui s'associe au champ de saisie de texte spécifié avec les options données.
getBounds
getBounds()
Paramètres : aucun
Valeur renvoyée : LatLngBounds|undefined
Renvoie les limites vers lesquelles 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 biaiser les prédictions de requête. Les résultats seront pondérés en faveur de cette zone, mais ne s'y limiteront pas.
Héritées : 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.

SearchBoxOptions

interface google.maps.places.SearchBoxOptions

Options pouvant être définies sur un objet SearchBox.

bounds
facultatif
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.

Classe PlaceContextualElement

class google.maps.places.PlaceContextualElement extends HTMLElement implements PlaceContextualElementOptions
library "places"

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

<gmp-place-contextual
  context-token="string">
</gmp-place-contextual>
const {PlaceContextualElement} = await google.maps.importLibrary("places");
PlaceContextualElement
PlaceContextualElement([options])
Paramètres :
contextToken
attr: context-token
Type d'entrée : string optional
Type de sortie : string optional
Jeton de contexte.
Attribut HTML : context-token="string"
Hérité : addEventListener, removeEventListener

Interface PlaceContextualElementOptions

interface google.maps.places.PlaceContextualElementOptions
implémentée par PlaceContextualElement

Options pour PlaceContextualElement.

contextToken
facultatif
Type : string optional
Jeton de contexte fourni par la réponse d'ancrage avec Google Maps.

Classe PlaceContextualListConfigElement

class google.maps.places.PlaceContextualListConfigElement extends HTMLElement implements PlaceContextualListConfigElementOptions
library "places"

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

<gmp-place-contextual-list-config
  layout="value-name"
  map-hidden>
</gmp-place-contextual-list-config>
const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places");
PlaceContextualListConfigElement
PlaceContextualListConfigElement([options])
Paramètres :
layout
attr: layout
Type d'entrée : PlaceContextualListLayout optional
Type de sortie : PlaceContextualListLayout
La mise en page.
Attribut HTML : layout="value-name"
mapHidden
attr: map-hidden
Type d'entrée : boolean optional
Type de sortie : boolean
Indique si la carte est masquée.
Attribut HTML : map-hidden
Hérité : addEventListener, removeEventListener

PlaceContextualListConfigElementOptions

interface google.maps.places.PlaceContextualListConfigElementOptions
implémentée par PlaceContextualListConfigElement

Options pour PlaceContextualListConfigElement.

layout
facultatif
Type : PlaceContextualListLayout optional
La mise en page.
mapHidden
facultatif
Type : boolean optional
Par défaut : false
"True" si la carte doit être masquée.

Constantes PlaceContextualListLayout

google.maps.places.PlaceContextualListLayout
bibliothèque "places"

Liste des mises en page compatibles avec l'élément contextuel de lieu pour la vue sous forme de liste.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type PlaceContextualListLayoutString.

const {PlaceContextualListLayout} = await google.maps.importLibrary("places");
COMPACT Disposition en liste compacte : les éléments de la liste sont affichés sous forme de liens sur une seule ligne, avec des dépassements dans une liste déroulante.
VERTICAL Disposition en liste verticale : les éléments de la liste sont affichés sous forme de fiches dans une liste verticale.

Classe PlacePinElement

class google.maps.places.PlacePinElement extends HTMLElement implements PlacePinElementOptions
library "places"

Affiche un repère sur la carte pour un lieu, en utilisant l'icône de catégorie ou la photo du lieu. Ajoutez PlaceDetailsPlaceRequestElement ou PlaceDetailsLocationRequestElement pour spécifier le lieu. Utilisez l'épingle comme contenu d'un AdvancedMarkerElement. Non compatible avec les cartes 3D.

Exemple :

 <gmp-advanced-marker>
  <gmp-place-pin>
    <gmp-place-details-place-request
      place="PLACE_ID"
    ></gmp-place-details-place-request>
    <gmp-place-rating></gmp-place-rating>
  </gmp-place-pin>
</gmp-advanced-marker>

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

<gmp-place-pin
  icon="value-name"
  scale="number">
</gmp-place-pin>
const {PlacePinElement} = await google.maps.importLibrary("places");
PlacePinElement
PlacePinElement([options])
Paramètres :
icon
attr: icon
Type d'entrée : PlacePinIcon optional
Type de sortie : PlacePinIcon
Par défaut : PlacePinIcon.TYPE
Icône affichée dans le repère. Consultez les PlacePinIcon.
Attribut HTML : icon="value-name"
photoRendered
readonly
Type : boolean
Lecture seule. "True" si le repère affiche la photo du lieu. Toujours "false" si icon n'est pas PHOTO. Si icon est défini sur PHOTO, mais que le lieu n'a pas de photo ou que la photo n'a pas pu être chargée, la valeur est "false" et le repère affiche l'icône du type de lieu à la place. Définissez avant le déclenchement de gmp-load.
place
readonly
Type : Place optional
Lecture seule. Objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu actuellement affiché. undefined si le lieu n'a pas encore été chargé ou si le chargement a échoué.
scale
attr: scale
Type d'entrée : number optional
Type de sortie : number
Par défaut : 1
Multiplicateur de taille pour le repère.
Attribut HTML : scale="number"
default
Contenu facultatif affiché sur le repère, tel qu'un PlaceRatingElement, un <span> personnalisé ou du texte. Les enfants du DOM Light sont insérés directement dans le repère. L'emplacement du contenu dépend de icon : à côté de l'icône du type de lieu pour TYPE, sous forme de badge sur la photo pour PHOTO et comme contenu principal du repère pour NONE.
--gmp-background
Couleur d'arrière-plan du repère : la pastille, le cadre de la photo, le badge de la photo, le bec et la bordure du repère de type de lieu.
--gmp-border-radius
Rayon de la bordure de la pastille (icône de type de lieu avec contenu inséré ou contenu inséré seul) et du cadre photo dans les repères PHOTO. La valeur par défaut est 30px pour une icône de type de lieu avec un contenu inséré, 12px pour un contenu inséré seul et un cadre photo 12px. Ne s'applique pas au repère de type lieu sans contenu d'emplacement.
--gmp-glyph-background
Couleur d'arrière-plan derrière le glyphe du type de lieu. La valeur par défaut est le iconBackgroundColor du lieu.
--gmp-glyph-color
Couleur du glyphe du type de lieu. S'applique chaque fois que le glyphe est affiché, y compris lorsqu'un repère PHOTO est remplacé par l'icône du type de lieu.
Hérité : addEventListener, removeEventListener
gmp-error
function(event)
Arguments :
Cet événement est déclenché lorsque l'épingle ne peut pas être affichée, par exemple en raison d'une défaillance du réseau, d'un problème d'identifiants (comme une clé API incorrecte), d'un ID de lieu qui ne peut pas être résolu ou d'un lieu sans emplacement. Le code est masqué. Cet événement ne se propage pas.
gmp-load
function(event)
Arguments :
Cet événement est déclenché une fois que les détails du lieu ont été chargés et que le repère a été affiché. Lorsque icon est défini sur PHOTO, il ne se déclenche qu'après le chargement ou l'échec de la photo. Un échec de photo seul ne déclenche pas gmp-error. Lisez le lieu chargé à partir de PlacePinElement.place et déterminez si la photo est affichée à partir de PlacePinElement.photoRendered. Cet événement ne se propage pas.

Interface PlacePinElementOptions

interface google.maps.places.PlacePinElementOptions
implémentée par PlacePinElement

Options de construction d'un PlacePinElement.

icon
facultatif
Type : PlacePinIcon optional
Consultez les PlacePinElement.icon.
scale
facultatif
Type : number optional
Consultez les PlacePinElement.scale.

PlacePinIcon

google.maps.places.PlacePinIcon
bibliothèque "places"

Options d'icône pour PlacePinElement. TYPE est la valeur par défaut. Si les données nécessaires à l'icône sélectionnée sont manquantes, le repère revient à TYPE. Si les données nécessaires pour TYPE sont manquantes, une icône générique s'affiche à la place.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type PlacePinIconString.

const {PlacePinIcon} = await google.maps.importLibrary("places");
NONE N'affiche aucune icône, seulement le contenu de l'emplacement.
PHOTO Affiche la photo du lieu dans un cercle. Utilise TYPE si le lieu n'a pas de photo.
TYPE Affiche l'icône de la catégorie du lieu.