Trong tài liệu này, bạn sẽ tìm hiểu cách sử dụng Nearby Search (New) API để xây dựng một giải pháp đơn giản và tiết kiệm chi phí
cho 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 các địa điểm quan trọng gần một vị trí mà bạn chỉ định khi họ tìm khách sạn hoặc bất động sản. Trải nghiệm này thường bao gồm một bản đồ tương tác, với một bảng bổ sung chứa trình chọn địa điểm và một thư viện ảnh. Bạn sẽ được giới thiệu các sản phẩm và tính năng của Nền tảng Google Maps để cải thiện trải nghiệm bằng khả năng tương tác.

Trường hợp sử dụng
Bây giờ, hãy tìm hiểu những thành phần nào của quá trình tích hợp khám phá địa phương mang lại giá trị cho người dùng:
Khám phá – Cung cấp cho người dùng thông tin tổng quan về những địa điểm xung quanh một vị trí duy nhất bằng cách hiển thị các địa điểm có liên quan thuộc nhiều loại.
Khả năng tương tác – Cho phép người dùng chọn một địa điểm và làm mới dữ liệu một cách linh hoạt
liên quan đến địa điểm đó.
Hình ảnh trực quan - Cung cấp bài đánh giá về địa điểm, ảnh
cũng như thời gian và khoảng cách đi bộ để người dùng nhanh chóng biết được địa điểm đó có phù hợp với nhu cầu của họ hay không.
Kiến trúc tham chiếu

Khám phá địa phương
Có nhiều cách để tạo trải nghiệm khám phá địa phương. Quá trình tích hợp sau đây là một 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 Google Maps Platform 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 dựa trên mẫu để khám phá địa phương, 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ẽ 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 phần mô tả về cách triển khai kỹ thuật bằng các API của Nền tảng Google Maps.
1. Tìm kiếm địa điểm bằng tính năng Tự động hoàn thànhTìm kiếm địa điểm
- Tải Maps JavaScript API.
- Truy vấn Places Autocomplete hoặc chọn địa điểm trên bản đồ.

2. Hiển thị các điểm tham quan địa phương bằng Nearby Search (New) API
- Xếp hạng theo mức độ phổ biến (kết quả phù hợp hơn) hoặc Xếp hạng theo khoảng cách.
includedTypes,excludedTypes; nếu là khách sạn, bạn có thể loại trừ loại "chỗ ở" và chỉ đưa vào các loại phù hợp, tức là: "nhà hàng, quán cà phê, công viên, điểm du lịch".- Tận dụng
includedPrimaryTypes,excludedPrimaryTypesđể kiểm soát kết quả nhiều hơn nữa. - `locationRestriction để tránh số lượng kết quả không đủ hoặc các địa điểm quá xa; trong trường hợp KHÔNG có kết quả nào, hãy mở rộng kích thước hình tròn / hình chữ nhật trước khi hiển thị kết quả.

Mẫu truy vấn khi đặt khách sạn với các trường Dữ liệu được yêu cầu:
- Cơ bản (
displayName,types,openingHours,formattedAddress) - Thông tin liên hệ (
websiteUri,nationalPhoneNumber,internationalPhoneNumber) - Ưu tiên (
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 } } }Mẫu truy vấn khi tìm kiếm bất động sản với 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 khả năng tương tác bằng Dynamic Maps and Directions API
- Chặng và bước mới nhất bằng cách truy vấn Directions API. * 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
Mô tả:
displayName,types,rating,userRatingCount,priceLevel.Thời gian: lấy từ truy vấn Directions API trước đó.
Bài đánh giá:
reviews[i].author,reviews[i].rating,reviews[i].text.Hình ảnh: trong Bản xem trước không hạn chế của Nearby Search (New) API, bạn sẽ phải truy vấn Thông tin chi tiết về địa điểm bằng
place.idđể lấy photo_reference sau đó truy vấn từng ảnh một trong trải nghiệm của mình

Số lượng truy vấn và chi phí liên quan
- Maps JavaScript API: 1 bản đồ khi tải trải nghiệm.
- Places Autocomplete API: 1 truy vấn cho mỗi ký tự được nhập (nếu sử dụng Tiện ích tự động hoàn thành ), bạn có thể tuỳ chỉnh.
- Nearby Search (New) API: 1 truy vấn cho mỗi 20 địa điểm được hiển thị. Phương thức tính phí khác nhau tuỳ theo Dữ liệu địa điểm thuộc phản hồi truy vấn.
- Directions API: 1 truy vấn cho mỗi địa điểm mà người dùng chọn.
- Place Photo API: 1 truy vấn cho mỗi ảnh được hiển thị.
Kết luận
Trải nghiệm khám phá địa phương là một cách hiệu quả để mang lại giá trị cho người dùng. Việc triển khai bản minh hoạ này có nhiều tính năng mà bạn có thể sẽ đưa vào khi tạo trải nghiệm như vậy trên Google Maps Platform với các khả năng đặc biệt của Nearby Search (New) API .
Các bước tiếp theo
Đề xuất đọ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 địa điểm
- Các dịch vụ khác về địa điểm
- Để 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 của Nền tảng Google Maps