Бөлісу құралы:


Мекенжайларды оңай енгізу үшін address input басқару элементін пайдалану

Мекенжайларды енгізу, әсіресе мобильді құрылғы бағдарламаларында қолайсыз және қателік тудыруы мүмкін. Мекенжайды енгізуді жеңілдету үшін address input басқару элементін пайдаланыңыз. Басқару элементі теру кезінде ықтимал сәйкестіктерді ұсыну үшін анық емес логиканы пайдаланады. Нақты мекенжай ретінде жылдам және оңай енгізгіңіз келетінін нұсқаны таңдаңыз.

Басқару элементі мекенжайды құрылымдық деректер ретінде қайтарады. Бағдарламаңыз қала, көше, аудан, тіпті ендік пен бойлық координаталары сияқты ақпаратты ала алады. Деректер көптеген тілдерге және халықаралық мекенжай пішімдеріне қолайлы болып келетін пішімде берілген.

Алғышарттар

Бағдарламаларыңызда басқару элементін қолданар алдында орта үшін геокеңістіктік мүмкіндіктерді қосу керек. Сондай-ақ геокеңістіктік басқару элементтерін пайдалануға арналған алғышарттарды алдын ала қарап шығыңыз. Address input басқару деректерін пайдалану туралы қосымша мәлімет алу үшін құпиялылық және қауіпсіздік кестесін қараңыз.

Бағдарламаңызға address input басқару элементін қосу

Power Apps Studio бағдарламасында өңдеу үшін ашылған бағдарлама арқылы келесі әрекеттерді орындаңыз:

  1. Кірістіру қойыншасын ашып, Кіріс мәзірін кеңейтіңіз.
  2. Мекенжайды енгізу өрісін бағдарлама экранына орналастыру үшін Мекенжайды енгізу пәрменін таңдаңыз немесе дәлірек орналастыру үшін басқару элементін экранға сүйреңіз. Address input басқару элементі үшін бір санды қоса алғанда, кемінде үш таңбаны енгізу керек.

Әдепкі іздеу радиусын орнатыңыз

Әдепкі бойынша басқару элементі пайдаланушының орналасқан жері айналасында іздейді. Бастапқы нәтижелерді тарылту үшін әдепкі іздеу аймағын нақтылауға болады.

  1. Address input (мекенжайды енгізу) басқару элементінің Сипаттар қойыншасында Search within radius (Радиуста іздеу) сипатын қосыңыз.
  2. Бойлық, ендік және радиус мәнін метр өлшемінде енгізіңіз.

Басқару элементі көрсетілген қашықтықта берілген ендік пен бойлық бойынша іздей бастайды.

Map басқару элементін address input басқару элементімен бірге пайдалану

Енгізілген мекенжайларды деректер жинағы ретінде сақтау үшін бағдарламаңызға түймешікті қосуға болады. Содан кейін сіз бұл мекенжайларды шығарып, оларды map басқару элементінде көрсете аласыз.

  1. Бағдарламаңызға map басқару элементін және address input басқару элементін қосыңыз.

  2. Button басқару элементін кірістіріп, орналастырыңыз.

  3. Button басқару элементінің OnSelect сипатын келесідей өзгертіңіз. (Кеңес: формуланы көшіріп, формула жолағына немесе Кеңейтілген сипаттар қойыншасына қалауыңызша қойыңыз.)

  4. Бойлық, ендік және радиус енгізіңіз (метрмен).

    Басқару элементі радиус өрісінде көрсетілген қашықтыққа ендік пен бойлық бойынша іздей бастайды.

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

    Формула ағымдағы ендік пен бойлықты іздеу нәтижелері бос болғанға дейін орындар атаулы жинаққа сақтайды.

    OnSelect сипаты көрсетілген Power Apps Studio бағдарламасында жасалып жатқан түймешік скриншоты.

  5. Map басқару элементін таңдаңыз. Cипаттарын келесідей өзгертіңіз:

    Сипат атауы Value Қайда
    Элементтер "Locations" Сипаттар қойыншасы
    ItemsLatitudes "Latitude" Кеңейтілген қойыншасы
    ItemsLongitudes "Longitude" Кеңейтілген қойыншасы

Пайдаланушы түймені таңдағанда, address input басқару элементінің нәтижесі картаға жаңа түйреуіш ретінде қосылады.

Сипаттар

Сипаттар арқылы address input (мекенжайды енгізу) басқару элементінің әрекетін және көрінісін өзгертіңіз. Кейбір сипаттар тек Кеңейтілген қойыншасында қолжетімді.

