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");
Constructeur | |
|---|---|
PlaceAutocompleteElement |
PlaceAutocompleteElement([options])Paramètres :
|
Propriétés | |
|---|---|
description
attr: description |
Type :
string optionalDescription à 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 optionalType de sortie : booleanIndique 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 optionalIndique 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> optionalType 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> optionalIncluez 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 |
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 optionalLimite souple ou indice à utiliser lors de la recherche de lieux. |
locationRestriction |
Type :
LocationRestriction optionalLimites pour restreindre les résultats de recherche. |
maxlength
attr: maxlength |
Type :
number optionalNombre 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 optionalNom à 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 optionalType de sortie : booleanIndique si le bouton d'effacement doit être masqué.
Attribut HTML : no-clear-button |
noInputIcon
attr: no-input-icon |
Type d'entrée :
boolean optionalType de sortie : booleanIndique 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 optionalType de sortie : LatLngAltitude optionalOrigine à 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 :
|
placeholder
attr: placeholder |
Type :
string optionalTexte 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 optionalIndique 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 optionalType de sortie : booleanIndique 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 optionalIdentifiant 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 optionalCode 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 |
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 optionalType de sortie : stringValeur de l'élément d'entrée. |
Emplacements | |
|---|---|
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. |
Pièces | |
|---|---|
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. |
Propriétés CSS | |
|---|---|
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. |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Événements | |
|---|---|
gmp-error |
function(errorEvent)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-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.
Propriétés | |
|---|---|
description
facultatif |
Type :
string optionalDescription à 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 |
Type :
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional |
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 optionalValeur 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");
Propriétés | |
|---|---|
placePrediction
readonly |
Type :
PlacePredictionConvertissez-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");
Constructeur | |
|---|---|
BasicPlaceAutocompleteElement |
BasicPlaceAutocompleteElement([options])Paramètres :
|
Propriétés | |
|---|---|
description
attr: description |
Type :
string optionalDescription à 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 optionalType de sortie : booleanIndique 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 optionalIndique 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> optionalType 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> optionalIncluez 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 |
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 optionalLimite souple ou indice à utiliser lors de la recherche de lieux. |
locationRestriction |
Type :
LocationRestriction optionalLimites pour restreindre les résultats de recherche. |
maxlength
attr: maxlength |
Type :
number optionalNombre 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 optionalNom à 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 optionalType de sortie : booleanIndique si le bouton d'effacement doit être masqué.
Attribut HTML : no-clear-button |
noInputIcon
attr: no-input-icon |
Type d'entrée :
boolean optionalType de sortie : booleanIndique 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 optionalType de sortie : LatLngAltitude optionalOrigine à 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 :
|
placeholder
attr: placeholder |
Type :
string optionalTexte 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 optionalIndique 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 optionalType de sortie : booleanIndique 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 optionalIdentifiant 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 optionalCode 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 |
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" |
Emplacements | |
|---|---|
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. |
Pièces | |
|---|---|
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. |
Propriétés CSS | |
|---|---|
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. |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Événements | |
|---|---|
gmp-error |
function(errorEvent)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-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.
Propriétés | |
|---|---|
description
facultatif |
Type :
string optionalDescription à 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 |
Type :
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional |
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 , PlaceContentConfigElementPlaceStandardContentElement 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");
Constructeur | |
|---|---|
PlaceDetailsElement |
PlaceDetailsElement([options])Paramètres :
|
Propriétés | |
|---|---|
internalUsageAttributionIds
attr: internal-usage-attribution-ids |
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 optionalLecture seule. Objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu actuellement affiché. |
Propriétés CSS | |
|---|---|
--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. |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Événements | |
|---|---|
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.
Propriétés | |
|---|---|
internalUsageAttributionIds
facultatif |
Type :
Iterable<string> optionalIdentifiants 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 , PlaceContentConfigElementPlaceStandardContentElement 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");
Constructeur | |
|---|---|
PlaceDetailsCompactElement |
PlaceDetailsCompactElement([options])Paramètres :
|
Propriétés | |
|---|---|
internalUsageAttributionIds
attr: internal-usage-attribution-ids |
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 optionalPar défaut :
PlaceDetailsOrientation.VERTICALVariante d'orientation (verticale ou horizontale) de l'élément.
Attribut HTML : orientation="value-name" |
place
readonly |
Type :
Place optionalLecture 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 optionalType de sortie : booleanPar défaut :
falseSi 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 |
Propriétés CSS | |
|---|---|
--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. |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Événements | |
|---|---|
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.
Propriétés | |
|---|---|
internalUsageAttributionIds
facultatif |
Type :
Iterable<string> optionalIdentifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques. |
orientation
facultatif |
Type :
PlaceDetailsOrientation optionalConsultez les PlaceDetailsCompactElement.orientation. |
truncationPreferred
facultatif |
Type :
boolean optionalConsultez les PlaceDetailsCompactElement.truncationPreferred. |
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");
Constructeur | |
|---|---|
AdvancedPlaceDetailsElement |
AdvancedPlaceDetailsElement([options])Paramètres :
|
Propriétés | |
|---|---|
internalUsageAttributionIds
attr: internal-usage-attribution-ids |
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 optionalLecture seule. Objet Place contenant l'ID, l'emplacement et la fenêtre d'affichage du lieu actuellement affiché. |
Emplacements | |
|---|---|
action-corner |
Un créneau de PlaceLinkElement et PlaceButtonElement. |
action-main |
Un créneau de PlaceLinkElement et PlaceButtonElement. |
|
Emplacement pour le contenu HTML personnalisé affiché en bas de la section des informations de base, juste en dessous des boutons d'action principaux. |
|
Emplacement pour le contenu HTML personnalisé affiché dans la section des informations de base, directement au-dessus du nom du lieu. |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Événements | |
|---|---|
Hérité :
gmp-error,
gmp-load
|
Interface AdvancedPlaceDetailsElementOptions
interface
google.maps.places.AdvancedPlaceDetailsElementOptions
extends PlaceDetailsElementOptions
implemented by AdvancedPlaceDetailsElement
Options pour AdvancedPlaceDetailsElement.
Propriétés | |
|---|---|
internalUsageAttributionIds
facultatif |
Type :
Iterable<string> optionalIdentifiants 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");
Constructeur | |
|---|---|
AdvancedPlaceDetailsCompactElement |
AdvancedPlaceDetailsCompactElement([options])Paramètres :
|
Propriétés | |
|---|---|
internalUsageAttributionIds
attr: internal-usage-attribution-ids |
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 optionalLecture 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)
| |
Emplacements | |
|---|---|
action-corner |
Un créneau de PlaceLinkElement et PlaceButtonElement. |
action-main |
Un créneau de PlaceLinkElement et PlaceButtonElement. |
|
Emplacement pour le contenu HTML personnalisé affiché en bas de la section des informations de base, juste en dessous des boutons d'action principaux. |
|
Emplacement pour le contenu HTML personnalisé affiché dans la section des informations de base, directement au-dessus du nom du lieu. |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Événements | |
|---|---|
Hérité :
gmp-error,
gmp-load
|
AdvancedPlaceDetailsCompactElementOptions
interface
google.maps.places.AdvancedPlaceDetailsCompactElementOptions
extends PlaceDetailsCompactElementOptions
implemented by AdvancedPlaceDetailsCompactElement
Options pour AdvancedPlaceDetailsCompactElement.
Propriétés | |
|---|---|
internalUsageAttributionIds
facultatif |
Type :
Iterable<string> optionalIdentifiants 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");
Constantes | |
|---|---|
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");
Constructeur | |
|---|---|
PlaceDetailsPlaceRequestElement |
PlaceDetailsPlaceRequestElement([options])Paramètres :
|
Propriétés | |
|---|---|
place
attr: place |
Par défaut :
nullObjet, 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/###" |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Interface PlaceDetailsPlaceRequestElementOptions
interface
google.maps.places.PlaceDetailsPlaceRequestElementOptions
implémentée par PlaceDetailsPlaceRequestElement
Options pour PlaceDetailsPlaceRequestElement.
Propriétés | |
|---|---|
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");
Constructeur | |
|---|---|
PlaceDetailsLocationRequestElement |
PlaceDetailsLocationRequestElement([options])Paramètres :
|
Propriétés | |
|---|---|
location
attr: location |
Type d'entrée :
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalType de sortie : LatLngAltitude optionalPar défaut :
nullLieu pour lequel afficher les détails dans l'élément Place Details. Normalise en
LatLngAltitude.Attribut HTML : location="lat,lng" |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Interface PlaceDetailsLocationRequestElementOptions
interface
google.maps.places.PlaceDetailsLocationRequestElementOptions
implémentée par PlaceDetailsLocationRequestElement
Options pour PlaceDetailsLocationRequestElement.
Propriétés | |
|---|---|
location
facultatif |
Type :
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalEmplacement 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 , PlaceContentConfigElementPlaceStandardContentElement 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");
Constructeur | |
|---|---|
PlaceSearchElement |
PlaceSearchElement([options])Paramètres :
|
Propriétés | |
|---|---|
attributionPosition
attr: attribution-position |
Type d'entrée :
PlaceSearchAttributionPosition optionalType de sortie : PlaceSearchAttributionPositionPar défaut :
PlaceSearchAttributionPosition.TOPPosition du logo d'attribution et du bouton de divulgation réglementaire.
Attribut HTML : attribution-position="value-name" |
internalUsageAttributionIds
attr: internal-usage-attribution-ids |
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 |
Par défaut :
PlaceSearchOrientation.VERTICALVariante d'orientation (verticale ou horizontale) de l'élément.
Attribut HTML : orientation="value-name" |
places
readonly |
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 optionalType de sortie : booleanPar défaut :
falseIndique 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 optionalType de sortie : booleanPar défaut :
falseSi 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 |
Propriétés CSS | |
|---|---|
--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. |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Événements | |
|---|---|
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.
Propriétés | |
|---|---|
attributionPosition
facultatif |
Type :
PlaceSearchAttributionPosition optionalConsultez les PlaceSearchElement.attributionPosition. |
internalUsageAttributionIds
facultatif |
Type :
Iterable<string> optionalIdentifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques. |
orientation
facultatif |
Type :
PlaceSearchOrientation optionalConsultez les PlaceSearchElement.orientation. |
selectable
facultatif |
Type :
boolean optionalVoir les PlaceSearchElement.selectable |
truncationPreferred
facultatif |
Type :
boolean optionalConsultez les PlaceSearchElement.truncationPreferred. |
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");
Méthodes | |
|---|---|
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");
Constructeur | |
|---|---|
AdvancedPlaceSearchElement |
AdvancedPlaceSearchElement([options])Paramètres :
|
Propriétés | |
|---|---|
attributionPosition
attr: attribution-position |
Type d'entrée :
PlaceSearchAttributionPosition optionalType de sortie : PlaceSearchAttributionPositionPar défaut :
PlaceSearchAttributionPosition.TOPPosition du logo d'attribution et du bouton de divulgation réglementaire.
Attribut HTML : attribution-position="value-name" |
internalUsageAttributionIds
attr: internal-usage-attribution-ids |
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 |
Par défaut :
PlaceSearchOrientation.VERTICALVariante d'orientation (verticale ou horizontale) de l'élément.
Attribut HTML : orientation="value-name" |
selectable
attr: selectable |
Type d'entrée :
boolean optionalType de sortie : booleanPar défaut :
falseIndique 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 optionalType de sortie : booleanPar défaut :
falseSi 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
| |
Emplacements | |
|---|---|
details-item |
Modèle HTML contenant les widgets gmp-place à afficher pour chaque lieu dans les résultats de recherche. |
Propriétés CSS | |
|---|---|
--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. |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Événements | |
|---|---|
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.
Propriétés | |
|---|---|
attributionPosition
facultatif |
Type :
PlaceSearchAttributionPosition optionalConsultez les PlaceSearchElement.attributionPosition. |
internalUsageAttributionIds
facultatif |
Type :
Iterable<string> optionalIdentifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques. |
orientation
facultatif |
Type :
PlaceSearchOrientation optionalConsultez les PlaceSearchElement.orientation. |
selectable
facultatif |
Type :
boolean optionalVoir les PlaceSearchElement.selectable |
truncationPreferred
facultatif |
Type :
boolean optionalConsultez les PlaceSearchElement.truncationPreferred. |
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");
Constructeur | |
|---|---|
AdvancedPlaceListElement |
AdvancedPlaceListElement([options])Paramètres :
|
Propriétés | |
|---|---|
attributionPosition
attr: attribution-position |
Type d'entrée :
PlaceSearchAttributionPosition optionalType de sortie : PlaceSearchAttributionPositionPar défaut :
PlaceSearchAttributionPosition.TOPPosition du logo d'attribution et du bouton de divulgation réglementaire.
Attribut HTML : attribution-position="value-name" |
internalUsageAttributionIds
attr: internal-usage-attribution-ids |
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 |
Par défaut :
PlaceSearchOrientation.VERTICALVariante d'orientation (verticale ou horizontale) de l'élément.
Attribut HTML : orientation="value-name" |
places
attr: places |
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 optionalType de sortie : booleanPar défaut :
falseIndique 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 optionalType de sortie : booleanPar défaut :
falseSi 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 |
Emplacements | |
|---|---|
details-item |
Modèle HTML contenant les widgets gmp-place à afficher pour chaque lieu de la liste. |
Propriétés CSS | |
|---|---|
--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. |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Événements | |
|---|---|
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.
Propriétés | |
|---|---|
attributionPosition
facultatif |
Type :
PlaceSearchAttributionPosition optionalConsultez les PlaceSearchElement.attributionPosition. |
internalUsageAttributionIds
facultatif |
Type :
Iterable<string> optionalIdentifiants utilisés pour attribuer les appels à des packages ou des bibliothèques OSS spécifiques. |
orientation
facultatif |
Type :
PlaceSearchOrientation optionalConsultez les PlaceSearchElement.orientation. |
places
facultatif |
Consultez les AdvancedPlaceListElement.places. |
selectable
facultatif |
Type :
boolean optionalVoir les PlaceSearchElement.selectable |
truncationPreferred
facultatif |
Type :
boolean optionalConsultez les PlaceSearchElement.truncationPreferred. |
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");
Emplacements | |
|---|---|
|
Emplacement pour le contenu HTML personnalisé affiché en bas de la section des informations de base, juste en dessous des boutons d'action principaux. |
|
Emplacement pour le contenu HTML personnalisé affiché dans la section des informations de base, directement au-dessus du nom du lieu. |
Méthodes | |
|---|---|
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");
Constantes | |
|---|---|
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");
Constantes | |
|---|---|
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");
Propriétés | |
|---|---|
place
readonly |
Type :
PlaceLe 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");
Constructeur | |
|---|---|
PlaceNearbySearchRequestElement |
PlaceNearbySearchRequestElement([options])Paramètres :
|
Propriétés | |
|---|---|
excludedPrimaryTypes
attr: excluded-primary-types |
Par défaut :
nullTypes de lieux principaux exclus.
Attribut HTML : excluded-primary-types="excluded-primary-type1 excluded-primary-type2..." |
excludedTypes
attr: excluded-types |
Par défaut :
nullTypes de lieux exclus.
Attribut HTML : excluded-types="excluded-type1 excluded-type2..." |
futureOpeningBusinessesIncluded |
Type d'entrée :
boolean optionalType de sortie : boolean optionalIncluez 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 |
Par défaut :
nullType de lieu principal inclus.
Attribut HTML : included-primary-types="included-primary-type1 included-primary-type2..." |
includedTypes
attr: included-types |
Par défaut :
nullType de lieu inclus.
Attribut HTML : included-types="included-type1 included-type2..." |
locationRestriction
attr: location-restriction |
Par défaut :
nullRé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 optionalType de sortie : number optionalPar défaut :
nullNombre maximal de résultats à renvoyer.
Attribut HTML : max-result-count="number" |
rankPreference
attr: rank-preference |
Type d'entrée :
SearchNearbyRankPreference optionalType de sortie : SearchNearbyRankPreference optionalPar défaut :
nullComment les résultats seront classés dans la réponse.
Attribut HTML : rank-preference="value-name" |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
PlaceNearbySearchRequestElementOptions
interface
google.maps.places.PlaceNearbySearchRequestElementOptions
implémentée par PlaceNearbySearchRequestElement
Options pour PlaceNearbySearchRequestElement.
Propriétés | |
|---|---|
excludedPrimaryTypes
facultatif |
Type :
Array<string> optionalTypes de lieux principaux exclus. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.excludedPrimaryTypes et SearchNearbyRequest.excludedPrimaryTypes. |
excludedTypes
facultatif |
Type :
Array<string> optionalTypes de lieux exclus. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.excludedTypes et SearchNearbyRequest.excludedTypes. |
futureOpeningBusinessesIncluded
facultatif |
Type :
boolean optionalIncluez 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> optionalTypes de lieux principaux inclus. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.includedPrimaryTypes et SearchNearbyRequest.includedPrimaryTypes. |
includedTypes
facultatif |
Type :
Array<string> optionalTypes de lieux inclus. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.includedTypes et SearchNearbyRequest.includedTypes. |
locationRestriction
facultatif |
Type :
Circle|CircleLiteral optionalRégion dans laquelle effectuer la recherche. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.locationRestriction et SearchNearbyRequest.locationRestriction. |
maxResultCount
facultatif |
Type :
number optionalNombre maximal de résultats à renvoyer. Pour en savoir plus, consultez PlaceNearbySearchRequestElement.maxResultCount et SearchNearbyRequest.maxResultCount. |
rankPreference
facultatif |
Type :
SearchNearbyRankPreference optionalComment 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");
Constructeur | |
|---|---|
PlaceTextSearchRequestElement |
PlaceTextSearchRequestElement([options])Paramètres :
|
Propriétés | |
|---|---|
evConnectorTypes
attr: ev-connector-types |
Par défaut :
nullListe 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 optionalType de sortie : number optionalPar défaut :
nullVitesse de recharge minimale requise en kilowatts.
Attribut HTML : ev-minimum-charging-rate-kw="number" |
futureOpeningBusinessesIncluded |
Type d'entrée :
boolean optionalType de sortie : boolean optionalIncluez 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 optionalType de sortie : string optionalPar défaut :
nullType de lieu demandé.
Attribut HTML : included-type="type" |
isOpenNow
attr: is-open-now |
Type d'entrée :
boolean optionalType de sortie : boolean optionalPar défaut :
nullPermet de limiter la recherche aux lieux qui sont actuellement ouverts.
Attribut HTML : is-open-now |
locationBias
attr: location-bias |
Type d'entrée :
LocationBias optionalType de sortie : LatLngAltitude|LatLngBounds|Circle|string optionalPar défaut :
nullBiais de localisation pour la recherche.
Attribut HTML :
|
locationRestriction
attr: location-restriction |
Par défaut :
nullRestriction 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 optionalType de sortie : number optionalPar défaut :
nullNombre maximal de résultats à renvoyer.
Attribut HTML : max-result-count="number" |
minRating
attr: min-rating |
Type d'entrée :
number optionalType de sortie : number optionalPar défaut :
nullExcluez les résultats dont la note moyenne des utilisateurs est strictement inférieure à cette limite.
Attribut HTML : min-rating="number" |
priceLevels
attr: price-levels |
Par défaut :
nullPermet 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 optionalType de sortie : SearchByTextRankPreference optionalPar défaut :
nullComment 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 optionalType de sortie : string optionalPar défaut :
nullRequête textuelle pour la recherche textuelle.
Attribut HTML : text-query="string" |
useStrictTypeFiltering
attr: use-strict-type-filtering |
Type d'entrée :
boolean optionalType de sortie : boolean optionalPar défaut :
nullPermet de définir un filtrage de type strict pour "includedType".
Attribut HTML : use-strict-type-filtering |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
PlaceTextSearchRequestElementOptions interface
interface
google.maps.places.PlaceTextSearchRequestElementOptions
implémentée par PlaceTextSearchRequestElement
Options pour PlaceTextSearchRequestElement.
Propriétés | |
|---|---|
evConnectorTypes
facultatif |
Type :
Array<EVConnectorType> optionalListe des types de connecteurs de VE préférés. Pour en savoir plus, consultez SearchByTextRequest.evSearchOptions et PlaceTextSearchRequestElement.evConnectorTypes. |
evMinimumChargingRateKw
facultatif |
Type :
number optionalVitesse de recharge minimale requise en kilowatts. Pour en savoir plus, consultez SearchByTextRequest.evSearchOptions et PlaceTextSearchRequestElement.evMinimumChargingRateKw. |
futureOpeningBusinessesIncluded
facultatif |
Type :
boolean optionalIncluez 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 optionalType de lieu demandé. Pour en savoir plus, consultez SearchByTextRequest.includedType et PlaceTextSearchRequestElement.includedType. |
isOpenNow
facultatif |
Type :
boolean optionalPermet de limiter la recherche aux lieux qui sont actuellement ouverts. Pour en savoir plus, consultez SearchByTextRequest.isOpenNow et PlaceTextSearchRequestElement.isOpenNow. |
locationBias
facultatif |
Type :
LocationBias optionalBiais de localisation pour la recherche. Pour en savoir plus, consultez SearchByTextRequest.locationBias et PlaceTextSearchRequestElement.locationBias. |
locationRestriction
facultatif |
Type :
LatLngBounds|LatLngBoundsLiteral optionalRestriction de l'emplacement pour la recherche. Pour en savoir plus, consultez SearchByTextRequest.locationRestriction et PlaceTextSearchRequestElement.locationRestriction. |
maxResultCount
facultatif |
Type :
number optionalNombre maximal de résultats à renvoyer. Pour en savoir plus, consultez SearchByTextRequest.maxResultCount et PlaceTextSearchRequestElement.maxResultCount. |
minRating
facultatif |
Type :
number optionalExcluez 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> optionalPermet 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 |
Type :
SearchByTextRankPreference optionalComment les résultats seront classés dans la réponse. Pour en savoir plus, consultez SearchByTextRequest.rankPreference et PlaceTextSearchRequestElement.rankPreference. |
textQuery
facultatif |
Type :
string optionalRequête textuelle pour la recherche textuelle. Pour en savoir plus, consultez SearchByTextRequest.textQuery et PlaceTextSearchRequestElement.textQuery. |
useStrictTypeFiltering
facultatif |
Type :
boolean optionalPermet 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");
Constructeur | |
|---|---|
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. |
Méthodes | |
|---|---|
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>|undefinedRenvoie 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 :
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 :
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
| |
Événements | |
|---|---|
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.
Propriétés | |
|---|---|
bounds
facultatif |
Type :
LatLngBounds|LatLngBoundsLiteral optionalZone dans laquelle rechercher des lieux. |
componentRestrictions
facultatif |
Type :
ComponentRestrictions optionalRestrictions 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> optionalChamps à 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']. |
facultatif |
Type :
boolean optionalIndique 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 optionalValeur 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> optionalTypes 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. |
Classe SearchBox
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");
Constructeur | |
|---|---|
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. |
Méthodes | |
|---|---|
getBounds |
getBounds()Paramètres : aucun
Valeur renvoyée :
LatLngBounds|undefinedRenvoie les limites vers lesquelles les prédictions de requête sont biaisées. |
getPlaces |
getPlaces()Paramètres : aucun
Valeur renvoyée :
Array<PlaceResult>|undefinedRenvoie 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
| |
Événements | |
|---|---|
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.
Propriétés | |
|---|---|
bounds
facultatif |
Type :
LatLngBounds|LatLngBoundsLiteral optionalZone 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");
Constructeur | |
|---|---|
PlaceContextualElement |
PlaceContextualElement([options])Paramètres :
|
Propriétés | |
|---|---|
contextToken
attr: context-token |
Type d'entrée :
string optionalType de sortie : string optionalJeton de contexte.
Attribut HTML : context-token="string" |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Interface PlaceContextualElementOptions
interface
google.maps.places.PlaceContextualElementOptions
implémentée par PlaceContextualElement
Options pour PlaceContextualElement.
Propriétés | |
|---|---|
contextToken
facultatif |
Type :
string optionalJeton 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");
Constructeur | |
|---|---|
PlaceContextualListConfigElement |
PlaceContextualListConfigElement([options])Paramètres :
|
Propriétés | |
|---|---|
layout
attr: layout |
La mise en page.
Attribut HTML : layout="value-name" |
mapHidden
attr: map-hidden |
Type d'entrée :
boolean optionalType de sortie : booleanIndique si la carte est masquée.
Attribut HTML : map-hidden |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
PlaceContextualListConfigElementOptions
interface
google.maps.places.PlaceContextualListConfigElementOptions
implémentée par PlaceContextualListConfigElement
Options pour PlaceContextualListConfigElement.
Propriétés | |
|---|---|
layout
facultatif |
Type :
PlaceContextualListLayout optionalPar défaut :
PlaceContextualListLayout.VERTICALLa mise en page. |
mapHidden
facultatif |
Type :
boolean optionalPar 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");
Constantes | |
|---|---|
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");
Constructeur | |
|---|---|
PlacePinElement |
PlacePinElement([options])Paramètres :
|
Propriétés | |
|---|---|
icon
attr: icon |
Par défaut :
PlacePinIcon.TYPEIcône affichée dans le repère. Consultez les
PlacePinIcon.Attribut HTML : icon="value-name" |
photoRendered
readonly |
Type :
booleanLecture 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 optionalLecture 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 optionalType de sortie : numberPar défaut :
1Multiplicateur de taille pour le repère.
Attribut HTML : scale="number" |
Emplacements | |
|---|---|
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. |
Propriétés CSS | |
|---|---|
--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. |
Méthodes | |
|---|---|
Hérité :
addEventListener,
removeEventListener
|
Événements | |
|---|---|
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.
Propriétés | |
|---|---|
icon
facultatif |
Type :
PlacePinIcon optionalConsultez les PlacePinElement.icon. |
scale
facultatif |
Type :
number optionalConsultez 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");
Constantes | |
|---|---|
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. |