Control d'entrada d'adreces

L'entrada d'adreces pot ser frustrant i propensa a errors, particularment en escenaris mòbils.

El control d'entrada d'adreces us permet veure suggeriments dinàmics d'adreces a mesura que escriviu. Utilitzant la lògica de coincidència difusa, el control suggereix múltiples coincidències d'adreces potencials que l'usuari pot seleccionar — fent que sigui més ràpid i fàcil d'introduir adreces precises.

El control retorna l'adreça com a dades estructurades, permetent a la seva aplicació extreure informació com ciutat, carrer, municipi, i fins i tot latitud i longitud. Les dades estan en un format amigable per a moltes configuracions regionals i formats internacionals d'adreça.

Per utilitzar el control, heu d'habilitar funcions geoespacials per al medi ambient.

Assegureu-vos que també reviseu els requisits previs per utilitzar controls geoespacials.

Utilitza el control

Inseriu el control a l'aplicació com ho faríeu normalment per a qualsevol altre control o control.

Amb una aplicació oberta per editar-la al Power Apps Studio:

  1. Obre la pestanya Insereix.

  2. Expandiu Entrada.

  3. Seleccioneu l'entrada d'adreça de control per col·locar-la al centre de la pantalla de l'aplicació o arrossegueu-la per col·locar-la en qualsevol lloc de la pantalla.

Podeu modificar el control mitjançant diverses propietats.

Definir un radi de cerca per defecte

De manera predeterminada, el control cercarà al voltant de la ubicació de l'usuari (sempre que l'usuari hagi donat el seu consentiment perquè l'aplicació accedeixi a la seva ubicació). No obstant, es pot refinar l'àrea de cerca per defecte per ajudar a restringir o canviar els resultats inicials quan els usuaris introdueixen una adreça.

  1. A la subfinestra Propietats, definiu el commutador Cerca en el radi a Activat.

  2. Introduïu una longitud, una latitud i un radi (en metres).

El control començarà a cercar a la latitud i la longitud, fins a la distància especificada en el camp de radi.

Utilitza el control del mapa amb el control d'adreça d'entrada

Podeu desar adreces que un usuari introdueixi al control d'adreces com a recopilació de dades. A continuació, podeu recuperar aquestes adreces i mostrar-les al control del mapa.

  1. App el control del mapa i el control d'adreça d'entrada a l'aplicació.

  2. Al menú Insereix, seleccioneu Botó i desplaceu-lo a l'aplicació.

  3. Aneu a la pestanya Avançat de la subfinestra Propietats. A OnSelect, introduïu el següent:

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

    Això fa que el botó desi la latitud i la longitud actuals a una col·lecció anomenada locations, sempre que els resultats de la cerca no estiguin en blanc

    Captura de pantalla del botó a l'aplicació

  4. Seleccioneu el control del mapa i aneu a la pestanya Avançats de la subfinestra Propietats.

  5. Definiu les propietats següents:

    • Elements com a ubicacions
    • ItemsLatitudes com a "Latitud"
    • ItemsLongitudes com a "Longitud"

Cada vegada que un usuari selecciona el botó, el resultat del control d'entrada d'adreça s'afegirà al mapa com un nou pin.

Propietats d'entrada

Les propietats següents es troben a la subfinestra Entrada d'adreces del control a les pestanyes Propietats i Avançades.

Les propietats son a la subfinestra lateral.

Algunes propietats només estan disponibles a la pestanya Avançat a la secció Més opcions.

Propietat Descripció Type Location
Límit de resultats de cerca El nombre d'adreces suggerides que es mostren al control. Integer Propietats
Cerca dins d'un radi Si el control hauria de suggerir adreces dins del radi definit per l'usuari de la latitud i la longitud. Boolean Propietats
Latitud La latitud del punt central utilitzat per a suggeriments d'adreces amb filtratge geogràfic. Requereix que Cerca dins del radi estigui activat. Decimal entre –180 i 180 Propietats
Longitud La longitud del punt central utilitzat per a suggeriments d'adreces amb filtratge geogràfic. Requereix que Cerca dins del radi estigui activat. Decimal entre –180 i 180 Propietats
Radi El radi, en metres, al voltant de Latitud i Longitud per restringir els suggeriments d'adreça. Requereix que Cerca dins del radi estigui activat. Decimal Propietats
Language La llengua en què es retornen els suggeriments d'adreça Cadena Propietats
Conjunt de països Llista de països separats per comes per restringir els suggeriments d'adreça, en codis de país ISO 3166 alpha-2. Per exemple, US, FR, KW String Propietats

Propietats de sortida

El control emet diverses propietats quan un usuari interactua amb ell dins d'una aplicació. Podeu utilitzar aquestes sortides en altres controls o per personalitzar l'experiència.

