Ustvarjanje aplikacije s kontrolniki Address input in Map

Obstaja veliko scenarijev, v katerih se pričakuje, da bodo uporabniki vnesli naslove v aplikacijo. V preteklosti je bilo več polj, ki zajemajo vsak element naslova, kjer uporabnik navede naslov ulice, mesto in poštno številko ter izbere državo. Vnašanje naslovov je lahko težavno in prihaja lahko do napak, zlasti v mobilnih scenarijih.

Kontrolnik za vnos naslova uporabniku med tipkanjem predstavi dinamične predloge naslovov. Z uporabo logike mehkega ujemanja kontrolnik predlaga več potencialnih ujemanja naslovov, med katerimi lahko uporabnik izbira— hitrejši in enostavnejši vnos točnih naslovov.

Kontrolnik vrne naslov kot strukturirane podatke, kar aplikaciji omogoča, da izvleče informacije, kot so mesto, ulica, občina in celo zemljepisna širina in dolžina. Podatki so v obliki, prijazni do številnih krajev in mednarodnih oblik zapisov naslovov.

Če želite uporabiti nadzor, morate omogočiti Geoprostorske storitve za okolje.

• Oglejte si ta videoposnetek, če želite izvedeti, kako uporabljati nadzor za vnos naslova:

• Oglejte si ta videoposnetek, če želite izvedeti, kako uporabljati nadzor zemljevida:

V tem članku se bomo naučili, kako uporabljati nadzor vnosa naslova v aplikacijah za platno.

Zahteve

Če želite dokončati to lekcijo, boste potrebovali a Power Apps okolje z a Microsoft Dataverse bazo podatkov. Če nimate licence, se lahko prijavite za Power Apps Načrt za razvijalce ali uporabite a Power Apps sojenje.

Ustvarite preskusno okolje

Okolje je v storitvi Power Apps je mesto za shranjevanje, upravljanje in deljenje poslovnih podatkov, aplikacij, klepetnih botov in potekov vaše organizacije. Deluje tudi kot vsebnik za ločevanje aplikacij, ki lahko imajo različne vloge, varnostne zahteve ali ciljna občinstva.

Vsako okolje lahko ima eno zbirko podatkov Dataverse.

Da se prepričamo, ali imate vse, kar potrebujete za dokončanje te lekcije, bomo ustvarili novo okolje, ki vključuje zbirko podatkov Dataverse. Gre za 30-dnevno preskusno različico, ki po 30 dneh ne bo več dostopna, če jo želite obdržati, pa jo lahko nadgradite na preizkusno ali produkcijsko okolje.

Ustvarili bomo poskusno okolje, ki bo vključevalo a Dataverse podatkovno bazo in vzorčne podatke, uporabljene v tem tema.

1. Pojdi do Power Platform skrbniško središče v spletnem brskalniku.

2. Izberite Okolja.

3. Izberite Novo.

4. Vnesite ime, na primer "Dataverse Sojenje".

5. Izberite Sojenje za vrsto okolja.

6. Preklopite Ustvari zbirko podatkov na Da.

7. Izberite Naprej.

   

8. Preklopite Uvedi vzorčne aplikacije in podatke na Da.

9. Izberite Shrani.

Vaše poskusno okolje bo zdaj ustvarjeno, vključno z a Dataverse bazo podatkov in vzorčne podatke v Dataverse mize.

Omogočite geoprostorske storitve za okolje

Preden lahko uporabimo geoprostorske storitve v platnenih aplikacijah, mora skrbnik omogočiti dostop do funkcij za okolje, v katerem želimo ustvariti aplikacijo.

Če želite izvedeti, kako omogočiti Geoprostorske storitve v svojem okolju, glej Omogočite geoprostorske značilnosti za okolje.

Ustvarite platneno aplikacijo

Začeli bomo z ustvarjanjem aplikacije, nato pa bomo ustvarili kontrolnik glave za uporabo v aplikaciji za standardizacijo videza in občutka glave na različnih zaslonih.

