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:
Obre la pestanya Insereix.
Expandiu Entrada.
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.
A la subfinestra Propietats, definiu el commutador Cerca en el radi a Activat.
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.
App el control del mapa i el control d'adreça d'entrada a l'aplicació.
Al menú Insereix, seleccioneu Botó i desplaceu-lo a l'aplicació.
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

Seleccioneu el control del mapa i aneu a la pestanya Avançats de la subfinestra Propietats.
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.

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.