Gebruik het besturingselement Adresinvoer om eenvoudig adressen in te voeren
Het invoeren van adressen kan frustrerend en foutgevoelig zijn, vooral in mobiele apps. Gebruik het besturingselement Adresinvoer om het invoeren van adressen te vereenvoudigen. Het besturingselement gebruikt fuzzy logic om mogelijke overeenkomsten voor te stellen terwijl u typt. Selecteer de gewenste suggestie om snel en gemakkelijk een correct adres in te voeren.
Het besturingselement retourneert het adres als gestructureerde gegevens. Uw app kan informatie extraheren zoals stad, straat, gemeente en zelfs breedte- en lengtecoördinaten. De gegevens hebben een indeling die geschikt is voor veel land- of regioinstellingen en internationale adresindelingen.
Vereisten
Voordat u het besturingselement kunt gebruiken, moet u georuimtelijke functies voor de omgeving inschakelen. Zorg ervoor dat u ook de vereisten voor het gebruik van georuimtelijke besturingselementen bekijkt. Verwijs naar de privacy- en beveiligingstabel voor meer informatie over het gegevensgebruik van het besturingselement Adresinvoer.
Een besturingselement Adresinvoer toevoegen aan uw app
Doe het volgende terwijl uw app voor bewerken is geopend in Power Apps Studio:
- Open het tabblad Invoegen en vouw Invoer uit.
- Selecteer Adresinvoer om een adresinvoervak in het app-scherm te plaatsen of sleep het besturingselement naar het scherm om het nauwkeuriger te plaatsen. U moet ten minste drie tekens inclusief één cijfer invoeren voor het besturingselement Adresinvoer.
Een standaardzoekstraal instellen
Standaard zoekt het besturingselement rond de locatie van de gebruiker. U kunt het standaardzoekgebied verfijnen om de eerste resultaten te beperken.
- Op het tabblad Eigenschappen van het adresinvoerbesturingselement zet u de eigenschap Zoeken in straal aan.
- Voer een lengtegraad, breedtegraad en straal (in meters) in.
Het besturingselement begint te zoeken op de opgegeven breedte- en lengtegraad, tot aan de afstand die is opgegeven in het straalveld.
Het map-besturingselement gebruiken met het besturingselement Adresinvoer
U kunt een knop aan uw app toevoegen om ingevoerde adressen op te slaan als gegevensverzameling. U kunt deze adressen vervolgens ophalen en weergeven in het map-besturingselement.
Voeg een map-besturingselement en een besturingselement Adresinvoer toe aan uw app.
Voeg een Knop-besturingselement in en plaats het.
Wijzig de eigenschap OnSelect van het button-besturingselement als volgt. (Hint: kopieer de formule en plak deze in de formulebalk of op het eigenschappentabblad Geavanceerd, wat u maar wilt.) =======
Voer een lengtegraad, breedtegraad en straal in (in meters).
Het besturingselement begint te zoeken op de breedte- en lengtegraad, tot aan de afstand die is opgegeven in het straalveld.
If(IsBlank(AddressInput1.SearchResultJson), "", Collect(locations, {Latitude: AddressInput1.SelectedLatitude, Longitude: AddressInput1.SelectedLongitude}))De formule slaat de huidige lengte- en breedtegraad op in een collectie met de naam locations, zolang de zoekresultaten niet leeg zijn.
Selecteer het map-besturingselement. Wijzig de eigenschappen als volgt:
Eigenschapsnaam Weergegeven als Waar Items "Locaties" Tabblad Eigenschappen ItemsLatitudes "Breedtegraad" Tabblad Geavanceerd ItemsLongitudes "Lengtegraad" Tabblad Geavanceerd
Wanneer een gebruiker de knop selecteert, wordt het resultaat van het besturingselement Adresinvoer als een nieuwe speld aan de kaart toegevoegd.
Eigenschappen
Wijzig het gedrag en het uiterlijk van een besturingselement Adresinvoer met behulp van eigenschappen. Sommige eigenschappen zijn alleen beschikbaar op het tabblad Geavanceerd.
| Eigenschap | Omschrijving | Type | Tab |
|---|---|---|---|
| Default | Hiermee stelt u de initiële waarde van het besturingselement in. | String | Eigenschappen; Geavanceerd: Default |
| Tekst van hint | Stelt de hint in die in het besturingselement verschijnt voordat de gebruiker tekst invoert. | String | Eigenschappen: Geavanceerd: HintText |
| Lettertype | Stelt de naam in van de lettertypefamilie die wordt gebruikt voor de tekst van het besturingselement. | Vervolgkeuzelijst | Eigenschappen; Geavanceerd: Font |
| Tekengrootte | Hiermee stelt u de grootte in van de tekst van het besturingselement. | Drijvende-kommagetal | Eigenschappen; Geavanceerd: FontSize |
| Tekengewicht | Hiermee stelt u het tekengewicht van de tekst in het besturingselement in: Vet, Lichter, Normaal of Halfvet. | Vervolgkeuzelijst | Eigenschappen; Geavanceerd: FontWeight |
| Tekstuitlijning | Stelt de horizontale uitlijning van de tekst in het besturingselement in: Gecentreerd, Uitvullen, Links of Rechts. | Vervolgkeuzelijst | Eigenschappen; Geavanceerd: TextAlignment |
| Regelhoogte | Stelt de verticale afstand tussen tekstregels in het besturingselement in. | Drijvende-kommagetal | Eigenschappen; Geavanceerd: LineHeight |
| Weergavemodus | Bepaalt of invoer van de gebruiker is toegestaan (Bewerken), of gegevens alleen worden weergegeven (Weergeven) of het besturingselement wordt uitgeschakeld (Uitgeschakeld). | Vervolgkeuzelijst | Eigenschappen; Geavanceerd: DisplayMode |
| Tekenstijl | Stelt de stijl van de van de tekst van het besturingselement in: Cursief, Onderstrepen, Doorhalen of geen. | Vervolgkeuzelijst | Eigenschappen; Geavanceerd: Italic, Underline, Strikethrough |
| Limiet voor zoekresultaten | Stelt het aantal voorgestelde adressen in dat in het besturingselement wordt weergegeven. | Integer | Eigenschappen; Geavanceerd: SearchResultLimit |
| Zoeken in straal | Bepaalt of het besturingselement adressen voorstelt binnen de Straal van de Breedtegraad en Lengtegraad. | Booleaans | Eigenschappen; Geavanceerd: SearchWithinRadius |
| Breedtegraad | Stelt de breedtegraadcoördinaat in van het middelpunt dat wordt gebruikt voor suggesties voor adressen. Vereist dat Zoeken binnen straal is ingeschakeld. | Drijvendekommagetal van -90 tot 90 | Eigenschappen; Geavanceerd: Latitude |
| Lengtegraad | Stelt de lengtegraadcoördinaat in van het middelpunt dat wordt gebruikt voor suggesties voor adressen. Vereist dat Zoeken binnen straal is ingeschakeld. | Drijvendekommagetal van -180 tot 180 | Eigenschappen; Geavanceerd: Longitude |
| Straal | Stelt de straal, in meters, rond Breedtegraad en Lengtegraad in om de adressuggesties te beperken. Vereist dat Zoeken binnen straal is ingeschakeld. | Drijvende-kommagetal | Eigenschappen; Geavanceerd: Radius |
| Taal | Stelt de taal in waarin de adressuggesties worden geretourneerd. | String | Eigenschappen; Geavanceerd: Language |
| Ingesteld land/ingestelde regio | Geeft een door komma's gescheiden lijst aan van landen/regio's waartoe adressuggesties moeten worden beperkt, in ISO 3166 alfa-2-indeling; bijvoorbeeld, VS, CA, MX. | String | Eigenschappen; Geavanceerd: CountrySet |
| Zichtbaar | Hiermee wordt het besturingselement weergegeven of verborgen. | Booleaans | Eigenschappen; Geavanceerd: Visible |
| Opvulling boven | Stelt de afstand in tussen de besturingselementtekst en de bovenkant van het besturingselement. | Drijvende-kommagetal | Eigenschappen; Geavanceerd: PaddingTop |
| Opvulling onder | Stelt de afstand in tussen de besturingselementtekst en de onderkant van het besturingselement. | Drijvende-kommagetal | Eigenschappen; Geavanceerd: PaddingBottom |
| Opvulling links | Stelt de afstand in tussen de besturingselementtekst en de linkerrand van het besturingselement. | Drijvende-kommagetal | Eigenschappen; Geavanceerd: PaddingLeft |
| Opvulling rechts | Stelt de afstand in tussen de besturingselementtekst en de rechterrand van het besturingselement. | Drijvende-kommagetal | Eigenschappen; Geavanceerd: PaddingRight |
| Positie | Hiermee wordt de linkerbovenhoek van het besturingselement op de schermcoördinaten opgegeven in X en Y geplaatst. | Integer | Eigenschappen: Geavanceerd: X, Y |
| Omvang | Hiermee wordt de grootte van het besturingselement bepaald op basis van de pixelwaarden die zijn opgegeven bij Breedte en Hoogte. | Integer | Eigenschappen; Geavanceerd: Width, Height |
| Randradius | Bepaalt de hoekradius van de besturingselementrand. | Drijvende-kommagetal | Eigenschappen; Geavanceerd: BorderRadius |
| Color | Stelt de kleuren in van de besturingselementtekst en de besturingselementachtergrond. | Niet van toepassing | Eigenschappen; Geavanceerd: FillColor, TextColor |
| Rand | Bepaalt de stijl, breedte en kleur van de besturingselementrand. | Niet van toepassing | Eigenschappen; Geavanceerd: BorderStyle, BorderThickness, BorderColor |
| Tabbladindex | Hiermee wordt de volgorde opgegeven waarin het besturingselement wordt geselecteerd als de gebruiker door de app navigeert met de Tab-toets. | Integer | Eigenschappen; Geavanceerd: TabIndex |
| Knopinfo | Hiermee wordt bepaald welke tekst moet worden weergegeven wanneer de gebruiker de muisaanwijzer boven het besturingselement houdt. | String | Eigenschappen: Geavanceerd: Tooltip |
| Kleur bij aanwijzen | Stelt de kleuren van de besturingselementtekst, de besturingselementachtergrond en de besturingselementrand in als de gebruiker de muisaanwijzer erboven houdt. | Niet van toepassing | Eigenschappen; Geavanceerd: HoverFontColor, HoverFillColor, HoverBorderColor |
| Kleur bij uitschakeling | Stelt de kleuren van de besturingselementtekst, de besturingselementachtergrond en de besturingselementrand in als DisplayMode Uitgeschakeld is. | Niet van toepassing | Eigenschappen; Geavanceerd: DisabledFontColor, DisabledFillColor, DisabledBorderColor |
| Kleur bij indrukken | Stelt de kleuren van de besturingselementtekst, de besturingselementachtergrond en de besturingselementrand in als de gebruiker het besturingselement selecteert. | Niet van toepassing | Eigenschappen; Geavanceerd: PressedFontColor, PressedFillColor, PressedBorderColor |
| ContentLanguage | Bepaalt de weergavetaal van het besturingselement, als deze afwijkt van de taal die in de app wordt gebruikt. | String | Geavanceerd |
| OnAddressSelect | Bevat code die wordt uitgevoerd wanneer de gebruiker een voorgesteld adres selecteert. | Gebeurtenis | Geavanceerd |
| OnChange | Bevat code die wordt uitgevoerd wanneer een besturingselementeigenschap wordt gewijzigd. | Gebeurtenis | Geavanceerd |
Uitvoereigenschappen
Andere eigenschappen worden beschikbaar wanneer een gebruiker met het besturingselement Adresinvoer werkt. U kunt deze uitvoereigenschappen gebruiken in andere besturingselementen of om de app-ervaring aan te passen.
| Eigenschap | Omschrijving |
|---|---|
| UserInput | De tekst die de gebruiker heeft getypt in het invoervak |
| SelectedLatitude | De breedtegraad van het door de gebruiker geselecteerde adres |
| SelectedLongitude | De lengtegraad van het door de gebruiker geselecteerde adres |
| SearchResultJson | Het zoekresultaat op basis van de eigenschap UserInput, weergegeven als een tekenreeks in de JSON-indeling |
| FreeformAddress | Door de gebruiker geselecteerd adres uit de lijst met voorgestelde adressen |
| LocalName | De naam van een geografisch gebied of een plaats die een aantal adresseerbare objecten groepeert voor adresseringsdoeleinden, zonder een administratieve eenheid te zijn |
| PostalCode | De postcode |
| ExtendedPostalCode | De uitgebreide postcode |
| CountryCode | Het land-/regionummer |
| Country | De naam van het land/de regio |
| CountryCodeISO3 | Het land-/regionummer in ISO alpha-3-indeling |
| CountrySubdivisionName | De naam van onderverdeling van landen/regio's |
| StreetName | De straatnaam |
| StreetNumber | Het straatnummer |
| Gemeente | De gemeente |
| MunicipalitySubdivision | De onderverdeling van gemeentes |
| CountryTertiarySubdivision | De tertiaire onderverdeling van landen/regio's |
| CountrySecondarySubdivision | De secundaire onderverdeling van landen/regio's |
| CountrySubdivision | De onderverdeling van landen/regio's |
Andere georuimtelijke besturingselementen
Gebruik het besturingselement interactive map om locatiegegevens te visualiseren en te interpreteren.
Notitie
Laat ons uw taalvoorkeuren voor documentatie weten! Beantwoord een korte enquête. (houd er rekening mee dat deze in het Engels is)
De enquête duurt ongeveer zeven minuten. Er worden geen persoonlijke gegevens verzameld (privacyverklaring).
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor