Jaa

Luo osoitteensyöttö- ja karttaohjausobjekteja sisältävä sovellus

  • Artikkeli

Useissa skenaarioissa käyttäjien odotetaan syöttävän osoitteita sovellukseen. Käyttäjän katuosoitteen, postitoimipaikka- ja postinumeron sekä osavaltion mukaan on syötetty useita kenttiä. Osoitteiden kirjoittaminen voi olla turhauttavaa ja niissä voi esiintyä virheitä etenkin mobiiliskenaarioissa.

Osoitesyötteen ohjausobjekti näyttää käyttäjälle dynaamisia osoite-ehdotuksia kirjoittaneissa tyypissä. Käyttämällä karkkia vastaavaa logiikkaa ohjausobjekti ehdottaa useita mahdollisia osoitteiden vastaavuuksia, joista käyttäjä voi valita—mikä helpottaa täsmällisten osoitteiden kirjoittamista.

Ohjaus palauttaa osoitteen strukturoituna tietona, jolloin sovellus voi poimia tietoja, kuten kaupunki, katu, kunta ja jopa leveys- ja pituusaste. Tietojen muoto sopii monilla kielialueilla ja kansainvälisissä osoitemuodoissa käytettäväksi.

Jos haluat käyttää ohjausobjektia, ota ympäristölle käyttöön geospatiaaliset palvelut.

  • Tässä videossa on tietoja osoitteen syöttöohjausobjektin käytöstä:

  • Tässä videossa on tietoja osoitteen karttaobjektin käytöstä:

Tässä artikkelissa opetellaan käyttämään osoitesyöteohjausta pohjaan perustuvien sovellusten avulla.

Edellytykset

Tätä varten tarvitset Power Apps -ympäristön, jossa on Microsoft Dataverse -tietokanta. Jos sinulla ei ole käyttöoikeutta, voit rekisteröityä Power Appsin kehittäjäsuunnitelmaan tai käyttää Power Apps -kokeiluversiota.

Kokeiluympäristön luominen

Ympäristö Power Appsissa on tila, jossa voi tallentaa, hallita ja jakaa organisaation liiketoimintatietoja, sovelluksia, keskustelubotteja ja työnkulkuja. Se toimii myös säilönä erillisille sovelluksille, joilla voi olla eri roolit, käyttöoikeusvaatimukset tai kohdeyleisöt.

Jokaisessa ympäristössä voi olla yksi Dataverse-tietokanta.

Luomme uuden ympäristön, joka sisältää Dataverse-tietokannan, jotta saat tämän oppitunnin valmiiksi. Tämä on 30 päivän kokeilu, joka päättyy 30 päivän päästä, mutta voit päivittää sen sandbox-ympäristöön tai tuotantoympäristöön, jos haluat säilyttää sen.

Luodaan kokeiluympäristö, joka sisältää Dataverse-tietokannan ja tässä aiheessa käytetyt mallitiedot.

  1. Siirry Power Platform -hallintakeskukseen selaimessa.

  2. Valitse Ympäristöt.

  3. Valitse Uusi.

  4. Kirjoita nimi, esimerkiksi "Dataverse-kokeiluversio".

  5. Valitse ympäristötyypiksi Kokeiluversio.

  6. Vaihda Luo tietokanta -painikkeeksi Kyllä.

  7. Valitse Seuraava.

    Kokeiluympäristön luominen.

  8. Vaihda Ota käyttöön esimerkkisovellukset ja -tiedot -valinnaksi Kyllä.

  9. Valitse Tallenna.

Kokeiluympäristö luodaan nyt, mukaan lukien Dataverse-tietokanta ja näytetiedot Dataverse-taulukoissa.

Geospatiaalisten palveluiden ottaminen käyttöön ympäristössä

Ennen kuin geospatiaalisia palveluita voi käyttää pohjaan perustuvissa sovelluksissa, järjestelmänvalvojan on otettava käyttöön sen ympäristön ominaisuudet, jossa haluamme luoda sovelluksen.

Lisätietoja geospatiaalisten palveluiden käytöstä ympäristössä on ohjeaiheessa Geospatiaalisten ominaisuuksien ottaminen käyttöön ympäristössä.

Luo pohjaan perustuva sovellus

Aloitetaan luomalla sovellus. Sen jälkeen luodaan Header-ohjausobjekti, jonka avulla sovelluksessa voidaan standardoida ylätunnisteen ulkoasu eri näytöissä.

  1. Luo tyhjä pohjaan perustuva sovellus aiemmin luodussa ympäristössä.

  2. Lisää uusi näyttö valitsemalla Lisää > Uusi näyttö > Vieritettävä.

    Valitse vieritettävä.

  3. Vaihda otsikkotekstiksi Uusi tili.

    Otsikko

  4. Valitse Lisää > Lomakkeet > Muokkaa lisätäksesi lomakkeen näyttöön.

    Valitse muokkaus

    Lomakeohjausobjekti lisätään

    Lomakeohjausobjekti lisättiin

  5. Päivitä seuraavat lomakkeen ominaisuudet:

    Ominaisuus Arvo
    Tietolähde Tilit
    Columns 2
    DefaultMode FormMode.New

  6. Lisää lomakkeeseen kenttiä valitsemalla kenttien vieressä Muokkaa ja valitse sitten seuraavat osoitekentät:

    • Osoite 1: Lähiosoite 1
    • Osoite 1: Postitoimipaikka
    • Osoite 1: Osavaltio
    • Osoite 1: Postinumero
    • Osoite 1: Maa tai alue
    • Osoite 1: Leveysaste
    • Osoite 1: Pituusaste

    Osoitteen ominaisuudet

  7. Muuta kenttien järjestystä alla esitetyllä tavalla.

    Asiakastilin nimi ja pääpuhelinnumero ensimmäisellä rivillä, Osoite 1: Katu 1 ja Osoite 1: Postitoimipaikka toisella rivillä, Osoite 1: Osavaltio/provinssi ja Osoite 1: Postinumero kolmannella rivillä, Osoite 1: Maa/alue ja Osoite 1: Leveysaste neljännellä rivillä, Osoite 1: pituusaste viidennellä rivillä.

Osoitesyötön ohjausobjekti

Tässä osassa lisätään sovellukseen Osoitesyöte-ohjausobjekti.

  1. Insert > Input > Osoitesyöte lisätäksesi ohjausobjektin näyttöön.

    Valitse osoitesyötteen ohjausobjekti

  2. Siirrä ohjausobjekti näytön oikeassa yläreunaan.

    Osoitteen syöteruutu on lisätty

Osoitesyötteen ohjausobjektin ominaisuuksien määrittäminen

Tässä osassa tarkistetaan ja määritetään tarvittaessa osoiteohjausobjektin eri ominaisuudet. Osoitesyöte-ohjausobjektikohtaisia ominaisuuksia on muutama.

Osoitesyötön ohjausobjektit

Ominaisuus Kuvaus
Hakutulosraja Ohjausobjektin näyttöön tulee ehdotettujen osoitteiden määrä. Tässä esimerkissä arvoksi on määritetty viisi, joten haussa näkyy enintään viisi osoitetta.
Hae säteen sisällä Se, ehdottaako ohjausobjektin osoitteita käyttäjän määrittämässä leveys- ja pituus-asteiden säteessä. Tässä esimerkissä arvoksi on määritetty Kyllä.
Leveysaste Maantieteelliseen sijaintiin perustuvissa ehdotuksissa käytetyn keskipisteen leveysaste. Edellyttää, että Hakusäde on käytössä. Tässä esimerkissä on määritetty Location.Latitude-kaava, joka palauttaa nykyisen sijainnin leveysasteet.
Pituusaste Maantieteelliseen sijaintiin perustuvissa ehdotuksissa käytetyn keskipisteen pituusaste. Edellyttää, että Hakusäde on käytössä. Tässä esimerkissä on määritetty Location.Longitude-kaava, joka palauttaa nykyisen sijainnin leveysasteet.
Säde Osoite-ehdotusten rajoittaminen Leveysaste- ja Pituusaste-asetusten metrimääräisellä säteellä. Edellyttää, että Hakusäde on käytössä. Tässä esimerkissä arvoksi on määritetty 100 000.
Kieli Kieli, jolla osoite-ehdotukset palautetaan. Olemme jättäneet sen oletuskieleksi "englanti (Yhdysvallat)".
Maajoukko Osoite-ehdotukset rajoittava pilkuin eroteltu maa- tai alueluettelo ilmaistuna kaksinumeroisena ISO 3166 -maakoodina. Esimerkkejä: "US", "FR", "KW". Tässä esimerkissä arvoksi on määritetty US.

Osoitetulosteen ohjausobjektin ominaisuuksien määrittäminen

Ohjausobjekti tulostaa erilaisia ominaisuuksia, kun käyttäjä käyttää sitä sovelluksessa. Voit käyttää näitä lähtöjä muissa ohjausobjekteissa tai mukauttaa käyttökokemusta.

Taulukossa on esitetty saatavilla olevat tulosominaisuudet.

Ominaisuus Kuvaus
UserInput Teksti, jonka käyttäjä on kirjoittanut syöttöruutuun.
SelectedLatitude Käyttäjän valitsema osoitteen leveysaste syöttökentässä.
SelectedLongitude Käyttäjän valitsema osoitteen pituusaste syöttökentässä.
SearchResultJson Hakutulos (UserInput-ominaisuuden perusteella), joka näytetään JSON-merkkijonona.
FreeformAddress Valittu osoite ehdotettujen osoitteiden luettelosta.
LocalName Osoiteohjausobjekti, joka edustaa sellaisen maantieteellisen alueen tai sijainnin nimeä, joka ryhmitellä useita osoitettavia objekteja osoitettaviksi ilman hallintayksikköä.
PostalCode Postinumero.
ExtendedPostalCode Laajennettu postinumero.
CountryCode Suuntanumero.
Maa tai alue Maa tai alue.
CountryCodeISO3 Maakoodi ISO alpha-3 -muodossa.
CountrySubdivisionName Maan alajaon nimi.
StreetName Kadun nimi.
StreetNumber Kadun numero.
Kunta Kunta.
MunicipalitySubdivision Kunnan alajako.
CountryTertiarySubdivision Maan/alueen tertiäärinen alajako.
CountrySecondarySubdivision Maan/alueen toissijainen alajako.
CountrySubdivision Maan/alueen alajako.

Kun suoritat sovelluksen ja aloitat osoitteen kirjoittamisen, siinä näkyvät osoitteet, jotka vastaavat annettua arvoa ja jotka sijaitsevat vain 100 000 metrin päässä nykyisestä sijainnista. Huomaa myös, että siinä ei näy enempää kuin viisi osoite-ehdotusta samalla, kun kirjoitat osoitteen.

Osoitteen syöttö

Yllä mainitun ohjausobjektin avulla osoite siepataan lomakkeen osoitekenttiin uuden asiakkaan luomiseksi. Tämä vaihe on hyödyllinen, jotta käyttäjän ei tarvitse kirjoittaa jokaista osoite-elementtiä yksitellen.

Tietokortin arvoksi määritetään oikea ominaisuuden arvo osoitesyötteen avulla.

Vihje

Tietokortin oletusarvot voidaan lukita. Jos haluat poistaa niiden lukituksen, valitse tietokortti, siirry Lisäasetukset-ominaisuuksiin ja sitten valitsemalla Poista lukitus muuttaaksesi ominaisuuksia.

Poista ohjausobjektin lukitus

Tietokortti Arvo
Osoite 1: Lähiosoite 1 AddressInput1.StreetNumber & " " & AddressInput1.StreetName
Osoite 1: Postitoimipaikka AddressInput1.Municipality
Osoite 1: Osavaltio/provinssi AddressInput1.CountrySubdivision
Osoite 1: Postinumero AddressInput1.PostalCode
Osoite 1: Maan tai alueen tietokortti AddressInput1.Country
Osoite 1: Leveysaste AddressInput1.SelectedLatitude
Osoite 1: Pituusaste AddressInput1.SelectedLongitude

Esimerkki: Osoite 1: Katu 1 -tietokortti:

Osoitteen kaava

Lomakkeeseen täytetään kaikki osoitekentät, kun osoite valitaan Osoitesyöte-ohjausobjektissa.

Lopullinen lomake

Kartan ohjausobjekti

Tässä osassa näytetään, miten sovelluksen Kartta-ohjausobjekti lisätään, jotta valittu sijainti näkyy kartassa.

  1. Ennen Kartta-ohjausobjektin lisäämistä on luotava kokoelma, joka kerää osoitteen osoitesyötteen perusteella. Tätä kokoelmaa käytetään tietolähde tietokarttana.

    Luo osoitetiedot sieppaava kokoelma kirjoittamalla Osoitesyöte-ohjausobjektin OnAddressSelect-ominaisuudelle seuraava kaava.

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

    Ohjausobjektin kaavan yhdistäminen

  2. Valitse Osoitesyöte-ohjausobjektin ulkopuolinen alue ja lisää kartan ohjausobjekti näyttöön valitsemalla Insert > Media > Kartta.

    Valitse martta

  3. Valitse kokoelma tietolähteeksi.

    Valitse ohjausobjekti

  4. Siirrä kartta osoitesyöteosan alapuolelle.

    Aseta kartta näyttöön