Сипат Сипаттама Түр Табуляция
Әдепкі Басқару элементінің бастапқы мәнін орнатады. String Сипаттар; Кеңейтілген: Default
Сөзкөмек мәтіні Пайдаланушы мәтінді енгізгенге дейін басқару элементінде пайда болатын сөзкөмекті орнатады. String Сипаттар; Кеңейтілген: HintText
Қаріп Басқару элементінің мәтіні үшін пайдаланылатын қаріптер тобының атауын орнатады. Ашылмалы тізім Сипаттар; Кеңейтілген: Font
Қаріп өлшемі Басқару элементі мәтінінің өлшемін орнатады. Қалқымалы нүкте саны Сипаттар; Кеңейтілген: FontSize
Қаріп қанықтылығы Басқару элементі мәтінінің қанықтығын орнатады: Bold (Қалың), Lighter (Ашықтау), Normal (Қалыпты) немесе Semibold (Жартылай қалың). Ашылмалы тізім Сипаттар; Кеңейтілген: FontWeight
Мәтінді туралау Басқару элементі мәтінінің көлденең туралануын орнатады: Ортасында, Ені бойынша, Сол жақта немесе Оң жақта. Ашылмалы тізім Сипаттар; Кеңейтілген: TextAlignment
Жол биіктігі Басқару элементінің мәтін жолдары арасындағы тік қашықтықты орнатады. Қалқымалы нүкте саны Сипаттар; Кеңейтілген: LineHeight
Дисплей режимі Басқару элементі пайдаланушыға деректерді енгізуге (Edit), тек көрсетуге (View) рұқсат ететінін немесе деректердің өшірілген (Disabled) күйін анықтайды. Ашылмалы тізім Сипаттар; Кеңейтілген: DisplayMode
Қаріп стилі Басқару элементі мәтінінің стилін орнатады: Қиғаш, Асты сызылған, Сызылған немесе ешқайсысы. Ашылмалы тізім Сипаттар; Кеңейтілген: Italic, Underline, Strikethrough
Іздеу нәтижелерінің шегі Басқару элементі көрсететін ұсынылған мекенжайлардың санын орнатады. Бүтін сан Сипаттар; Кеңейтілген: SearchResultLimit
Радиус ішінде іздеу Басқару элементінің мекенжайларды Ендік және Бойлық бойынша Радиус параметрінде ұсыну қажеттігін анықтайды. Boolean Сипаттар; Кеңейтілген: SearchWithinRadius
Ендік Мекенжай ұсыныстары үшін қолданылатын орталық нүктенің ендік координатын орнатады. Радиуста іздеу сипаты болуы қажет. –90-нан 90-ға дейін қалқымалы үтірі бар сан Сипаттар; Кеңейтілген: Latitude
Бойлық Мекенжай ұсыныстары үшін қолданылатын орталық нүктенің бойлық координатын орнатады. Радиуста іздеу сипаты болуы қажет. –180-нен 180-ге дейін қалқымалы үтірі бар сан Сипаттар; Кеңейтілген: Longitude
Радиус Мекенжай ұсыныстарын шектеу үшін Ендік және Бойлық сипатының шамасында метрмен берілген радиусты орнатады. Радиуста іздеу сипаты болуы қажет. Қалқымалы нүкте саны Сипаттар; Кеңейтілген: Radius
Тіл Мекенжай ұсыныстары қайтарылатын тілді орнатады. String Сипаттар; Кеңейтілген: Language
Елдер жинағы ISO 3166 альфа-2 пішімінде мекенжай ұсыныстарын шектеу үшін үтірмен бөлінген елдердің/аймақтардың тізімін анықтайды; мысалы, US,CA,MX. String Сипаттар; Кеңейтілген: CountrySet
Көрінеді Басқару элементін көрсетеді немесе жасырады. Boolean Сипаттар; Кеңейтілген: Visible
Жоғарғы толтыру өрісі Басқару элементінің мәтіні мен оның жоғарғы жағы арасындағы қашықтықты орнатады. Қалқымалы нүкте саны Сипаттар; Кеңейтілген: PaddingTop
Төменгі толтыру өрісі Басқару элементінің мәтіні мен оның төменгі жағы арасындағы қашықтықты орнатады. Қалқымалы нүкте саны Сипаттар; Кеңейтілген: PaddingBottom
Сол жақ толтыру өрісі Басқару элементінің мәтіні мен оның сол жақ жиегі арасындағы қашықтықты орнатады. Қалқымалы нүкте саны Сипаттар; Кеңейтілген: PaddingLeft
Оң жақ толтыру өрісі Басқару элементінің мәтіні мен оның оң жақ жиегі арасындағы қашықтықты орнатады. Қалқымалы нүкте саны Сипаттар; Кеңейтілген: PaddingRight
Орналасу Басқару элементінің жоғарғы сол жақ бұрышын X және Y тармағында көрсетілген экран координаттарына орналастырады. Бүтін сан Сипаттар; Кеңейтілген: X, Y
Өлшем Width (Ені) және Height (Биіктігі) тармағында берілген пиксель мәндерін пайдаланып басқару элементінің өлшемін анықтайды. Бүтін сан Сипаттар; Кеңейтілген: Width, Height
Жиек радиусы Басқару элементі жиегінің бұрыштық радиусын анықтайды. Қалқымалы нүкте саны Сипаттар; Кеңейтілген: BorderRadius
Түс Басқару элементінің мәтіні мен фонының түстерін орнатады. Қолданылмайды Сипаттар; Кеңейтілген: FillColor, TextColor
Жиек Басқару элементі жиегінің стилін, енін және түсін анықтайды. Қолданылмайды Сипаттар; Кеңейтілген: BorderStyle, BorderThickness, BorderColor
Қойынша индексі Пайдаланушы Tab пернесін пайдаланып бағдарламаны шарласа, басқару элементін таңдау ретін көрсетеді. Бүтін сан Сипаттар; Кеңейтілген: TabIndex
Кеңес Пайдаланушы басқару элементінің үстіне курсорды апарған кезде көрсетілетін мәтінді анықтайды. String Сипаттар; Кеңейтілген: Tooltip
Түсті апару Пайдаланушы курсорды басқару элементінің үстіне апарғанда, оның мәтінінің, фонының және жиегінің түстерін орнатады. Қолданылмайды Сипаттар; Кеңейтілген: HoverFontColor, HoverFillColor, HoverBorderColor
Өшірілген түс DisplayModeопциясы Өшірілген күйінде болғанда, басқару элементі мәтінінің, фонының және жиегінің түстерін орнатады. Қолданылмайды Сипаттар; Кеңейтілген: DisabledFontColor, DisabledFillColor, DisabledBorderColor
Басылған түс Пайдаланушы басқару элементін таңдағанда, оның мәтінінің, фонының және жиегінің түстерін орнатады. Қолданылмайды Сипаттар; Кеңейтілген: PressedFontColor, PressedFillColor, PressedBorderColor
ContentLanguage Басқару элементі бағдарламада пайдаланылатын тілден өзгеше болса, басқару элементі көрсетілетін тілді анықтайды. String Жетілдірілген
OnAddressSelect Пайдаланушы ұсынылған мекенжайды таңдаған кезде іске қосылатын кодты қамтиды. Оқиға Жетілдірілген
OnChange Басқару элементінің сипаты өзгертілген кезде іске қосылатын кодты қамтиды. Оқиға Жетілдірілген

