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 ứng dụng đơ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 các địa điểm yêu thích quan trọng ở gần một vị trí bạn chỉ định khi tìm kiếm khách sạn hoặc bất động sản. Nó thường bao gồm bản đồ tương tác, với một bảng điều khiển bổ sung chứa trình chọn địa điểm và thư viện ảnh. Bạn sẽ thấy nhiều sản phẩm và tính năng của Nền tảng Google Maps để nâng cao trải nghiệm tương tác.

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

Trường hợp sử dụng

Bây giờ, hãy cùng tìm hiểu xem yếu tố nào của hoạt động tích hợp khám phá cục bộ thúc đẩy người dùng giá trị:

  • 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à 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ư khoảng cách để người dùng nhanh chóng hiểu được liệu phương tiện đó có phù hợp với nhu cầu của họ.

Kiến trúc tham chiếu

alt_text

Khám phá địa phương

Có nhiều cách để tạo trải nghiệm khám phá địa phương. Việc 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ền tảng Google Maps nổi tiếng 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 mẫu để khám phá nội dung cục bộ, 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 mô tả về việc triển khai kỹ thuật với Google Maps API nền tảng.

1. Tìm kiếm vị trí bằng tính năng Tự động hoàn thànhTìm kiếm vị trí

  • Tải Maps JavaScript API.
  • Truy vấn Tự động hoàn thành đị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 "nơi lưu trú" và chỉ đưa vào các loại phù hợp, ví dụ: "nhà hàng, quán cà phê, công viên, điểm tham quan du lịch".
  • Khai thác includedPrimaryTypes, excludedPrimaryTypes để kiểm soát kết quả tốt hơn nữa.
  • "Giới hạn vị trí" để tránh số lượng kết quả không đủ hoặc quá xa địa điểm ; trong trường hợp KHÔNG có kết quả nào, hãy mở rộng kích thước vòng tròn / hình chữ nhật trước để hiển thị kết quả.

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

Mẫu truy vấn khi đặt phòng 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)
  • 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 tương tác bằng API động và API Chỉ đường

  • Cập nhật đoạn đường và số bước bằng cách truy vấn Chỉ đường . * Sử dụng thời gian trong phần tiếp theo.

hướng dẫn 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: đến từ truy vấn API Chỉ đường trước đó.

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

  3. Hình ảnh: trong quá trình Xem trước không bị 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 để lấy photo_reference, sau đó truy vấn từng địa điểm một 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à một cách hiệu quả để mang lại giá trị cho người dùng. Chiến dịch này bản minh hoạ có nhiều tính năng mà bạn có thể đưa vào khi tạo ra một trải nghiệm như vậy trên Nền tảng Google Maps bằng những khả năng đặc biệt từ 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 | Google Maps Kỹ sư giải pháp nền tảng