Chia sẻ qua


Sử dụng điều khiển nhập địa chỉ để dễ dàng nhập địa chỉ

Việc nhập địa chỉ có thể rất khó chịu và dễ bị lỗi, đặc biệt là trên thiết bị di động. Sử dụng điều khiển nhập địa chỉ để dễ dàng nhập địa chỉ hơn. Điều khiển sử dụng logic kết hợp mờ để đề xuất các kết quả phù hợp tiềm năng khi bạn nhập. Chọn địa chỉ bạn muốn nhanh chóng và dễ dàng nhập địa chỉ chính xác.

Điều khiển trả về địa chỉ dưới dạng dữ liệu có cấu trúc. Ứng dụng của bạn có thể trích xuất thông tin như thành phố, đường phố, đô thị và thậm chí cả tọa độ kinh độ và vĩ độ. Dữ liệu đó có định dạng phù hợp với nhiều định dạng địa chỉ quốc tế và địa phương.

Điều kiện tiên quyết

Trước khi có thể sử dụng tính năng kiểm soát trong ứng dụng, bạn cần phải bật các tính năng không gian địa lý cho môi trường. Đảm bảo rằng bạn cũng xem xét các điều kiện tiên quyết để sử dụng các điều khiển không gian địa lý. Tham khảo bảng quyền riêng tư và bảo mật để biết thêm chi tiết về cách sử dụng dữ liệu của kiểm soát đầu vào địa chỉ.

Thêm tùy chọn kiểm soát đầu vào địa chỉ vào ứng dụng của bạn

Với ứng dụng của bạn mở để chỉnh sửa trong Power Apps Studio:

  1. Mở tab Chèn và mở rộng Đầu vào.
  2. Chọn Nhập địa chỉ để đặt hộp nhập địa chỉ vào màn hình ứng dụng hoặc kéo điều khiển vào màn hình để định vị chính xác hơn. Bạn phải nhập ít nhất ba ký tự bao gồm một số cho điều khiển nhập địa chỉ.

Đặt bán kính tìm kiếm mặc định

Theo mặc định, điều khiển sẽ tìm kiếm xung quanh vị trí của người dùng. Bạn có thể tinh chỉnh khu vực tìm kiếm mặc định để giúp thu hẹp kết quả ban đầu.

  1. Trên tab Thuộc tính của điều khiển nhập địa chỉ, hãy bật thuộc tính Tìm kiếm trong bán kính .
  2. Nhập kinh độ, vĩ độ và bán kính tính bằng mét.

Kiểm soát sẽ bắt đầu tìm kiếm ở vĩ độ và kinh độ cho trước, đến khoảng cách được chỉ định.

Sử dụng kiểm soát bản đồ với kiểm soát đầu vào địa chỉ

Bạn có thể thêm một nút vào ứng dụng của mình để lưu các địa chỉ đã nhập làm tập hợp dữ liệu. Sau đó, bạn có thể lấy địa chỉ và hiển thị chúng trong bản đồ điều khiển.

  1. Thêm tùy chọn kiểm soát bản đồ và kiểm soát đầu vào địa chỉ vào ứng dụng của bạn.

  2. Chèn và đặt nút điều khiển .

  3. Thay đổi thuộc tính OnSelect của nút điều khiển như sau. (Gợi ý: Sao chép công thức và dán vào thanh công thức hoặc trên tab thuộc tính Nâng cao , tùy theo sở thích của bạn.)

  4. Nhập kinh độ, vĩ độ và bán kính (tính bằng mét).

    Kiểm soát sẽ bắt đầu tìm kiếm ở vĩ độ và kinh độ, đến khoảng cách được chỉ định trong trường bán kính.

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

    Công thức này lưu vĩ độ và kinh độ hiện tại vào một bộ sưu tập có tên là vị trí, miễn là kết quả tìm kiếm không trống.

    Ảnh chụp màn hình nút đang được xây dựng trong  Power Apps Studio, hiển thị cùng với thuộc tính OnSelect của nút này.

  5. Chọn công cụ điều khiển bản đồ. Thay đổi các thuộc tính như sau:

    Tên thuộc tính Giá_trị Trong đó
    Mục "Locations" Tab Thuộc tính
    ItemsLatitudes "Latitude" Tab nâng cao
    ItemsLongitudes "Longitude" Tab nâng cao

Khi người dùng chọn nút, kết quả từ kiểm soát đầu vào địa chỉ sẽ được thêm vào bản đồ dưới dạng ghim mới.

Thuộc tính

Thay đổi hành vi và giao diện của kiểm soát đầu vào địa chỉ thông qua phần thuộc tính. Một số thuộc tính chỉ khả dụng trên tab Nâng cao .

Thuộc tính Description Loại Tab
Mặc định Đặt giá trị ban đầu của điều khiển. String Thuộc tính; Nâng cao: Mặc định
Văn bản gợi ý Đặt gợi ý xuất hiện trong điều khiển trước khi người dùng nhập văn bản. String Thuộc tính; Nâng cao: HintText
Phông chữ Đặt tên của họ phông chữ được sử dụng cho văn bản điều khiển. Danh sách thả xuống Thuộc tính; Nâng cao: Phông chữ
Cỡ phông chữ Đặt kích thước của văn bản điều khiển. Số thực dấu phẩy động Thuộc tính; Nâng cao: FontSize
Độ dày chữ Đặt độ đậm của văn bản điều khiển, có thể là Đậm, Nhạt hơn, Bình thường hoặc Nửa đậm. Danh sách thả xuống Thuộc tính; Nâng cao: FontWeight
Lề chữ Thiết lập căn chỉnh theo chiều ngang của văn bản điều khiển, có thể là Căn giữa, Căn đều, Trái hoặc Phải. Danh sách thả xuống Thuộc tính; Nâng cao: Căn chỉnh văn bản
Chiều cao dòng Đặt khoảng cách theo chiều dọc giữa các dòng văn bản trong điều khiển. Số thực dấu phẩy động Thuộc tính; Nâng cao: LineHeight
Chế độ hiển thị Xác định xem điều khiển có cho phép người dùng nhập dữ liệu (Chỉnh sửa), chỉ hiển thị dữ liệu (Xem) hay bị vô hiệu hóa (Đã vô hiệu hóa). Danh sách thả xuống Thuộc tính; Nâng cao: DisplayMode
Kiểu phông Đặt kiểu của văn bản điều khiển, có thể là In nghiêng, Gạch chân, Gạch ngang hoặc không có. Danh sách thả xuống Thuộc tính; Nâng cao: In nghiêng, Gạch chân, Gạch ngang
Giới hạn kết quả tìm kiếm Đặt số lượng địa chỉ được gợi ý mà điều khiển hiển thị. Số nguyên Thuộc tính; Nâng cao: SearchResultLimit
Tìm trong bán kính Xác định xem bộ điều khiển có nên đề xuất các địa chỉ trong phạm vi Bán kính của Vĩ độKinh độ hay không. Boolean Thuộc tính; Nâng cao: Tìm kiếm trong phạm vi bán kính
Vĩ độ Đặt tọa độ vĩ độ của tâm điểm được sử dụng cho các gợi ý địa chỉ. Yêu cầu phải bật Tìm kiếm trong bán kính . Số thực dấu phẩy động. từ -90 đến 90 Thuộc tính; Nâng cao: Vĩ độ
Kinh độ Đặt tọa độ kinh độ của tâm điểm được sử dụng cho các gợi ý địa chỉ. Yêu cầu phải bật Tìm kiếm trong bán kính . Số thực dấu phẩy động. từ -180 đến 180 Thuộc tính; Nâng cao: Kinh độ
Bán kính Đặt bán kính, tính bằng mét, xung quanh Vĩ độKinh độ để hạn chế các gợi ý địa chỉ. Yêu cầu phải bật Tìm kiếm trong bán kính . Số thực dấu phẩy động Thuộc tính; Nâng cao: Bán kính
Ngôn ngữ Đặt ngôn ngữ dùng để trả lại các gợi ý địa chỉ. String Thuộc tính; Nâng cao: Ngôn ngữ
Tập hợp quốc gia Xác định danh sách các quốc gia/khu vực được phân tách bằng dấu phẩy để giới hạn các đề xuất địa chỉ theo định dạng ISO 3166 alpha-2; ví dụ: US,CA,MX. String Thuộc tính; Nâng cao: CountrySet
Hiển thị Hiển thị hoặc ẩn điều khiển. Boolean Thuộc tính; Nâng cao: Có thể nhìn thấy
Phần đệm trên cùng Đặt khoảng cách giữa văn bản điều khiển và phần trên điều khiển. Số thực dấu phẩy động Thuộc tính; Nâng cao: PaddingTop
Phần đệm dưới cùng Đặt khoảng cách giữa văn bản điều khiển và phần dưới điều khiển. Số thực dấu phẩy động Thuộc tính; Nâng cao: PaddingBottom
Phần đệm bên trái Đặt khoảng cách giữa văn bản điều khiển và cạnh trái điều khiển. Số thực dấu phẩy động Thuộc tính; Nâng cao: PaddingLeft
Phần đệm bên phải Đặt khoảng cách giữa văn bản điều khiển và cạnh phải điều khiển. Số thực dấu phẩy động Thuộc tính; Nâng cao: PaddingRight
Vị trí Đặt góc trên bên trái của điều khiển tại tọa độ màn hình được chỉ định trong XY. Số nguyên Thuộc tính; Nâng cao: X, Y
Kích cỡ Xác định kích thước của điều khiển bằng cách sử dụng các giá trị pixel được cung cấp trong Chiều rộngChiều cao. Số nguyên Thuộc tính; Nâng cao: Chiều rộng, Chiều cao
Bán kính viền Xác định bán kính góc của đường viền điều khiển. Số thực dấu phẩy động Thuộc tính; Nâng cao: BorderRadius
Màu sắc Đặt màu sắc của văn bản điều khiển và nền điều khiển. Không áp dụng Của cải; Nâng cao: FillColor, TextColor
Viền Xác định kiểu, chiều rộng và màu sắc của đường viền điều khiển. Không áp dụng Thuộc tính; Nâng cao: BorderStyle, BorderThickness, BorderColor
Chỉ mục tab Chỉ định thứ tự điều khiển được chọn nếu người dùng điều hướng ứng dụng bằng phím Tab. Số nguyên Thuộc tính; Nâng cao: TabIndex
Mách nước Xác định văn bản để hiển thị khi người dùng di chuột qua điều khiển. String Thuộc tính; Nâng cao: Công cụ chú giải
Màu khi di chuột lên Đặt màu của văn bản điều khiển, nền điều khiển và đường viền điều khiển khi người dùng di con trỏ chuột qua nó. Không áp dụng Thuộc tính; Nâng cao: HoverFontColor, HoverFillColor, HoverBorderColor
Màu khi tắt Đặt màu cho văn bản điều khiển, nền điều khiển và đường viền điều khiển nếu DisplayMode bị Tắt. Không áp dụng Thuộc tính; Nâng cao: TắtFontColor, TắtFillColor, TắtBorderColor
Màu khi nhấn chuột lên Đặt màu của văn bản điều khiển, nền điều khiển và đường viền điều khiển khi người dùng chọn điều khiển. Không áp dụng Thuộc tính; Nâng cao: PressedFontColor, PressedFillColor, PressedBorderColor
ContentLanguage Xác định ngôn ngữ hiển thị của mục kiểm soát, nếu khác với ngôn ngữ được sử dụng trong ứng dụng. String Nâng cao
OnAddressSelect Chứa mã chạy khi người dùng chọn địa chỉ gợi ý. Sự kiện Nâng cao
OnChange Chứa mã chạy khi thuộc tính điều khiển thay đổi. Sự kiện Nâng cao