Kartta-ohjausobjektin ominaisuuksien määrittäminen

Tässä osassa tarkistetaan ja määritetään tarvittaessa karttaohjausobjektin eri ominaisuudet.

Taulukossa on esitetty saatavilla olevat ominaisuudet.

Ominaisuus Kuvaus
Tietolähde(Items) Tietolähde (taulukko), jossa on luettelo ladatulla kartalla karttamerkintänä näkyvistä esimääritetyistä pituus- ja leveysasteista. Yhdistä tietojen kukin sarake käyttämällä ominaisuuksia ItemAddresses, ItemLongitudes, ItemLatitudes ja ItemLabels.
Käytä oletussijaintia Määrittää, käynnistyykö kartta käyttäjän määrittämässä oletussijainnissa.
Oletusarvoinen pituusaste Kartan pituusaste on tämä ladattuna, jos Käytä oletussijaintia on otettu käyttöön.
Oletusarvoinen leveysaste Kartan leveysaste on tämä ladattuna, jos Käytä oletussijaintiaon otettu käyttöön.
Oletuszoomaustaso Kartalle määritetty zoomaustaso ladattuna, jos Käytä oletussijaintia on otettu käyttöön.
Näytä nykyinen sijainti Tuleeko kartan näyttää käyttäjän nykyinen sijainti.
Nykyisen sijainnin leveysaste Käyttäjän nykyisen sijainnin leveysaste, jos Näytä nykyinen sijainti -asetus on käytössä.
Nykyisen sijainnin pituusaste Käyttäjän nykyisen sijainnin pituusaste, jos Näytä nykyinen sijainti -asetus on käytössä.
Satelliittinäkymä Määrittää, onko kartan tyyli satelliittinäkymä vai tienäkymä.
Klusterinastat Määrittää, klusteroidaanko karttamerkinnät.
Zoomausohjausobjekti Tieto siitä, näkyykö zoomausohjausobjekti kartalla.
Kompassin ohjausobjekti Tieto siitä, näkyykö kompassiohjausobjekti kartalla.
Nousukulman ohjausobjekti Tieto siitä, näkyykö kaltevuudenhallintaohjausobjekti kartalla.
Nastan väri Nastojen väri.
ItemsLabels Kohde-kohdan sarake, jonka merkkijonona käytetään nastojen selitteinä.
ItemsAddresses Kohteet-kohdan sarake, jonka merkkijonot ilmaisevat nastojen sijainnin.
ItemsLongitudes Tietolähteen taulukon sarakkeen nimi, jossa on nastojen pituusastetta ilmaisevat liukuluvut.
ItemsLatitudes Tietolähteen taulukon sarakkeen nimi, jossa on nastojen leveysastetta ilmaisevat liukuluvut.
ItemsColors Nastojen väri.
ItemsIcons Nastojen kuvake.
Kohteet Sen tietolähteen taulukon nimi, joka sisältää kaikki nastojen avulla kartalle piirrettävät tietueet. Kullakin rivillä on oltava kunkin rivin selitteen, pituusasteen ja leveysasteen merkintä.
OnMapClick Tapa, jolla kartta reagoi, kun sijaintia valitaan.
OnSelect Tapa, jolla sovellus reagoi, kun kartan nasta valitaan.
OnLoad Tapa, jolla sovellus reagoi, kun kartta on ladattu.
OnItemsChange Tapa, jolla sovellus reagoi, kun karttanastat muuttuvat.
Show info cards Tietokorttien näkyminen kartan nastoilla.
Näytä muodot Shapes_Items-ominaisuuden muotojen näkyminen kartalla.
Näytä muotojen selitteet Selitteiden näkyminen kartan muodoissa.
Salli muotojen piirtäminen Tieto siitä, näkyykö piirtotyökaluohjausobjekti kartalla.
Salli muotojen poistaminen ja selitteiden muokkaus Muotojen mahdollinen poistaminen ja niiden selitteiden muokkaaminen kartassa.
Shapes_Items Tietolähteessäsi olevan taulukon nimi, joka sisältää kaikki tietueet GeoJSON-objekteilla, jotka haluat näyttää kartalla muotoina.
ShapeGeoJSONObjects Sen tietolähteen taulukon sarakkeen nimi, jonka merkkijonot ilmaisevat muotojen GeoJSON-objektit.
ShapeLabels Shapes_Items-ominaisuuden sarake, jossa on muotojen selitteinä käytettävät merkkijonot.
ShapeColors Muotojen väri.
OnShapeSelected Tapa, jolla sovellus reagoi, kun kartalla oleva muoto valitaan.
OnShapeCreated Tapa, jolla sovellus reagoi, kun kartalle luodaan muoto.
OnShapeEdited Tapa, jolla sovellus reagoi, kun kartalla olevaa muotoa muokataan.
OnShapeDeleted Tapa, jolla sovellus reagoi, kun kartalla oleva muoto poistetaan.