1. Ustvariti aplikacija za prazno platno v okolju, ki ste ga ustvarili prej.

2. Izberite Vstavi > Nov zaslon > Pomikljiv da dodate nov zaslon.

   

3. Spremenite besedilo oznake v "Nov račun".

   

4. Izberite Vstavi > Obrazci > Uredi da na zaslon dodate obrazec.

   

   Kontrolnik obrazca se doda

   

5. Posodobite naslednje lastnosti obrazca:

   Lastnost	Vrednost
   Vir podatkov	Kupci
   Št. stolpcev	2
   Privzeti način	FormMode.New

6. Izberite Uredi poleg polj, da v obrazec dodate več polj, in izberite naslednja naslovna polja:

   • Naslov 1: Ulica 1
   • Naslov 1: mesto
   • Naslov 1: Država
   • Naslov 1: Poštna številka
   • Naslov 1: Država/regija
   • Naslov 1: Širina
   • Naslov 1: Dolžina

   

7. Prilagodite vrstni red polj, kot je prikazano spodaj.

   

Nadzor vnosa naslova

V tem razdelku bomo dodali Vnos naslova nadzor nad aplikacijo.

1. Izberite Vstavi > Vnos > Vnos naslova da dodate nadzor na zaslon.

   

2. Premaknite kontrolnik v zgornjo desno stran zaslona.

   

Konfigurirajte lastnosti za kontrolnik vnosa naslova

V tem razdelku bomo pregledali in po potrebi nastavili različne lastnosti kontrolnika naslova. Nekaj jih je Vnos naslova lastnosti, specifične za nadzor.

Lastnost	Opis
Omejitev rezultatov iskanja	Število predlaganih naslovov, ki jih krmilnik prikaže. V tem primeru smo ga nastavili na 5, tako da v iskanju ne bo prikazanih več kot pet naslovov.
Iskanje v polmeru	Ali naj kontrolnik predlaga naslove znotraj uporabniško definiranega polmer od Zemljepisna širina in Zemljepisna dolžina. Nastavili smo ga da v tem primeru.
Zemljepisna širina	Zemljepisna širina središčne točke, ki se uporablja za geografsko izravnavo predlogov naslovov. Možnost Iskanje znotraj polmera mora biti vklopljena. Nastavili smo ga na formuloLocation.Latitude v tem primeru za vrnitev zemljepisne širine trenutne lokacije.
Zemljepisna dolžina	Zemljepisna dolžina središčne točke, ki se uporablja za geografsko izravnavo predlogov naslovov. Možnost Iskanje znotraj polmera mora biti vklopljena. Nastavili smo ga na formuloLocation.Longitude v tem primeru za vrnitev zemljepisne širine trenutne lokacije.
Polmer	Polmer v metrih okoli možnosti Zemljepisna širina in Zemljepisna dolžina za omejitev predlogov naslovov. Zahteva Iskanje v radiju biti Vklopljeno. V tem primeru smo ga nastavili na 100000.
Jezik	Jezik, v katerem so vrnjeni predlogi naslovov. Pustili smo ga privzeto - "angleščina (Združene države)".
Nabor držav	Seznam držav, ločenih z vejico, za omejitev predlogov naslovov na kode držav iz ISO 3166 alfa-2. Primeri: "ZDA", "FR", "KW". V tem primeru imamo to kot ZDA.

Konfigurirajte izhodne lastnosti za kontrolnik vnosa naslova

Kontrolnik izpiše različne lastnosti, ko uporabnik interagira z njim v aplikaciji. Te izhode lahko uporabite v drugih kontrolnikih ali za prilagoditev izkušnje.

Razpoložljive lastnosti izhoda so navedene v tej tabeli:

Lastnost	Opis
UserInput	Besedilo, ki ga je uporabnik vnesel v polje za vnos.
SelectedLatitude	Zemljepisna širina uporabniško izbranega naslova v vnosnem polju.
SelectedLongitude	Zemljepisna dolžina uporabniško izbranega naslova v vnosnem polju.
SearchResultJson	Rezultat iskanja (na osnovi lastnosti UserInput), prikazan kot niz v lastnosti zapisa JSON.
FreeformAddress	Izbrani naslov s seznama predlaganih naslovov.
LocalName	Kontrolnik naslova, ki predstavlja ime geografskega območja ali kraja, ki združuje več naslovljivih objektov za namene naslavljanja, ne da bi bil upravna enota.
PostalCode	Poštna številka.
ExtendedPostalCode	Razširjena poštna številka.
CountryCode	Koda države.
Država	Država.
CountryCodeISO3	Koda države v obliki ISO alfa-3.
CountrySubdivisionName	Ime podrazdelka za države.
StreetName	Ime ulice.
StreetNumber	Številka ulice.
Občina	Občina.
MunicipalitySubdivision	Podrazdelek za občine.
CountryTertiarySubdivision	Terciarni podrazdelek za države.
CountrySecondarySubdivision	Sekundarni podrazdelek za države.
CountrySubdivision	Podrazdelek za države.

Ko zaženete aplikacijo in začnete vnašati naslov, se prikažejo naslovi, ki se ujemajo z vneseno vrednostjo in se nahajajo le znotraj 100.000 metrov od trenutne lokacije. Upoštevajte tudi, da ne prikaže več kot pet predlogov naslovov hkrati, ko začnete vnašati naslov.

Z zgornjim kontrolnikom bomo zajeli naslov v naslovna polja obrazca, da ustvarimo nov račun. Ta korak je uporaben, tako da uporabniku ni treba vnašati vsakega elementa naslova posebej.

Vrednosti podatkovne kartice bomo nastavili na ustrezno vrednost lastnosti iz vnosa naslova.

Nasvet

Privzete vrednosti podatkovne kartice so morda zaklenjene. Če jih želite odkleniti, izberite podatkovno kartico in pojdite na Napredne lastnosti, nato pa izberite Odklenite, če želite spremeniti lastnosti.

Podatkovna kartica	Vrednost
Naslov 1: Ulica 1	AddressInput1.StreetNumber & " " & AddressInput1.StreetName
Naslov 1: mesto	AddressInput1.Municipality
Naslov 1: Država/območje	AddressInput1.CountrySubdivision
Naslov 1: Poštna številka	AddressInput1.PostalCode
Naslov 1: Podatkovna kartica države/regije	AddressInput1.Country
Naslov 1: Širina	AddressInput1.SelectedLatitude
Naslov 1: Dolžina	AddressInput1.SelectedLongitude

Primer za Naslov 1: ulica 1 podatkovna kartica:

Obrazec se izpolni z vsemi naslovnimi polji, ko je naslov izbran v Vnos naslova nadzor.

Nadzor zemljevida

V tem razdelku bomo videli, kako dodati Zemljevid nadzor v aplikaciji za prikaz izbrane lokacije na zemljevidu.

1. Preden dodate Zemljevid nadzora, moramo ustvariti zbirko za zajemanje naslova iz naslovnega vnosa – ta zbirka bo uporabljena kot vir podatkov za zemljevid.

   Na OnAddressSelect lastnine Vnos naslova Control, vnesite naslednjo formulo, da ustvarite zbirko, ki zajame podatke naslova.

   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. Izberite območje zunaj Vnos naslova nadzor in izberite Vstavi > mediji > Zemljevid da na zaslon dodate nadzor zemljevida.

   

3. Izberite zbirko kot vir podatkov.

   

4. Premaknite zemljevid pod razdelek za vnos naslova.

   

Konfigurirajte lastnosti za kontrolnik Zemljevid

V tem razdelku bomo pregledali in po potrebi nastavili različne lastnosti kontrolnika zemljevida.

V naslednji tabeli so navedene lastnosti, ki so na voljo.

