Autocomplete
Chức năng /autocomplete
giúp người dùng tìm thấy những gì họ đang tìm kiếm mà không yêu cầu họ chỉ định đầy đủ nội dung tìm kiếm của họ.
URL
/api/autocomplete?focus.point.lat=
val
&focus.point.lon=val
&api-version=1.1&apikey=??&text=
Phương thức
GET
Tham số có sẵn
Tham số | Kiểu | Bắt buộc | Mặc định | Ví dụ |
---|---|---|---|---|
text | string | Có | none | Trần Phú |
focus.point.lat | floating point number | Không | none | 10.756271 |
focus.point.lon | floating point number | Không | none | 106.661280 |
boundary.rect.min_lon | floating point number | Không | none | 106.3564 |
boundary.rect.max_lon | floating point number | Không | none | 107.012794 |
boundary.rect.min_lat | floating point number | Không | none | 11.160291 |
boundary.rect.max_lat | floating point number | Không | none | 10.376715 |
boundary.circle.lat | floating point number | Không | none | 10.756271 |
boundary.circle.lon | floating point number | Không | none | 106.661280 |
boundary.circle.radius | floating point number | Không | 50 | 35 |
layers | string | Không | Tất cả các lớp: address,street,venue | address,venue |
size | integer | Không | 10 | 20 |
categories | string | Không | none | 1000,1005 Thông tin chi tiết về từng loại code của category ở đây |
Chức năng Filters
Chức năng lọc theo Layers
Dưới đây là danh sách các layer
bạn có thể tìm thấy trong kết quả, sắp xếp theo độ chi tiết:
layer | description |
---|---|
venue | tất cả mọi thứ trên đường: công ty, điểm nổi tiếng. . |
address | dữ liệu địa chỉ |
street | dữ liệu giao thông |
/api/autocomplete?focus.point.lat=
val
&focus.point.lon=val
&api-version=1.1&apikey=??&text= &layers=
layers=venue
bạn sẽ chỉ nhìn thấy các địa điểm có tên là ngân hàng
Chức năng lọc theo Global scope, local focus
Để tập trung tìm kiếm của bạn dựa trên một khu vực địa lý, chẳng hạn như trung tâm bản đồ của người dùng hoặc tại vị trí GPS của thiết bị, hãy cung cấp các tham số
focus.point.lat
vàfocus.point.lon
.Điều này làm tăng độ chính xác của kết quả tìm kiếm.
/api/autocomplete?focus.point.lat=
lat
&focus.point.lon=lng
&text=text
Chức năng lọc Search within a circular region
Đôi khi bạn có vị trí của điểm và một bán kính ta có thể tìm kiếm theo bán kính.
Trong ví dụ này, nếu bạn muốn tìm những điểm 193 Trần Phú trong bán kính 0.5 km. Bạn hãy dùng nhóm parameter boundary.circle.*
với boundary.circle.lat
và boundary.circle.lon
là vị trí của bạn, boundary.circle.radius
là bán kính tìm tính từ khoảng vị trí của điểm. Lưu ý boundary.circle.radius
luôn được tính theo kilometer.
parameter | value |
---|---|
text | 193 Trần Phú |
boundary.circle.lat | 10.756271 |
boundary.circle.lon | 106.661280 |
boundary.circle.radius | 0.5 |
Chức năng lọc theo phân loại Search within categories
Đôi khi bạn nuốm tìm theo loại điểm.
Trong ví dụ này, nếu bạn muốn tìm điểm là Nhà Hàng
thì code của nó là 1002
bạn có thể truy xuất code dựa vào đính kèm ở đây
parameter | value |
---|---|
text | 193 Trần Phú |
categories | 1002 |