Thuộc tính đầu ra

Các thuộc tính khác sẽ khả dụng khi người dùng tương tác với điều khiển đầu vào địa chỉ. Bạn có thể sử dụng các thuộc tính đầu ra này trong các điều khiển khác hoặc để tùy chỉnh trải nghiệm ứng dụng.

Thuộc tính Description
Nội dung người dùng nhập Văn bản người dùng đã nhập trong ô nhập
Vĩ độ đã chọn Vĩ độ của địa chỉ mà người dùng đã chọn
Kinh độ đã chọn Kinh độ của địa chỉ mà người dùng đã chọn
Json của kết quả tìm kiếm Kết quả tìm kiếm, dựa trên UserInput, được hiển thị dưới dạng chuỗi ở định dạng JSON
FreeformAddress Địa chỉ người dùng đã chọn từ danh sách các địa chỉ được đề xuất
LocalName Tên của một khu vực địa lý hoặc địa phương nhóm một số đối tượng có địa chỉ cho các mục đích ghi địa chỉ, mà không phải là một đơn vị quản trị
PostalCode Mã bưu chính
ExtendedPostalCode Mã bưu chính mở rộng
CountryCode Mã quốc gia
Quốc gia Tên quốc gia/khu vực
CountryCodeISO3 Mã quốc gia ở định dạng ISO alpha-3
CountrySubdivisionName Tên phân khu quốc gia/khu vực
StreetName Tên phố
StreetNumber Số phố
Đô thị tự quản Đô thị tự quản
MunicipalitySubdivision Đơn vị hành chính của đô thị tự quản
CountryTertiarySubdivision Phân khu cấp ba của quốc gia/khu vực
CountrySecondarySubdivision Phân khu thứ cấp quốc gia/khu vực
CountrySubdivision Phân vùng quốc gia/khu vực

Kiểm soát không gian địa lý khác

Để trực quan hóa và diễn giải dữ liệu vị trí, hãy sử dụng điều khiển bản đồ tương tác .