Cải thiện khả năng khám phá địa phương bằng API Tìm kiếm lân cận (Mới)

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.

khám phá địa phương mẫu

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

alt_text

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 đồ.

tự động hoàn thành mẫu

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ả.

địa điểm lân cận mẫu

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.

đường đi mẫu

4. Hiển thị thông tin chi tiết về địa điểm khi tương tác

  1. 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 đó.

  2. Bài đánh giá: reviews[i].author, reviews[i].rating,reviews[i].text.

  3. 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

thông tin chi tiết về địa điểm

Số lượng truy vấn và chi phí được liên kết

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:

Người đóng góp

Tác giả chính:

Thomas Anglaret | Kỹ sư giải pháp nền tảng Google Maps