Kartta-ohjausobjektin tulosteominaisuuksien määrittäminen

Kartta-ohjausobjekti tulostaa erilaisia ominaisuuksia, kun käyttäjä käyttää sitä sovelluksessa. Voit käyttää näitä lähtöjä muissa ohjausobjekteissa tai mukauttaa käyttökokemusta.

Taulukossa on esitetty saatavilla olevat tulosominaisuudet.

Ominaisuus Kuvaus
CenterLocation Kartan keskikohdan sijainti ilmaistuna jo arvolla .Latitude tai .Longitude. Tulos on kokonaisluku. Jos esimerkiksi Map1.CenterLocation.Latitude kutsutaan, tuloksena on yksi kokonaisluku, kuten "47.60357".
Valittu Valittu nasta kartalla.
SelectedItems Valitun klusterin valittu nasta tai valitut nastat kartalla.
GeocodedItems Karttaan kiinnitettyjen nastojen maantieteellisesti koodatut sijainnit.
ClickedLocation Viimeksi napsautettu sijainti kartalla, joka ilmaistaan joko arvolla .Latitude tai .Longitude.
Shapes_Selected Shapes_Items-ominaisuudessa valitun tietueen muoto.
Shapes_SelectedItems Shapes_Items-ominaisuuden valittujen päällekkäisten muotojen tietueet.
SelectedShape Valittu muoto kartalla, jossa on .Perimeter ja .Area.
DeletedShape Viimeinen poistetut muodot kartassa .Perimeter- ja .Area-määritysten avulla.
GeoJSON Kartan muotojen luettelo ominaisuuskokoelman GeoJSON-muodossa.

Jos haluat pudottaa nastan osoitesyötteeseen annettuun osoitteeseen, käytetään OnAddressSelect-ominaisuudelle luomaamme kokoelmaa ja käytetään sitä Kartta-ohjausobjektissa.

Ominaisuus Arvo
kohdetta colSelectedAddress
ItemsLatitudes colSelectedAddress.Latitude
ItemsLongitude colSelectedAddress.Longitude

Kartta-ohjausobjektin ominaisuudet

Jotkin nastan ominaisuuksista voidaan mukauttaa sijaintinastan mukaan, kuten on kuvattu alla:

  1. ItemsColors – Jos haluat päivittää nastan värin eri väriin jokaisessa paikassa, lisää sarake kokoelmaan Color: Red ja käytä sitä ItemsColors-tieto-omaisuudessa Kartta-ohjausobjektissa.

  2. ItemsLabels – Jos haluat päivittää nastan tunnisteen eri tarraksi, jossa näkyy kunkin sijainnin osoite, lisää sarake kokoelmaan Label:AddressInput1.FreeformAddress ja käytä sitä ItemsLabels-kohdassa Kartta-ohjausobjektissa.

  3. ItemsIcons – Jos haluat muuttaa kunkin sijainnin nastan kuvaketta, lisää kokoelmaan sarake ja käytä sitä Kartta-ohjausobjektin ItemsIcons-tieto-ominaisuudessa. Tässä esimerkissä lisätään kolmiokuvake, jonka kaava on Icon: triangle.

    Vihje

    Täydellinen kuvakkeiden luettelo on kohdassa luettelo kuvamalleista.

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

Kun olet lisännyt nämä tiedot kokoelmaan, siirry Kartta-ohjausobjektin Lisäasetukset-välilehteen ja päivitä ItemsColors-, ItemsLabels- ja ItemsIcons-ominaisuudet.

Kartta-ohjausobjektin lisäominaisuudet

Suorita sovellus esiversiotilassa testataksesi sitä. Kartta näyttää osoitesyötteeseen valitun sijainnin kolmiokuvakkeen avulla, ja osoite näkyy kartassa selitteenä.

Kartan ohjausobjektin päivitysosoite

Katso myös

Vuorovaikutteisen kartan ohjausobjekti