Opprette en app med Adresseinndata- og kart-kontroller

Det finnes mange scenarier der brukere forventes å angi adresser i en app. Historisk har det vært flere felt som fanger opp hvert element i en adresse der brukeren oppgir gateadresse, poststed og postnummer, og velger område. Å skrive inn adresser kan være frustrerende og feilutsatt, spesielt i mobilscenarioer.

Adresseinndata-kontrollen presenterer brukeren med dynamiske adresseforslag mens de skriver. Ved hjelp av samsvarslogikk, foreslår kontrollen flere potensielle adressesamsvar som brukeren kan velge fra—som gjør det raskere og enklere å angi nøyaktige adresser.

Kontrollen returnerer adressen som strukturerte data, slik at programmet kan trekke ut informasjon som by, gate, breddegrad og lengdegrad. Dataene er i et format som er brukervennlig for mange nasjonale innstillinger og internasjonale adresseformater.

Hvis du vil bruke kontrollen, må du aktivere geospatiale tjenester for miljøet.

• Se på denne videoen for å lære hvordan du bruker Adresseinndata-kontrollen:

• Se på denne videoen for å lære hvordan du bruker kart-kontrollen:

I denne artikkelen lærer vi hvordan du bruker Adresseinndata-kontrollen i lerretsapper.

Krav

Du trenger et Power Apps miljø med en Microsoft Dataverse database for å kunne fullføre denne leksjonen. Hvis du ikke har en lisens, kan du registrere deg for Power Apps- utviklerplanen eller bruke en Power Apps-prøveversjon.

Opprette et prøvemiljø

Et miljø i Power Apps er et sted der du kan lagre, behandle og dele organisasjonens forretningsdata, apper, chatroboter og flyter. Det fungerer også som en beholder for skille apper som kan ha ulike roller, sikkerhetskrav eller målgrupper.

Hvert miljø kan ha én Dataverse-database.

For å sikre at du har det du trenger for å fullføre denne leksjonen, skal vi opprette et nytt miljø som inkluderer en Dataverse-database. Dette er en 30-dagers prøveversjon som forsvinner i løpet av de 30 dagene, men du kan oppgradere den til et sandkasse- eller produksjonsmiljø hvis du vil beholde den.

Vi skal opprette et prøvemiljø som inkluderer en Dataverse database, og eksempeldataene som brukes i dette emnet.

1. Gå til Power Platform administrasjonssenteret i en webleser.

2. Velg Miljøer.

3. Velg Ny.

4. Angi et navn, for eksempel "Dataverse Prøveversjon".

5. Velg Prøveversjon for miljøtypen.

6. Sett Opprett database til Ja.

7. Velg Neste.

   

8. Sett Distribuer eksempelapper og data til Ja.

9. Velg Lagre.

Prøvemiljøet blir nå opprettet, inkludert en Dataverse database og eksempeldata i Dataverse tabeller.

Aktivere geospatiale tjenester for miljøet

Før vi kan bruke geospatiale tjenester i lerretsapper, må en administrator aktivere tilgang til funksjonene i miljøet der vi vil opprette appen.

Hvis du vil vite hvordan du aktiverer geospatiale tjenester i miljøet, kan du se Aktivere geospatiale funksjoner for miljøet.

Bygg en lerretsapp

Vi begynner med å opprette en app, og deretter oppretter vi en header-kontroll som skal brukes i appen, for å standardisere utseendet og utseendet til hodet på forskjellige skjermer.

1. Opprett en tom lerretsapp i miljøet du opprettet tidligere.

2. Velg Sett inn > Ny skjerm > Kan rulles for å legge til en ny skjerm.

   

3. Endre etiketteksteksten til "Ny forretningsforbindelse".

   

4. Velg Sett inn > Skjemaer > Rediger for å legge til et skjema på skjermen.

   

   Form-kontrollen blir lagt til

   

5. Oppdater følgende egenskaper for skjemaet:

   Egenskap	Verdi
   Datakilde	Forretningsforbindelser
   Kolonner	2
   DefaultMode	FormMode.New

6. Velg Rediger ved siden av felt for å legge til flere felt i skjemaet, og velg følgende adressefelt:

   • Adresse 1: Gate/vei 1
   • Adresse 1: Poststed
   • Delstat 1: for adresse
   • Adresse 1: Postnummer
   • Adresse 1: Land/område
   • Adresse 1: Breddegrad
   • Adresse 1: Lengdegrad

   

7. Juster rekkefølgen på feltene, som vist nedenfor.

   

Adresseinndata-kontroll

I denne delen legger vi til Adresseinndata-kontrollen i appen.