Lastnost	Opis
Vir podatkov (elementi)	Vir podatkov (tabela), ki vsebuje vnaprej določen nabor zemljepisnih širin in dolžin za prikaz kot žebljiček na zemljevidu, ko bo naložen. Preslikajte vse stolpce v vaših podatkih z uporabo možnosti ItemAddresses, ItemLongitudes, ItemLatitudes in ItemLabels.
Uporabi privzeto lokacijo	Ali se zemljevid zažene na privzeti lokaciji, ki jo nastavi uporabnik.
Privzeta zemljepisna dolžina	Zemljepisna dolžina, na katero bi se zemljevid pomaknil, ko je naložen, če je omogočeno Uporabi privzeto lokacijo.
Privzeta zemljepisna širina	Zemljepisna širina, na katero bi se zemljevid pomaknil, ko je naložen, če je omogočeno Uporabi privzeto lokacijo.
Privzeta stopnja povečave	Raven povečave, na katero bi bil zemljevid nastavljen, ko je naložen, če je omogočeno Uporabi privzeto lokacijo.
Pokaži trenutno lokacijo	Ali naj zemljevid prikazuje trenutno lokacijo uporabnika.
Zemljepisna širina trenutne lokacije	Zemljepisna širina trenutne lokacije uporabnika, če je omogočena možnost Pokaži trenutno lokacijo.
Zemljepisna dolžina trenutne lokacije	Zemljepisna dolžina trenutne lokacije uporabnika, če je omogočena možnost Pokaži trenutno lokacijo.
Satelitski pogled	Ali je slog zemljevida satelitski pogled ali cestni pogled.
Združi žebljičke	Ali so žebljički na zemljevidu združeni.
Upravljanje povečave	Ali je nadzor povečave prikazan na zemljevidu.
Upravljanje kompasa	Ali je kontrolnik kompasa prikazan na zemljevidu.
Upravljanje naklona	Ali je nadzor naklona prikazan na zemljevidu.
Barva žebljička	Barva žebljičkov.
ItemsLabels	Stolpec v možnosti »Elementi« z nizi, ki jih želite uporabiti kot oznake za žebljičke.
ItemsAddresses	Stolpec v možnosti »Elementi« z nizi, ki predstavljajo lokacijo žebljičkov.
ItemsLongitudes	Ime stolpca v tabeli v viru podatkov s števili s plavajočo vejico, ki predstavlja položaj zemljepisne dolžine žebljičkov.
ItemsLatitudes	Ime stolpca v tabeli v viru podatkov s števili s plavajočo vejico, ki predstavlja položaj zemljepisne širine žebljičkov.
ItemsColors	Barva žebljičkov.
ItemsIcons	Ikona žebljičkov.
Elementi	Ime tabele v viru podatkov, ki vsebuje vse zapise, ki jih želite prikazati na zemljevidu z žebljički. Vsaka vrstica mora imeti vnos za oznako, dolžino in širino za vsako vrstico.
OnMapClick	Kako se zemljevid odzove, ko je izbrana katera koli lokacija.
OnSelect	Kako se aplikacija odzove, ko je izbran žebljiček zemljevida.
OnLoad	Kako se aplikacija odzove, ko se konča nalaganje zemljevida.
OnItemsChange	Kako se aplikacija odzove, ko se spremenijo žebljički zemljevida.
Pokaži informacijske kartice	Ali so informativne kartice prikazane na žebljički zemljevida.
Prikaz oblik	Ali se oblike pri Shapes_Items prikažejo na zemljevidu.
Prikaz oznak oblik	Ali se oznake prikažejo pri oblikah zemljevida.
Omogoči risanje oblik	Ali je kontrolnik orodij za risanje prikazan na zemljevidu.
Uporabniku omogočite izbris oblik in urejanje oznak	Ali je mogoče oblike brisati in njihove oznake urejati na zemljevidu.
Shapes_Items	Ime tabele v vir podatkov, ki vsebuje vse zapise s predmeti GeoJSON, ki jih želite prikazati na zemljevidu kot oblike.
ShapeGeoJSONObjects	Ime stolpca v tabeli znotraj vira podatkov z nizi, ki predstavljajo predmete GeoJSON oblik.
ShapeLabels	Stolpec v Shapes_Items z nizi, ki jih želite uporabiti kot oznake za oblike.
ShapeColors	Barva oblik.
OnShapeSelected	Kako se aplikacija odzove, ko je izbrana oblika na zemljevidu.
OnShapeCreated	Kako se aplikacija odzove, ko je ustvarjena oblika na zemljevidu.
OnShapeEdited	Kako se aplikacija odzove ob urejanju oblike na zemljevidu.
OnShapeDeleted	Kako se aplikacija odzove, ko je izbrisana oblika na zemljevidu.

