Usar o control de entrada de enderezos para introducir enderezos facilmente
Introducir enderezos pode ser frustrante e provocar erros, especialmente en aplicacións móbiles. Use o control de entrada de enderezos para facilitar a introdución de enderezos. O control usa a lóxica difusa para suxerir posibles coincidencias mentres escribe. Seleccione o que quere para introducir de xeito rápido e sinxelo un enderezo preciso.
O control devolve o enderezo como datos estruturados. A súa aplicación pode extraer información como a cidade, a rúa, o municipio e mesmo as coordenadas de latitude e lonxitude. Os datos están nun formato axeitado para moitas configuracións rexionais e formatos de enderezos internacionais.
Requisitos previos
Para poder usar o control nas súas aplicacións, cómpre habilitar as funcións xeoespaciais do ambiente. Asegúrese tamén de revisar os requisitos previos para o uso de controis xeoespaciais. Consulte a táboa de privacidade e seguridade para obter máis detalles sobre o uso de datos do control de entrada de enderezos.
Engadir un control de entrada de enderezo á súa aplicación
Coa aplicación aberta para a edición en Power Apps Studio:
- Abra o separador Inserir e expanda o Entrada.
- Seleccione Entrada de enderezo para colocar unha caixa de entrada de enderezo na aplicación ou arrastre o control á pantalla para posicionalo con máis precisión. Debe introducir polo menos tres caracteres, incluíndo un número para o control de entrada de enderezos.
Establecer un radio de busca predeterminado
Por defecto, o control buscará a localización do usuario. Pode refinar a área de busca predeterminada para axudar a limitar os resultados iniciais.
- No separador Propiedades do control de entrada de enderezos, active a propiedade Buscar dentro dun radio.
- Insira unha lonxitude, latitude e radio en metros.
O control comezará a buscar a latitude e a lonxitude dadas, ata a distancia especificada.
Use o control de mapa co control de entrada de enderezos
Pode engadir un botón á súa aplicación para gardar os enderezos introducidos como unha colección de datos. A continuación, pode recuperar os enderezos e mostralos no control do mapa.
Engada un control de mapa e un control de entrada de enderezo á súa aplicación.
Insira e coloque un control de botón.
Cambie a propiedade OnSelect do control de botón do xeito seguinte. (Suxestión: copie a fórmula e péguea na barra de fórmulas ou no separador de propiedades Avanzadas, o que prefira).
Insira unha lonxitude, latitude e radio (en metros).
O control comezará a buscar a latitude e a lonxitude, ata a distancia especificada no campo de radio.
If(IsBlank(AddressInput1.SearchResultJson), "", Collect(locations, {Latitude: AddressInput1.SelectedLatitude, Longitude: AddressInput1.SelectedLongitude}))A fórmula garda a latitude e a lonxitude actuais nunha colección chamada localizacións, sempre que os resultados da busca non estean en branco.
Seleccione o control do mapa. Cambie as súas propiedades do xeito seguinte:
Nome da propiedade Valor Onde Elementos "Localizacións" Ficha Propiedades ItemsLatitudes "Latitude" Ficha Avanzada ItemsLongitudes "Lonxitude" Ficha Avanzada
Cando o usuario selecciona o botón, o resultado do control de entrada de enderezos engadirase ao mapa como un novo marcador.
Propiedades
Cambie o comportamento e a aparencia dun control de entrada de enderezos mediante propiedades. Algunhas propiedades só están dispoñibles na pestana Avanzado.
| Propiedade | Descripción | Tipo | Tabulador |
|---|---|---|---|
| Default | Configura o valor inicial do control. | String | Propiedades; avanzado: Predeterminado |
| Texto de suxestión | Establece a suxestión que aparece no control antes de que o usuario introduza texto. | String | Propiedades; avanzadas: HintText |
| Tipo de letra | Establece o nome da familia de tipos de letra utilizada para o texto do control. | Lista despregable | Propiedades; avanzadas: Tipo de letra |
| Tamaño de tipo de letra | Configura o tamaño do texto do control. | Número de punto flotante | Propiedades; avanzadas: FontSize |
| Espesura do tipo de letra | Establece o peso do texto do control, negra, máis clara, normal ou seminegra. | Lista despregable | Propiedades; avanzadas: FontWeight |
| Aliñamento do texto | Establece o aliñamento horizontal do texto do control, Centro, Xustificar, Esquerda ou Dereita. | Lista despregable | Propiedades; avanzadas: TextAlignment |
| Altura da liña | Establece a distancia vertical entre as liñas de texto no control. | Número de punto flotante | Propiedades; avanzadas: LineHeight |
| Modo de visualización | Determina se o control permite a entrada do usuario (Editar), só mostra datos (Ver) ou está desactivado (Desactivado). | Lista despregable | Propiedades; avanzadas: DisplayMode |
| Estilo do tipo de letra | Establece o estilo do texto do control: Cursiva, Subliñado, Riscado ou ningún. | Lista despregable | Propiedades; avanzadas: Cursiva, Subliñado, Riscado |
| Límite de resultados da busca | Establece o número de enderezos suxeridos que mostra o control. | Número enteiro | Propiedades; Avanzadas: SearchResultLimit |
| Buscar dentro do radio | Determina se o control debe suxerir enderezos dentro do Radio da Latitude e Lonxitude. | Boolean | Propiedades; avanzado: SearchWithinRadius |
| Latitude | Establece a coordenada de latitude do punto central empregado para suxestións de enderezos. Require que Buscar dentro do radio estea activado. | Número de punto flotante de -90 a 90 | Propiedades; avanzada: Latitude |
| Lonxitude | Establece a coordenada de lonxitude do punto central empregado para suxestións de enderezos. Require que Buscar dentro do radio estea activado. | Número de punto flotante de -180 a 180 | Propiedades; avanzada: Lonxitude |
| Radio | Establece o radio, en metros, arredor da Latitude e Lonxitude para restrinxir as suxestións de enderezo. Require que Buscar dentro do radio estea activado. | Número de punto flotante | Propiedades; avanzada: Radio |
| Linguaxe | Establece o idioma no que se volverán as suxestións de enderezo. | String | Propiedades; avanzada: Idioma |
| Conxunto de países | Identifica unha lista de países/rexións separados por comas para limitar as suxestións de enderezos, en formato ISO 3166 alfa-2; por exemplo, US,CA,MX. | String | Propiedades; Avanzado: CountrySet |
| Visible | Mostra ou oculta o control. | Boolean | Propiedades; avanzadas: Visible |
| Enchemento superior | Establece a distancia entre o texto do control do botón e a parte superior do control. | Número de punto flotante | Propiedades; avanzadas: PaddingTop |
| Enchemento inferior | Establece a distancia entre o texto do control do botón e a parte inferior do control. | Número de punto flotante | Propiedades; avanzadas: PaddingBottom |
| Enchemento esquerdo | Establece a distancia entre o texto do control do botón e o bordo esquerdo do control. | Número de punto flotante | Propiedades; avanzadas: PaddingLeft |
| Enchemento dereito | Establece a distancia entre o texto do control do botón e o bordo dereito do control. | Número de punto flotante | Propiedades; avanzadas: PaddingRight |
| Posición | Coloca a esquina superior esquerda do control nas coordenadas da pantalla especificadas en X e Y. | Número enteiro | Propiedades; avanzado: X, Y |
| Tamaño | Determina o tamaño do control utilizando os valores de píxeles proporcionados en Anchura e Altura. | Número enteiro | Propiedades; avanzado: Largura, Altura |
| Radio do bordo | Determina o raio da esquina do bordo do control. | Número de punto flotante | Propiedades; avanzadas: BorderRadius |
| Color | Establece as cores do texto do control e o fondo do control. | Non aplicable | Propiedades; avanzadas: FillColor, TextColor |
| Bordo | Determina o estilo, o ancho e a cor do bordo do control. | Non aplicable | Propiedades; avanzadas: BorderStyle, BorderThickness, BorderColor |
| Índice de tabulación | Especifica a orde na que se selecciona o control se o usuario navega pola aplicación usando a tecla Tab. | Número enteiro | Propiedades; avanzadas: TabIndex |
| Información sobre ferramentas | Determina o texto que se mostrará cando o usuario pasa o rato sobre o control. | String | Propiedades; Avanzado: Información sobre ferramentas |
| Cor ao apuntar | Establece as cores do texto do control, o fondo do control e o bordo do control se o usuario pasa o cursor do rato sobre el. | Non aplicable | Propiedades; avanzadas: HoverFontColor, HoverFillColor, HoverBorderColor |
| Cor desactivado | Establece as cores do texto do control, o fondo do control e o bordo do control se DisplayMode está Desactivado. | Non aplicable | Propiedades; avanzadas: DisabledFontColor, DisabledFillColor, DisabledBorderColor |
| Cor ao premer | Establece as cores do texto do control, o fondo do control e o bordo do control se o usuario selecciona o control. | Non aplicable | Propiedades; avanzadas: PressedFontColor, PressedFillColor, PressedBorderColor |
| ContentLanguage | Determina o idioma de visualización do control, se é diferente do idioma que se usa na aplicación. | String | Avanzado |
| OnAddressSelect | Contén código que se executa cando o usuario selecciona un enderezo suxerido. | Evento | Avanzado |
| OnChange | Contén código que se executa cando se cambia a propiedade dun control. | Evento | Avanzado |
Propiedades de saída
Outras propiedades están dispoñibles cando un usuario interactúa co control de entrada de enderezos. Pode usar as propiedades de saída noutros controis ou para personalizar a experiencia da aplicación.
| Propiedade | Descripción |
|---|---|
| Entrada do usuario | O texto que o usuario escribiu na caixa de entrada |
| SelectedLatitude | A latitude do enderezo seleccionado polo usuario |
| SelectedLongitude | A lonxitude do enderezo seleccionado polo usuario |
| SearchResultJson | O resultado da busca, baseado en UserInput, mostrase como unha cadea en formato JSON |
| FreeformAddress | O enderezo seleccionado polo usuario da lista de enderezos suxeridos |
| LocalName | O nome dunha área xeográfica ou localidade que agrupa unha serie de obxectos direccionables con fins de dirección, sen ser unha unidade administrativa |
| PostalCode | Código postal |
| ExtendedPostalCode | Código postal estendido |
| CountryCode | Código do país |
| País | O nome do país/rexión |
| CountryCodeISO3 | Código de país en formato ISO alfa-3 |
| CountrySubdivisionName | O nome da subdivisión do país/rexión |
| StreetName | Nome da rúa |
| StreetNumber | Número da rúa |
| Municipio | Municipio |
| MunicipalitySubdivision | Subdivisión do municipio |
| CountryTertiarySubdivision | Subdivisión terciaria país/rexión |
| CountrySecondarySubdivision | Subdivisión secundaria país/rexión |
| CountrySubdivision | Subdivisión país/rexión |
Outros controis xeoespaciais
Para visualizar e interpretar datos de localización, use o control Mapa interactivo.
Nota
Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)
Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).