1. Velg Sett inn > Inndata > Adresseinndata for å legge til kontrollen på skjermen.

   

2. Flytt kontrollen øverst på høyre side av skjermen.

   

Konfigurere egenskaper for Adresseinndata-kontrollen

I denne delen vil vi se gjennom og om nødvendig angi forskjellige egenskaper for address-kontrollen. Det finnes noen få Adresseinndata-kontrollspesifikke egenskaper.

Egenskap	Beskrivelse
Search result limit	Antall foreslåtte adresser kontrollen viser. Vi har satt det til 5 i dette eksemplet, så det vises ikke flere enn fem adresser i søket.
Søk i radius	Hvorvidt kontrollen skal foreslå adresser i den brukerdefinerte radiusen for Breddegrad og Lengdegrad. Vi har satt den til Ja i dette eksemplet.
Breddegrad	Breddegraden til senterpunktet som brukes til geografisk vektlegging av adresseforslag. Krever at Søk innen radius er på. Vi har satt den til formelen Location.Latitude i dette eksemplet for å returnere breddegraden til gjeldende plassering.
Lengdegrad	Lengdegraden til senterpunktet som brukes til geografisk vektlegging av adresseforslag. Krever at Søk innen radius er på. Vi har satt den til formelen Location.Longitude i dette eksemplet for å returnere breddegraden til gjeldende plassering.
Radius	Radiusen i meter rundt Breddegrad og Lengdegrad for å begrense adresseforslagene. Krever at Søk innen radius er På. Vi har satt den til 100 000 i dette eksemplet.
Språk	Språket adresseforslagene returneres på. Vi har latt standardinnstillingen være "English (United States)".
Landsett	Kommadelt liste over land/områder for å begrense adresseforslagene til ISO 3166 alfa-2-landskoder. Eksempler: "USA", "FR", "KW". Vi har satt den til US i dette eksemplet.

Konfigurere utdataegenskaper for Adresseinndata-kontrollen

Kontrollen utdata forskjellige egenskaper når en bruker samhandler med den i en app. Du kan bruke disse utdataene i andre kontroller eller til å tilpasse opplevelsen.

Tabellen nedenfor viser de tilgjengelige utdataegenskapene.

Egenskap	Beskrivelse
UserInput	Tekst brukeren har skrevet inn i inndatafeltet.
SelectedLatitude	Breddegrad for den brukervalgte adressen i inndatafeltet.
SelectedLongitude	Lengdegrad for den brukervalgte adressen i inndatafeltet.
SearchResultJson	Søkeresultatet (basert på UserInput-egenskapen) vist som en streng i egenskapen for JSON-format.
FreeformAddress	Valgt adresse fra listen over foreslåtte adresser.
LocalName	En address-kontroll som representerer navnet på et geografisk område eller en lokalitet som grupperer flere adresserbare objekter for adresseringsformål, uten å være en administrativ enhet.
PostalCode	Postnummer.
ExtendedPostalCode	Utvidet postnummer.
CountryCode	Landskode.
Land	Land.
CountryCodeISO3	Landkode i ISO alfa-3-format.
CountrySubdivisionName	Underinndeling for navn på land.
StreetName	Gatenavn.
StreetNumber	Gatenummer.
Kommune	Kommune.
MunicipalitySubdivision	Underinndeling av kommune.
CountryTertiarySubdivision	Tertiær underinndeling for land.
CountrySecondarySubdivision	Sekundær underinndeling for land.
CountrySubdivision	Underinndeling for land.

Når du kjører appen og begynner å skrive inn en adresse, vises adressene som samsvarer med den angitte verdien, og de befinner seg bare innenfor 100 000 meter fra gjeldende plassering. Legg også merke til at det ikke vises flere enn fem adresseforslag om gangen når du begynner å skrive inn adressen.

Når du bruker kontrollen over, registrerer vi adressen i adressefeltene i skjemaet for å opprette en ny forretningsforbindelse. Dette trinnet er nyttig for at brukeren ikke skal kunne skrive inn hvert enkelt adresseelement.

Vi angir datakortverdiene til riktig egenskapsverdi fra inndataene for adressen.

Tips

Standardverdiene for datakortet kan være låst. Hvis du vil låse dem opp, velger du datakortet og går til Avanserte egenskaper, og deretter velger du Lås opp for å endre egenskaper.

Datakort	Verdi
Adresse 1: Gate/vei 1	AddressInput1.StreetNumber & " " & AddressInput1.StreetName
Adresse 1: Poststed	AddressInput1.Municipality
Adresse 1: Delstat/område	AddressInput1.CountrySubdivision
Adresse 1: Postnummer	AddressInput1.PostalCode
Datakortet Adresse 1: Land/område	AddressInput1.Country
Adresse 1: Breddegrad	AddressInput1.SelectedLatitude
Adresse 1: Lengdegrad	AddressInput1.SelectedLongitude

