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 trải nghiệm đơn giản và hiệu quả về chi phí
khám phá địa phương đơn giản và tiết kiệm chi phí.
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 kiế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, cùng 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 Google Maps Platform để nâng cao trải nghiệm với tính 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 tính năng 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í 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à 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á, ảnh về địa điểm
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. Tính năng 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 có một 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 địa điểm quan tâm ở đị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ả.

Truy vấn mẫu 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 } } }Truy vấn mẫu 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 tính năng tương tác bằng Dynamic Maps và 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ị. Cách tính phí khác nhau tuỳ theo Dữ liệu địa điểm là một phần của 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 tính 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 | Google Maps Kỹ sư giải pháp Nền tảng