Trong tài liệu này, bạn sẽ tìm hiểu cách sử dụng API Tìm kiếm lân cận (Mới) để xây dựng một API tìm kiếm đơn giản và tiết kiệm chi phí
trải nghiệm khám phá địa phương.
Trải nghiệm khám phá địa phương cho người dùng thấy những địa điểm yêu thích chính gần một vị trí mà bạn chỉ định khi tìm kiếm khách sạn hoặc bất động sản. Tệp này thường bao gồm một bản đồ tương tác, với một bảng điều khiển bổ sung có chứa trình chọn địa điểm và thư viện ảnh. Bạn sẽ được giới thiệu các sản phẩm và khả năng khác nhau của Nền tảng Google Maps để nâng cao trải nghiệm thông qua tính tương tác.
Trường hợp Sử dụng
Bây giờ, hãy cùng tìm hiểu những yếu tố nào của hoạt động tích hợp khám phá cục bộ thúc đẩy giá trị người dùng:
Khám phá – Cung cấp cho người dùng thông tin tổng quan về những gì xung quanh một vị trí bằng cách hiển thị các địa điểm có liên quan thuộc nhiều loại.
Tương tác – Cho phép người dùng chọn một địa điểm và linh động làm mới dữ liệu
so với địa điểm đó.
Hình ảnh trực quan – Cung cấp bài đánh giá và hình ảnh về địa điểm
và thời gian đi bộ cũng như quãng đường để người dùng nhanh chóng hiểu được liệu có phù hợp với nhu cầu của họ hay không.
Cấu trúc tham chiếu
Khám phá tại địa phương
Có nhiều cách để tạo nên một trải nghiệm khám phá địa phương. Quy trình tích hợp sau đây là ví dụ tuỳ chỉnh về trải nghiệm người dùng tận dụng các API nổi tiếng của Nền tảng Google Maps cũng như một số tính năng mới thú vị. Nếu muốn sử dụng phương pháp khám phá cục bộ theo mẫu, bạn có thể sử dụng Thành phần web.
Ứng dụng mẫu
Hướng dẫn từng bước về mẫu
Bạn sẽ tìm thấy trong bảng bên dưới ứng dụng mẫu được chia thành các bước cùng với nội dung mô tả về việc triển khai kỹ thuật bằng các API Nền tảng Google Maps.
1. Tìm kiếm vị trí với vị trí tự động hoàn thành trong Tìm kiếm
- Tải API JavaScript của Maps.
- Truy vấn Tự động hoàn thành theo địa điểm hoặc chọn vị trí trên bản đồ.
2. Giới thiệu các địa điểm yêu thích tại địa phương bằng API Tìm kiếm lân cận (Mới)
- Xếp hạng mức độ phổ biến (kết quả có liên quan hơn) hoặc Xếp hạng khoảng cách.
includedTypes
,excludedTypes
; nếu là khách sạn, bạn có thể loại trừ loại "nhà nghỉ" và chỉ bao gồm những loại phù hợp, tức là: "nhà hàng, quán cà phê, công viên, tourit_attraction".- Tận dụng
includedPrimaryTypes
,excludedPrimaryTypes
để có nhiều quyền kiểm soát hơn nữa đối với kết quả. - "locationHạn chế" để tránh số lượng kết quả không đủ hoặc vị trí quá xa; trong trường hợp ZERO kết quả, hãy mở rộng kích thước vòng tròn / hình chữ nhật trước khi hiển thị kết quả.
Mẫu truy vấn khi đặt phòng khách sạn có các trường Dữ liệu được yêu cầu:
- Cơ bản (
displayName
,types
,openingHours
,formattedAddress
) - Liên hệ (
websiteUri
,nationalPhoneNumber
,internationalPhoneNumber
) - Nên dùng (
reviews
,priceLevel
,userRatingCount
)
{ "includedTypes": ["restaurant","cafe","park"], "excludedTypes": ["lodging","convenience_store"], "includedPrimaryTypes": ["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes": ["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }
Ví dụ về truy vấn khi tìm kiếm một bất động sản trong đó các trường Dữ liệu được yêu cầu:
- Cơ bản (
displayName
,types
,openingHours
,formattedAddress
)
{ "includedTypes": ["school","transport","bus","convenience_store"], "excludedTypes": ["lodging"], "includedPrimaryTypes": ["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes": ["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }
3. Thêm tương tác bằng API động và API Chỉ đường
- Cập nhật thông tin về đoạn đường và số bước bằng cách truy vấn API Chỉ đường. * Sử dụng thời gian trong phần tiếp theo.
4. Hiển thị thông tin chi tiết về địa điểm khi tương tác
Nội dung mô tả:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Thời gian: lấy từ truy vấn API hướng dẫn trước đó.
Bài đánh giá:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.Hình ảnh: trong Xem trước không hạn chế của API Tìm kiếm lân cận (Mới), bạn sẽ phải truy vấn Thông tin chi tiết về địa điểm bằng
place.id
để tải photo_reference rồi truy vấn lần lượt từng địa điểm trong trải nghiệm của bạn
Số lượng truy vấn và chi phí được liên kết
- API JavaScript của Maps: 1 bản đồ khi tải trải nghiệm.
- API Tự động hoàn thành của địa điểm: 1 truy vấn cho mỗi ký tự đã nhập (nếu dùng Tiện ích tự động hoàn thành), thì bạn có thể tuỳ chỉnh API này.
- API Tìm kiếm lân cận (Mới): cứ 20 vị trí được hiển thị thì sẽ có 1 truy vấn. Hệ thống thanh toán khác nhau theo Dữ liệu địa điểm thuộc nội dung phản hồi truy vấn.
- Direction API (API Chỉ đường): 1 truy vấn ở mỗi địa điểm do người dùng chọn.
- Place Photo API (API địa điểm ảnh): 1 truy vấn mỗi ảnh hiển thị.
Kết luận
Trải nghiệm khám phá địa phương là cách hiệu quả để mang lại giá trị cho người dùng. Quá trình triển khai minh hoạ này có nhiều tính năng mà bạn có thể đưa vào khi tạo trải nghiệm như vậy trên Nền tảng Google Maps nhờ các tính năng đặc biệt của API Tìm kiếm lân cận (Mới) .
Các bước tiếp theo
Bạn nên đọc thêm:
- Thành phần web trong Maps JavaScript API
- Tối ưu hoá tính năng tự động hoàn thành dành cho địa điểm
- Dịch vụ địa điểm khác
- Hãy để lại ý kiến phản hồi bên dưới.
Người đóng góp
Tác giả chính:
Thomas Anglaret | Kỹ sư giải pháp nền tảng Google Maps