Eksempel på datakortet Adresse 1: Gate/vei 1:

Skjemaet fylles ut med alle adressefeltene når en adresse velges i Adresseinndata-kontrollen.

Kart-kontroll

I denne delen ser vi hvordan du legger til Kart-kontrollen i appen for å vise den valgte posisjonen på kartet.

1. Før vi legger til Kart-kontrollen, må vi opprette en samling for å registere adressen fra adresseinndataene – denne samlingen kan brukes som datakilden for kartet.

   I OnAddressSelect-egenskapen for Adresseinndata-kontrollen angir du følgende formel for å opprette en samling som registrerer adressedataene.

   ClearCollect(
       colSelectedAddress,
       {
           Street: AddressInput1.StreetNumber & " " & AddressInput1.StreetName,
           City: AddressInput1.Municipality,
           State: AddressInput1.CountrySubdivision,
           Zip: AddressInput1.PostalCode,
           Country: AddressInput1.Country,
           Latitude: AddressInput1.SelectedLatitude,
           Longitude: AddressInput1.SelectedLongitude
       }
   )
   

   

2. Velg et område utenfor Adresseinndata-kontrollen, og velg Sett inn > Media > Kart for å legge til kart-kontrollen på skjermen.

   

3. Velg samlingen som datakilde.

   

4. Flytt kartet under innskrivingsdelen for adressen.

   

Konfigurere egenskaper for Kart-kontrollen

I denne delen vil vi se gjennom og om nødvendig angi forskjellige egenskaper for kart-kontrollen.

Tabellen nedenfor viser de tilgjengelige egenskapene.

Egenskap	Beskrivelse
Datakilde (elementer)	Datakilde (tabell) som viser et forhåndsdefinert sett med lengdegrader og breddegrader, som skal vises som en stift på kartet når det lastes inn. Tilordne hver kolonne i dataene ved hjelp av ItemAddresses, ItemLongitudes, ItemLatitudes og ItemLabels.
Bruk standardplassering	Angir om kartet skal initialiseres på en standardplassering angitt av brukeren.
Default longitude	Lengdegraden kartet går til når det lastes inn, hvis Bruk standardplassering er aktivert.
Default latitude	Breddegraden kartet går til når det lastes inn, hvis Bruk standardplassering er aktivert.
Default zoom level	Zommenivået kartet angis til når det lastes inn, hvis Bruk standardplassering er aktivert.
Show current location	Angir om kartet skal vise gjeldende plassering for brukeren.
Gjeldende plasseringsbreddegrad	Breddegraden for gjeldende sted for brukeren hvis Vis gjeldende sted er aktivert.
Gjeldende plasseringslengdegrad	Lengdegraden for gjeldende sted for brukeren hvis Vis gjeldende sted er aktivert.
Satellittvisning	Angir om stilen for kartet er en satellittvisning eller en veivisning.
Klyngeknappenåler	Om kartstiftene er gruppert.
Zoomkontroll	Om zoom-kontrollen vises på kartet.
Compass control	Om Kompass-kontrollen vises på kartet.
Pitch control	Om hellingskontrollen vises på kartet.
Farge på knappenål	Fargen på stiftene.
ItemsLabels	En kolonne i Elementer med strengene du vil bruke som etiketter for stiftene.
ItemsAddresses	En kolonne i Elementer med strengene som representerer plasseringen til stiftene.
ItemsLongitudes	Navnet på kolonnen i tabellen i datakilden med flyttall som representerer lengdegradsposisjonen til stiftene.
ItemsLatitudes	Navnet på kolonnen i tabellen i datakilden med flyttall som representerer breddegradsposisjonen til stiftene.
ItemsColors	Farge på stiftene.
ItemsIcons	Ikon for stiftene.
Varer	Navnet på tabellen i datakilden som inneholder alle oppføringene du vil plotte på kartet, ved hjelp av stifter. Hver rad må ha en oppføring for etiketten, lengdegraden og breddegraden for hver rad.
OnMapClick	Hvordan kartet reagerer når en posisjon velges.
OnSelect	Hvordan appen reagerer når en kartstift velges.
OnLoad	Hvordan appen reagerer når kartet er ferdig innlastet.
OnItemsChange	Hvordan appen reagerer når kartstiftene endres.
Vis informasjonskort	Om informasjonskortene vises på stiftene på kartet.
Vis figurer	Om figurene i Shapes_Items vises på kartet.
Vis figuretiketter	Om etikettene vises på figurene vises på kartet.
Enable shape drawing	Om tegneverktøy-kontrollen vises på kartet.
Enable shape deleting and label editing	Om figurer kan slettes og etikettene kan redigeres på kartet.
Shapes_Items	Navnet på tabellen i datakilden som inneholder alle oppføringene med GeoJSON-objektene du vil vise på kartet som figurer.
ShapeGeoJSONObjects	Navnet på kolonnen i tabellen i datakilden med strenger som representerer GeoJSON-objektene til figurene.
ShapeLabels	En kolonne i Shapes_Items med strengene du vil bruke som etiketter for figurene.
ShapeColors	Farge på figurene.
OnShapeSelected	Hvordan appen reagerer når en figur på kartet velges.
OnShapeCreated	Hvordan appen reagerer når en figur på kartet opprettes.
OnShapeEdited	Hvordan appen reagerer når en figur på kartet redigeres.
OnShapeDeleted	Hvordan appen reagerer når en figur på kartet slettes.

