Използвайте контролата за въвеждане на адрес за лесно въвеждане на адреси
Въвеждането на адреси може да бъде разочароващо и податливо на грешки, особено при мобилни приложения. Използвайте контрола за въвеждане на адреси, за да улесните въвеждането на адреси. Контролът използва размита логика, за да предлага потенциални съвпадения, докато пишете. Изберете този, който искате, за да въведете бързо и лесно точен адрес.
Контролата връща адреса като структурирани данни. Вашето приложение може да извлича информация като град, улица, община и дори координати на ширина и дължина. Данните са във формат, подходящ за много локали и международни формати на адреси.
Предварителни изисквания
Преди да можете да използвате контрола в приложенията си, трябва да разрешите геопространствените функции за средата. Прегледайте предпоставките за използване на геопространствени контроли. Вижте таблицата за поверителност и сигурност за повече подробности относно използването на данни от контрола за въвеждане на адреси.
Добавяне на контрол за въвеждане на адрес в приложението
С приложение, отворено за редактиране в Power Apps Studio:
- Отворете раздела Вмъкване и разгънете Въвеждане.
- Изберете Въвеждане на адрес, за да поставите поле за въвеждане на адрес в екрана на приложението, или плъзнете елемента за управление към екрана, за да го позиционирате по-точно. Трябва да въведете поне три знака, включително едно число за контрола за въвеждане на адрес.
Задаване на радиус на търсене по подразбиране
По подразбиране контролата ще търси около местоположението на потребителя. Можете да прецизирате областта за търсене по подразбиране, за да стесните първоначалните резултати.
- На контрола за въвеждане на раздела Свойства на адреса, включете свойството Търсете в радиус.
- Въведете географска дължина, ширина и радиус в метри.
Контролерът ще започне да търси на зададените географска ширина и дължина до посоченото разстояние.
Използване на управлението на картата с управлението на входния адрес
Можете да добавите бутон към приложението си, за да запазите въведените адреси като колекция от данни. След това можете да изтеглите адресите и да ги покажете в контролата на картата.
Добавете контролен елемент за карта и контролен елемент за въвеждане на адрес към приложението си.
Вмъкнете и поставете контрола Бутон.
Променете свойството OnSelect на контролата на бутон, както следва. (Съвет: Копирайте формулата и я поставете в лентата за формули или в раздел свойства Разширено, което предпочитате.)
Въведете географска дължина, ширина и радиус (в метри).
Контролата ще започне да търси по географската ширина и дължина, до разстоянието, посочено в полето за радиус.
If(IsBlank(AddressInput1.SearchResultJson), "", Collect(locations, {Latitude: AddressInput1.SelectedLatitude, Longitude: AddressInput1.SelectedLongitude}))Формулата записва текущата географска ширина и дължина в колекция с име местоположения, стига резултатите от търсенето да не са празни.
Изберете контрола на карта. Променете свойствата, както следва:
Име на свойството Стойност Където Елементи „Местоположения” Раздел Свойства ItemsLatitudes „Географска ширина” Раздел Разширено ItemsLongitudes „Географска дължина” Раздел Разширено
Когато потребителят избере бутона, резултатът от контрола за въвеждане на адрес се добавя към картата като нов щифт.
Свойства
Променете поведението и външния вид на контрола за въвеждане на адрес с помощта на свойства. Някои имоти са налични само на Разширено раздел.
| Свойство | Описание | Тип | Табулатор |
|---|---|---|---|
| По подразбиране | Задава първоначалната стойност на контролата. | String | Свойства; Разширено: Default |
| Текст на подсказка | Задава подсказката, която се появява в контролата, преди потребителят да въведе текст. | String | Свойства; Разширено: HintText |
| Шрифт | Задава името на фамилията шрифтове, използвани за контролния текст. | Падащ списък | Свойства; Разширено: Font |
| Размер на шрифта | Задава размера на контролния текст. | Число с плаваща запетая | Свойства; Разширено: FontSize |
| Тежест на шрифт | Задава теглото на контролния текст - Удебелен, По-лек, Нормален или Полуудебелен. | Падащ списък | Свойства; Разширено: FontWeight |
| Подравняване на текст | Задава и хоризонталното подравняване на текста на контролата Център, Подравнен, Наляво или Надясно. | Падащ списък | Свойства; Разширено: TextAlignment |
| Височина на реда | Задава вертикалното разстояние между редовете на текста в контролата. | Число с плаваща запетая | Свойства; Разширено: LineHeight |
| Режим на показване | Определя дали контрола позволява въвеждане от потребителя (редактиране), показва само данни (изглед) или е деактивирана (забранено). | Падащ списък | Свойства; Разширено: DisplayType |
| Стил на шрифта | Задава стила на текста на текста на контролата - курсив, подчертаване, зачеркване или никакъв. | Падащ списък | Свойство; Разширено: Italic, Underline, Strikethrough |
| Ограничение на резултатите от търсенето | Задава броя на предложените адреси, които управлението показва. | Integer | Свойства; Разширено: SearchResultLimit |
| Търсене в радиус | Определя дали контролът трябва да предлага адреси в рамките на радиус от Географска ширина и Географска дължина. | Boolean | Свойства; Разширено: SearchWithinRadius |
| Географска ширина | Задава координатите на географската ширина на централната точка, използвана за предложения за адреси. Изисква Търсене в радиус да е включено. | Число с плаваща запетая от -90 до 90 | Свойства; Разширено: Latitude |
| Географска дължина | Задава координатите на географската дължина на централната точка, използвана за предложения за адреси. Изисква Търсене в радиус да е включено. | Число с плаваща запетая от -180 до 180 | Свойства; Разширено: Longitude |
| Радиус | Задава радиуса, в метри, около Географска ширина и Географска дължина за ограничаване на предложенията за адрес. Изисква Търсене в радиус да е включено. | Число с плаваща запетая | Свойства; Разширено: Radius |
| Език | Задава езика, на който се връщат предложенията за адреси. | String | Свойства; Разширено: Language |
| Набор от държави | Идентифицира разделен със запетая списък от страни/региони, до които да се ограничат предложенията за адреси, във формат ISO 3166 alpha-2; например, US,CA,MX. | String | Свойства; Разширено: CountrySet |
| Видим | Показва или скрива контролата. | Boolean | Свойства; Разширено: Visible |
| Допълване отгоре | Задава разстоянието между текста на контролата и горната част на контролата. | Число с плаваща запетая | Свойства; Разширено: PaddingTop |
| Допълване отдолу | Задава разстоянието между текста на контролата и долната част на контролата. | Число с плаваща запетая | Свойства; Разширено: PaddingBottom |
| Допълване отляво | Задава разстоянието между текста на контролата и левия край на контролата. | Число с плаваща запетая | Свойства; Разширено: PaddingLeft |
| Допълване отдясно | Задава разстоянието между контролния текст и десния край на контролата. | Число с плаваща запетая | Свойства; Разширено: PaddingRight |
| Позиция | Поставя горния ляв ъгъл на контролата в координатите на екрана, посочени в x и y. | Integer | Свойства; Разширено: X, Y |
| Размер | Определя размера на контрола, като използва стойностите на пикселите, предоставени в Ширина и Височина. | Integer | Свойства; Разширено: Width, Height |
| Радиус на граница | Определя радиуса на ъгъла на границата на контролата. | Число с плаваща запетая | Свойства; Разширено: BorderRadius |
| Цвят | Задава цветовете на контролния текст и на контролния фон. | Неприложимо | Свойства; Разширено: FillColor, TextColor |
| Граница | Определя стила, ширината и цвета на границата на контролата. | Неприложимо | Имоти; Разширено: BorderStyle, BorderThickness, BorderColor |
| Показалец на раздел | Указва реда, в който се избира контролата, ако потребителят навигира в приложението с помощта на клавиша Tab. | Integer | Свойства; Разширено: TabIndex |
| Пояснение | Определя текста, който ще се показва, когато потребителят се задържи върху контролата. | String | Свойства; Разширено: Tooltip |
| Цвят при посочване | Задава цветовете на текста на контролата, фона на контролата и рамката на контролата, когато потребителят задържи показалеца на мишката върху нея. | Неприложимо | Свойства; Разширено: HoverFontColor, HoverFillColor, HoverBorderColor |
| Цвят при забрана | Задава цветовете на текста на контролата, на фона на контролата и на рамката на контролата, ако DisplayMode е Disabled. | Неприложимо | Свойства; Разширено: DisabledFontColor, DisabledFillColor, DisabledBorderColor |
| Цвят при натискане | Задава цветовете на текста на контролата, на фона на контролата и на рамката на контролата, когато потребителят избере контролата. | Неприложимо | Свойства; Разширено: PressedFontColor, PressedFillColor, PressedBorderColor |
| ContentLanguage | Определя езика на показване на контролата, ако той е различен от езика, който се използва в приложението. | String | Напреднали |
| OnAddressSelect | Съдържа код, който се изпълнява, когато потребителят избере предложен адрес. | Събитие | Напреднали |
| OnChange | Съдържа код, който се изпълнява при промяна на свойство на контрола. | Събитие | Напреднали |
Изходни свойства
Други свойства стават достъпни, когато потребителят взаимодейства с контрола за въвеждане на адрес. Можете да използвате тези изходни свойства в други контроли или да персонализирате работата на приложението.
| Свойство | Описание |
|---|---|
| UserInput | Текстът, който потребителят е въвел в полето за въвеждане |
| SelectedLatitude | Географската ширина на адреса, който потребителят е избрал |
| SelectedLongitude | Географската дължина на адреса, който потребителят е избрал |
| SearchResultJson | Резултатът от търсенето, базиран на UserInput, се показва като низ във формат JSON |
| FreeformAddress | Адресът, който потребителят е избрал от списъка с предложени адреси |
| LocalName | Името на географска област или населено място, което групира редица адресируеми обекти за адресиране, без да е административна единица |
| PostalCode | Пощенският код |
| ExtendedPostalCode | Разширеният пощенски код |
| CountryCode | Кодът на държава |
| Страна/регион | Името на страната/региона |
| CountryCodeISO3 | Кодът на държавата във формат ISO alpha-3 |
| CountrySubdivisionName | Име на подразделението страна/регион |
| StreetName | Името на улица |
| StreetNumber | Номерът на улица |
| Община | Общината |
| MunicipalitySubdivision | Общинското подразделение |
| CountryTertiarySubdivision | Третично подразделение на страната/региона |
| CountrySecondarySubdivision | Вторично подразделение на страната/региона |
| CountrySubdivision | Подразделение на страната/региона |
Други геопространствени контроли
За да визуализирате и интерпретирайте данните за местоположението, използвайте контролата Интерактивна карта.
Бележка
Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)
Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).
Обратна връзка
Очаквайте скоро: През цялата 2024 г. постепенно ще отстраняваме проблемите в GitHub като механизъм за обратна връзка за съдържание и ще го заменим с нова система за обратна връзка. За повече информация вижте: https://aka.ms/ContentUserFeedback.
Подаване и преглед на обратна връзка за