Partager via


Utiliser le contrôle Saisie d’adresse pour saisir facilement des adresses

La saisie d’adresses peut être fastidieuse et source d’erreurs, en particulier dans les applications mobiles. Utiliser le contrôle Saisie d’adresse pour simplifier la saisie des adresses. Le contrôle utilise une logique approximative pour suggérer des correspondances potentielles au fur et à mesure que vous tapez. Sélectionnez celle que vous souhaitez pour saisir rapidement et facilement une adresse précise.

Le contrôle renvoie l’adresse sous forme de données structurées. Votre application peut extraire des informations telles que la ville, la rue, la municipalité et même les coordonnées de latitude et de longitude. Les données sont dans un format adapté à de nombreux paramètres régionaux et formats d’adresses internationaux.

Conditions préalables

Avant de pouvoir utiliser le contrôle dans vos applications, vous devez activer les fonctionnalités géospatiales pour l’environnement. Assurez-vous également que vous passez en revue les conditions préalables à l’utilisation des contrôles géospatiaux. Se référer à la table de confidentialité et de sécurité pour plus de détails sur l’utilisation des données du contrôle d’entrée d’adresse.

Ajouter un contrôle Saisie d’adresse à votre application

Ouvrez votre application en mode édition dans Power Apps Studio:

  1. Ouvrez l’onglet Insérer et développez Entrée.
  2. Sélectionnez Saisie d’adresse pour placer une zone de saisie d’adresse dans l’écran de l’application ou faites-le glisser pour le positionner avec plus de précision. Vous devez saisir au moins trois caractères dont un chiffre pour le contrôle Saisie d’adresse.

Définir un rayon de recherche par défaut

Par défaut, le contrôle recherchera autour de l’emplacement de l’utilisateur. Vous pouvez affiner la zone de recherche par défaut pour affiner les premiers résultats.

  1. Sur l’onglet Propriétés du contrôle Saisie d’adresse, activez la propriété Search within radius.
  2. Saisissez une longitude, une latitude et un rayon en mètres.

Le contrôle commencera à chercher à la latitude et à la longitude, jusqu’à la distance spécifiée.

Utiliser le contrôle Carte avec le contrôle Saisie d’adresse

Vous pouvez ajouter un bouton à votre application pour enregistrer les adresses saisies en tant que collecte de données. Puis, vous pouvez récupérer les adresses et les afficher dans le contrôle Carte.

  1. Ajoutez un contrôle Carte et un contrôle Saisie d’adresse à votre application.

  2. Insérez et placez un contrôle Bouton.

  3. Modifiez la propriété OnSelect du contrôle Bouton comme suit. (Astuce : Copiez la formule et collez-la dans la barre de formule ou sur l’onglet des propriétés Avancées, celui que vous préférez.)

  4. Saisissez une longitude, une latitude et un rayon (en mètres).

    Le contrôle commencera à chercher à la latitude et à la longitude, jusqu’à la distance spécifiée dans le champ de rayon.

    If(IsBlank(AddressInput1.SearchResultJson), "", Collect(locations, {Latitude: AddressInput1.SelectedLatitude, Longitude: AddressInput1.SelectedLongitude}))
    

    La formule enregistre la latitude et la longitude actuelles dans une collection nommée emplacements, tant que les résultats de la recherche ne sont pas vides.

    Une capture d’écran d’un contrôle de bouton en cours de construction dans Power Apps Studio, avec un flux ajouté à la propriété OnSelect du contrôle.

  5. Sélectionnez le contrôle Carte. Définissez ses propriétés comme suit :

    Nom de la propriété Valeur Where
    Items « Emplacements » Onglet Propriétés
    ItemsLatitudes « Latitude » Onglet Avancé
    ItemsLongitudes « Longitude » Onglet Avancé

Lorsque l’utilisateur sélectionne le bouton, le résultat du contrôle Saisie d’adresse est ajouté à la carte en tant que nouvelle épingle.

Propriétés

Modifiez le comportement et l’apparence du contrôle Saisie d’adresse à l’aide des propriétés. Certaines propriétés ne sont disponibles que sur l’onglet Avancé.