Konfigurere utdataegenskaper for Kart-kontrollen

Kart-kontrollutdataene forskjellige egenskaper når en bruker samhandler med den i en app. Du kan bruke disse utdataene i andre kontroller eller til å tilpasse opplevelsen.

Tabellen nedenfor viser de tilgjengelige utdataegenskapene.

Egenskap	Beskrivelse
CenterLocation	Midtstill posisjon for kartet som enten .Latitude eller .Longitude. Utdataene er et heltall. Kall av Map1.CenterLocation.Latitude vil for eksempel gi et enkelt heltall, for eksempel "47,60357".
Valgte	Den valgte stiften på kartet.
SelectedItems	De valgte stiftene for den valgte klyngen på kartet.
GeocodedItems	De geokodede stedene for stiftene på kartet.
ClickedLocation	Sist klikket posisjon på kartet som enten .Latitude eller .Longitude.
Shapes_Selected	Oppføringen for den valgte figuren fra Shapes_Items.
Shapes_SelectedItems	Oppføringene for de valgte overlappende figurene fra Shapes_Items.
SelectedShape	Den valgte figuren på kartet med .Perimeter og .Area.
DeletedShape	Den sist slettede figuren på kartet med .Perimeter og .Area.
GeoJSON	Listen over figurer på kartet i funksjonssamling GeoJSON-format.

Når vi skal slippe en stift på adressen som er angitt i adresseinndataene, bruker vi samlingen vi opprettet på onAddressSelect-egenskapen, og bruker den i kart-kontrollen.

Egenskap	Verdi
Elementer	colSelectedAddress
ItemsLatitudes	colSelectedAddress.Latitude
ItemsLongitude	colSelectedAddress.Longitude

Noen av egenskapene til stiften kan tilpasses per plasseringsstift, som forklart nedenfor:

1. ItemsColors - For å oppdatere fargen på stiften til en annen farge for hvert sted, legger du til en kolonne i samlingen Color: Red, og bruker den i dataegenskapen ItemsColors for Kart-kontrollen.

2. ItemsLabels - For å oppdatere etiketten til stifen til en annen etikett som viser adressen for hver plassering, legger du til kolonnen i samlingen Label:AddressInput1.FreeformAddress, og bruker den i ItemsLabels-dataegenskapen for Kart-kontrollen.

3. ItemsIcons – Hvis du vil endre ikonet for stiften for hver plassering, legger du til en kolonne i samlingen og bruker den i ItemsIcons-dataegenskapen for Kart-kontrollen. I dette eksemplet skal vi legge til et triangelikon med formelen som Icon: triangle.

   Tips

   Gå til Liste over bildemaler for å få en fullstendig liste over ikoner.

   ClearCollect(
       colSelectedAddress,
       {
           Street: AddressInput1.StreetNumber & " " & AddressInput1.StreetName,
           City: AddressInput1.Municipality,
           State: AddressInput1.CountrySubdivision,
           Zip: AddressInput1.PostalCode,
           Country: AddressInput1.Country,
           Latitude: AddressInput1.SelectedLatitude,
           Longitude: AddressInput1.SelectedLongitude,
           Label: AddressInput1.FreeformAddress,
           Color: Red,
           Icon: Triangle
       }
   );
   

Når du har lagt dem til i samlingen, går du til kategorien Avansert for Kart-kontrollen og oppdaterer egenskapene ItemsColors, ItemsLabels og ItemsIcons.

Kjør appen i forhåndsvisningsmodus for å teste den. Kartet viser stedet som er valgt i adresseinnskrivingen med et triangelikon, og adressen vises som en etikett på kartet.

Se også

Interaktivt kart-kontroll