Шығыс сипаттар

Пайдаланушы address input басқару элементімен әрекеттескенде басқа сипаттар қолжетімді болады. Осы шығыс сипаттарды басқа басқару элементтерінде немесе бағдарлама тәжірибесін реттеу үшін пайдалана аласыз.

Сипат Сипаттама
Пайдаланушы енгізуі Пайдаланушы енгізу жолағына терген мәтін
Таңдалған ендік Пайдаланушы таңдаған мекенжайдың ендігі
Таңдалған бойлық Пайдаланушы таңдаған мекенжайдың бойлығы
SearchResultJson UserInput негізінде іздеу нәтижесі JSON пішімінде жол                                                                                                                                            көңет
FreeformAddress Пайдаланушы ұсынылған мекенжайлар тізімінен таңдаған мекенжай
LocalName Мекенжай тағайындау мақсаттары үшін бірқатар мекенжай тағайындалатын нысандарды топтастыратын, бірақ әкімшілік бірлік болып табылмайтын географиялық аймақ немесе елді мекеннің атауы
PostalCode Пошта индексі
ExtendedPostalCode Кеңейтілген пошта индексі
CountryCode Ел коды
Ел Ел/аймақ атауы
CountryCodeISO3 ISO alpha-3 пішіміндегі ел коды
CountrySubdivisionName Ел/аймақ бөлімшесінің атауы
StreetName Көше атауы
StreetNumber Көше нөмірі
Муниципалитет Муниципалитет
MunicipalitySubdivision Муниципалитет бөлімшесі
CountryTertiarySubdivision Ел/аймақ үшінші бөлімше
CountrySecondarySubdivision Ел/аймақ қосалқы бөлімшесі
CountrySubdivision Ел/аймақ бөлімшесі

Басқа геокеңістіктік басқару элементтері

Орын деректерін көрнекілеу және түсіндіру үшін, interactive map басқару элементін пайдаланыңыз.

Ескерім

Сіз құжат тіліңіздің артықшылықтары туралы айта аласыз ба? Қысқа сауалнамаға қатысыңыз. (бұл сауалнама ағылшын тілінде екеніне назар аударыңыз)

Сауалнама шамамен жеті минут уақытыңызды алады. Жеке деректер жиналмайды (құпиялылық туралы мәлімдеме).