Konfigurirajte izhodne lastnosti za kontrolnik Zemljevid

Kontrolnik Zemljevid izpiše različne lastnosti, ko uporabnik interagira z njim v aplikaciji. Te izhode lahko uporabite v drugih kontrolnikih ali za prilagoditev izkušnje.

Razpoložljive lastnosti izhoda so navedene v tej tabeli:

Lastnost	Opis
CenterLocation	Osrednja lokacija zemljevida je lahko .Latitude ali .Longitude. Rezultat bo celo število. Na primer klicanjeMap1.CenterLocation.Latitude bo izpisalo eno samo celo število, kot je "47.60357".
Izbrano	Izbrani žebljiček na zemljevidu.
SelectedItems	Izbrani žebljiček ali žebljički izbrane gruče na zemljevidu.
GeocodedItems	Geografsko kodirane lokacije žebljičkov na zemljevidu.
ClickedLocation	Nazadnje kliknjena lokacija na zemljevidu je lahko .Latitude ali .Longitude.
Shapes_Selected	Zapis izbrane oblike iz Shapes_Items.
Shapes_SelectedItems	Zapisi izbranih prekrivajočih se oblik iz Shapes_Items.
SelectedShape	Izbrana oblika na zemljevidu z .Perimeter in .Area.
DeletedShape	Zadnja izbrisana oblika na zemljevidu z.Perimeter in .Area.
GeoJSON	Seznam oblik na zemljevidu v obliki zapisa za zbirko funkcij GeoJSON.

Če želite spustiti žebljiček na naslov, vpisan v vnos naslova, bomo uporabili zbirko, ki smo jo ustvarili na OnAddressSelect lastnost in jo uporabite v nadzoru zemljevida.

Lastnost	Vrednost
Elementi	colSelectedAddress
ItemsLatitudes	colSelectedAddress.Latitude
Elementi Zemljepisna dolžina	colSelectedAddress.Longitude

Nekatere lastnosti žebljička je mogoče prilagoditi glede na lokacijski žebljiček so razložene spodaj:

1. Predmeti Barve - Če želite posodobiti barvo žebljička v drugo barvo za vsako lokacijo, dodajte stolpec v zbirko Barva: Rdeča, in to uporabite v Predmeti Barve podatkovna lastnost Zemljevid nadzor.

2. Elementi nalepke - Če želite posodobiti oznako žebljička na drugo oznako, ki prikazuje naslov za vsako lokacijo, dodajte stolpec v zbirko Oznaka:AddressInput1.FreeformAddress, in to uporabite v Elementi nalepke podatkovna lastnost Zemljevid nadzor.

3. Ikone predmetov - Če želite spremeniti ikono žebljička za vsako lokacijo, dodajte stolpec v zbirko in ga uporabite v Ikone predmetov podatkovna lastnost Zemljevid nadzor. V tem primeru bomo dodali ikono trikotnika s formulo kot Icon: triangle.

   Nasvet

   Za celoten seznam ikon pojdite na Seznam slikovnih predlog.

   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
       }
   );
   

Ko jih dodate v zbirko, pojdite na Napredno zavihek na Zemljevid nadzor in posodabljanje Predmeti Barve, nalepke in Ikone predmetov lastnosti.

Zaženite aplikacijo v načinu predogleda, da preizkusite. Zemljevid prikazuje lokacijo, izbrano pri vnosu naslova, s ikono trikotnika, naslov pa je prikazan kot oznaka na zemljevidu.

Glejte tudi

Interaktivni nadzor zemljevida