Propriété Description Type Onglet
Default Définit la valeur initiale du contrôle. Chaîne Propriétés ; Avancé : Default
Hint text Définit le conseil qui s’affiche dans le contrôle avant que l’utilisateur n’entre du texte. Chaîne Propriétés ; Avancé : HintText
Font Définit le nom de la famille de polices utilisées pour le texte de contrôle. Liste déroulante Propriétés ; Avancé : Font
Taille de police Définit la taille du texte de contrôle. Nombre à virgule flottante Propriétés ; Avancé : FontSize
Font weight Définit la largeur du texte de contrôle, soit Bold, Lighter, Normal ou Semibold. Liste déroulante Propriétés ; Avancé : FontWeight
Alignement de texte Définit l’alignement horizontal du texte de contrôle, soit Center, Justify, Left, ou Right. Liste déroulante Propriétés ; Avancé : TextAlignment
Line height Définit la distance verticale entre les lignes de texte dans le contrôle. Nombre à virgule flottante Propriétés ; Avancé : LineHeight
Display mode Détermine si le contrôle autorise la saisie par l’utilisateur (Edit), affiche uniquement les données (View) ou est désactivé (Disabled). Liste déroulante Propriétés ; Avancé : DisplayMode
Font style Définit le style du texte du contrôle, soit Italic, Underline, Barré, ou aucun. Liste déroulante Propriétés ; Avancé : Italic, Underline, Barré
Search result limit Définit le nombre d’adresses suggérées que le contrôle affiche. Entier Propriétés ; Avancé : SearchResultLimit
Search within radius Détermine si le contrôle doit suggérer des adresses dans le Rayon de la Latitude et de la Longitude. Booléen Propriétés ; Avancé : SearchWithinRadius
Latitude Définit les coordonnées de latitude du point central utilisée pour les suggestions d’adresses. A besoin que la propriété Search within radius soit activée. Nombre à virgule flottante de -90 à 90 Propriétés ; Avancé : Latitude
Longitude Définit les coordonnées de longitude du point central utilisée pour les suggestions d’adresses. A besoin que la propriété Search within radius soit activée. Nombre à virgule flottante de -180 à 180 Propriétés ; Avancé : Longitude
Radius Définit le rayon, en mètres, autour des valeurs Latitude et Longitude pour limiter les suggestions d’adresses. A besoin que la propriété Search within radius soit activée. Nombre à virgule flottante Propriétés ; Avancé : Radius
Language Définit la langue dans laquelle les suggestions d’adresses sont retournées. Chaîne Propriétés ; Avancé : Language
Country set Identifie une liste de pays/régions séparés par des virgules auxquels limiter les suggestions d’adresses, au format ISO 3166 alpha-2 ; par exemple, US,CA,MX. Chaîne Propriétés ; Avancé : CountrySet
Visible Affiche ou masque le contrôle. Entier Propriétés ; Avancé : Visible
Padding top Définit la distance entre le texte du contrôle et le haut du contrôle. Nombre à virgule flottante Propriétés ; Avancé : PaddingTop
Padding bottom Définit la distance entre le texte du contrôle et le bas du contrôle. Nombre à virgule flottante Propriétés ; Avancé : PaddingBottom
Padding left Définit la distance entre le texte du contrôle et le bord gauche du contrôle. Nombre à virgule flottante Propriétés ; Avancé : PaddingLeft
Padding right Définit la distance entre le texte du contrôle et le bord droit du contrôle. Nombre à virgule flottante Propriétés ; Avancé : PaddingRight
Position Place le coin supérieur gauche du contrôle en fonction des coordonnées d’écran spécifiées dans X et Y. Entier Propriétés ; Avancé : X, Y
Size Détermine la taille du contrôle à l’aide des valeurs de pixel fournies dans Largeur et Hauteur. Entier Propriétés ; Avancé : Width, Height
Border radius Détermine le rayon d’angle de la bordure du contrôle. Nombre à virgule flottante Propriétés ; Avancé : BorderRadius
Color Définit les couleurs du texte du contrôle et l’arrière-plan du contrôle. Non applicable Propriétés ; Avancé : FillColor, TextColor
Border Détermine le style, la largeur et la couleur de la bordure du contrôle. Non applicable Propriétés ; Avancé : BorderStyle, BorderThickness, BorderColor
Tab index Spécifie l’ordre dans lequel le contrôle est sélectionné si l’utilisateur navigue dans l’application à l’aide de la touche Tab. Entier Propriétés ; Avancé : TabIndex
Info-bulle Détermine le texte à afficher lorsque l’utilisateur survole le contrôle. Chaîne Propriétés ; Avancé : Info-bulle
Hover color Définit les couleurs du texte du contrôle, de l’arrière-plan du contrôle et de la bordure du contrôle lorsque l’utilisateur le survole avec le curseur de la souris. Non applicable Propriétés ; Avancé : HoverFontColor, HoverFillColor, HoverBorderColor
Disabled color Définit les couleurs du texte du contrôle, de l’arrière-plan du contrôle et de la bordure du contrôle si DisplayMode est Disabled. Non applicable Propriétés ; Avancé : DisabledFontColor, DisabledFillColor, DisabledBorderColor
Pressed color Définit les couleurs du texte du contrôle, de l’arrière-plan du contrôle et de la bordure du contrôle lorsque l’utilisateur le sélectionne. Non applicable Propriétés ; Avancé : PressedFontColor, PressedFillColor, PressedBorderColor
ContentLanguage Détermine la langue d’affichage du champ, si elle est différente de la langue utilisée dans l’application. String Avancé
OnAddressSelect Contient du code qui s’exécute lorsque l’utilisateur sélectionne une adresse suggérée. Événement Avancé
OnChange Contient du code qui s’exécute lorsqu’une propriété de contrôle est modifiée. Événement Avancé

Propriétés de sortie

D’autres propriétés deviennent disponibles lorsqu’un utilisateur interagit avec le contrôle Saisie d’adresse. Vous pouvez utiliser ces output properties dans d’autres contrôles ou pour personnaliser l’expérience de l’application.

Propriété Description
UserInput Texte tapé par l’utilisateur dans la zone d’entrée
SelectedLatitude Latitude de l’adresse sélectionnée par l’utilisateur
SelectedLongitude Longitude de l’adresse sélectionnée par l’utilisateur
SearchResultJson Résultat de la recherche, basé sur UserInput, affiché sous forme de chaîne au format JSON
FreeformAddress Adresse sélectionnée par l’utilisateur dans la liste des adresses suggérées
LocalName Nom d’une zone géographique ou d’une localité qui regroupe plusieurs objets adressables à des fins d’adresse, sans être une unité administrative
PostalCode Code postal
ExtendedPostalCode Code postal étendu
CountryCode Code pays
Country Le nom du pays/de la région
CountryCodeISO3 Code pays de destination au format ISO alpha-3
CountrySubdivisionName Nom de la subdivision du pays/de la région
StreetName Nom de la rue
StreetNumber Numéro de la rue
Municipality Commune
MunicipalitySubdivision Sous-division de commune
CountryTertiarySubdivision Sous-division tertiaire du pays/de la région
CountrySecondarySubdivision Sous-division secondaire du pays/région
CountrySubdivision Sous-division du pays/de la région

Autres contrôles géospatiaux

Pour visualiser et interpréter données d’emplacement, utilisez le contrôle Carte interactive.

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).