La taula següent mostra les propietats de sortida disponibles.

Propietat Descripció
UserInput Text que l'usuari ha teclejat al quadre d'entrada.
SelectedLatitude Latitud de l'adreça seleccionada per l'usuari al camp d'entrada.
SelectedLongitude Longitud de l'adreça seleccionada per l'usuari al camp d'entrada.
SearchResultJson El resultat de la cerca (basat en la propietat UserInput) es mostra com una cadena en format JSON.
FreeformAddress Adreça seleccionada de la llista d'adreces suggerides.
LocalName Control d'adreça que representa el nom d'una àrea geogràfica o localitat que agrupa una sèrie d'objectes adreçables per a finalitats d'adreçament, sense ser una unitat administrativa.
PostalCode Codi postal.
ExtendedPostalCode Codi postal ampliat.
CountryCode Codi de país.
Country País.
CountryCodeISO3 Codi de país en format ISO alfa-3.
CountrySubdivisionName Nom de la subdivisió del país.
StreetName Nom del carrer.
StreetNumber Número de carrer.
Municipi Municipi.
MunicipalitySubdivision Subdivisió municipal.
CountryTertiarySubdivision Subdivisió terciària del país.
CountrySecondarySubdivision Subdivisió secundària del país.
CountrySubdivision Subdivisió del país.

Propietats addicionals (comunes)

Default: el valor inicial d'un control que l'usuari ha canviat.

Text: text que apareix en un control o que l'usuari escriu en un control.

BorderColor: el color de la vora d'un control.

BorderRadius: el radi de la vora d'un control.

BorderStyle: si la vora d'un control és Sòlid, Amb guions, Amb punts o Cap.

BorderThickness: el gruix de la vora d'un control.

Color: el color del text d'un control.

DisplayMode: si el control permet l'entrada de l'usuari (Edita), només mostra les dades (Visualitza) o està inhabilitada (Inhabilitat).

DisabledBorderColor: el color de la vora d'un control si la propietat DisplayMode del control està definida com a Inhabilitat.

DisabledColor: el color del text d'un control si la propietat DisplayMode està definida com a Inhabilitat.

DisabledFill: el color de fons d'un control si la propietat DisplayMode està definida com a Inhabilitat.

Emplenament: el color de fons d'un control.

FocusedBorderColor: el color de la vora d'un control quan el control està en focus.

FocusedBorderThickness: el gruix de la vora d'un control quan el control està en focus.

Font: el nom de la família del tipus de lletra en què es mostra el text.

FontWeight: el gruix del text en un control: Negreta, Seminegreta, Normal o Fi.

Height: la distància entre les vores superior i inferior d'un control.

Text de suggeriment: text de color gris clar que apareix en un control d'entrada de text si està buit.

HoverBorderColor: el color de la vora d'un control quan l'usuari manté el punter del ratolí sobre el control.

HoverColor: el color del text d'un control quan l'usuari hi manté el punter del ratolí sobre.

HoverFill: el color de fons d'un control quan l'usuari hi manté el punter del ratolí sobre.

Cursiva: si el text d'un control està en cursiva.

LineHeight: distància vertical entre línies de text; per exemple, entre els elements d'una llista.

OnChange: la manera com respon l'aplicació quan l'usuari canvia el valor d'un control (per exemple, ajustant un control lliscant).

PaddingBottom: la distància entre el text d'un control i la vora inferior del control.

PaddingLeft: distància entre el text d'un control i la vora esquerra d'aquest control.

PaddingRight: distància entre el text d'un control i la vora dreta d'aquest control.

PaddingTop: la distància entre el text d'un control i la vora superior del control.

PressedBorderColor: el color de la vora d'un control quan l'usuari toca el control o hi fa clic.

PressedColor: el color de text d'un control quan l'usuari toca el control o hi fa clic.

PressedFill: el color de fons d'un control quan l'usuari toca el control o hi fa clic.

Mida: la mida de la lletra del text que apareix en un control.

Ratllat: si una línia apareix a través del text que apareix en un control.

TabIndex: ordre de navegació amb el teclat en relació amb altres controls.

Tooltip: text explicatiu que apareix quan l'usuari es desplaça per sobre d'un control.

Subratllat: si una línia apareix a sota del text que apareix en un control.

Visible: si es mostra o s'amaga un control.

Width: distància entre les vores esquerra i dreta d'un control.

X: distància entre la vora esquerra d'un control i la vora esquerra del seu contenidor principal (o pantalla, si no té cap contenidor principal).

Y: distància entre la vora superior d'un control i la vora superior del seu contenidor principal (o pantalla, si no té cap contenidor principal).

Altres controls geoespacials

Per visualitzar i interpretar les dades d'ubicació, utilitzeu el control Mapa interactiu.