Giới thiệu về Places API (Mới)

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Giới thiệu

Places API (Mới) bao gồm các API sau:

Tài liệu này cung cấp thông tin tổng quan về các API mới này.

Chi tiết địa điểm (Mới)

Mã địa điểm giúp xác định riêng một địa điểm trong cơ sở dữ liệu của Google Địa điểm và trên Google Maps. Với Mã địa điểm, bạn có thể yêu cầu thông tin chi tiết về một cơ sở hoặc địa điểm yêu thích cụ thể bằng cách bắt đầu yêu cầu Place Details (Mới). Yêu cầu Place Details (Mới) trả về thông tin toàn diện về địa điểm được chỉ định, chẳng hạn như địa chỉ đầy đủ, số điện thoại, điểm xếp hạng từ người dùng và bài đánh giá.

Có nhiều cách để lấy mã địa điểm. Bạn có thể sử dụng:

Ảnh địa điểm (Mới)

Ảnh địa điểm (Mới) cho phép bạn thêm nội dung ảnh chất lượng cao vào ứng dụng bằng cách cấp cho bạn quyền truy cập vào hàng triệu ảnh được lưu trữ trong cơ sở dữ liệu của Google Địa điểm. Khi sử dụng API Ảnh địa điểm (Mới), bạn có thể truy cập vào ảnh và đổi kích thước hình ảnh thành kích thước tối ưu cho ứng dụng của mình.

Tất cả yêu cầu gửi đến API Ảnh địa điểm (Mới) đều phải bao gồm tên tài nguyên ảnh. Tên này giúp xác định duy nhất ảnh cần trả về. Bạn có thể lấy tên tài nguyên ảnh bằng cách sử dụng:

Để đưa tên tài nguyên ảnh vào phản hồi từ yêu cầu Chi tiết địa điểm (Mới), Tìm kiếm văn bản (Mới) hoặc Tìm kiếm lân cận (Mới), hãy nhớ đưa trường photos vào mặt nạ trường của yêu cầu.

Tìm kiếm văn bản (Mới) và Nearby Search (Mới)

Places API (Mới) bao gồm hai API tìm kiếm:

  • Tìm kiếm văn bản (Mới)

    Cho phép bạn chỉ định một chuỗi văn bản để tìm kiếm địa điểm. Ví dụ: "Món chay cay ở Sydney, Úc" hoặc "Nhà hàng hải sản cao cấp gần Palo Alto, CA".

    Bạn có thể tinh chỉnh kết quả tìm kiếm bằng cách chỉ định các thông tin chi tiết như mức giá, trạng thái mở cửa hiện tại, điểm xếp hạng hoặc loại địa điểm cụ thể. Bạn cũng có thể chỉ định thiên vị kết quả cho một vị trí cụ thể hoặc hạn chế tìm kiếm ở một vị trí cụ thể.

  • Nearby Search (Mới)

    Cho phép bạn chỉ định một khu vực để tìm kiếm cùng với danh sách các loại địa điểm. Chỉ định khu vực dưới dạng một hình tròn được xác định bằng toạ độ vĩ độ và kinh độ của tâm và bán kính tính bằng mét.

    Chỉ định một hoặc nhiều loại địa điểm xác định đặc điểm của địa điểm. Ví dụ: chỉ định "pizza_restaurant" và "shopping_mall" để tìm một nhà hàng pizza nằm trong một trung tâm mua sắm ở khu vực được chỉ định.

Điểm khác biệt chính giữa hai kiểu tìm kiếm này là tính năng Tìm kiếm văn bản (Mới) cho phép bạn chỉ định một chuỗi tìm kiếm tuỳ ý, còn tính năng Nearby Search (Mới) yêu cầu bạn chỉ định một khu vực cụ thể để tìm kiếm.

Tính năng Tự động hoàn thành (Mới) và mã thông báo phiên

Tự động hoàn thành (Mới) là một dịch vụ web trả về cụm từ gợi ý về địa điểm và cụm từ gợi ý về cụm từ tìm kiếm để phản hồi yêu cầu HTTP. Trong yêu cầu, hãy chỉ định một chuỗi tìm kiếm văn bản và ranh giới địa lý kiểm soát khu vực tìm kiếm.

Mã thông báo phiên là các chuỗi do người dùng tạo, theo dõi các lệnh gọi Tự động hoàn thành (Mới) dưới dạng phiên. Tính năng Tự động hoàn thành (Mới) sử dụng mã thông báo phiên để nhóm các giai đoạn truy vấn và lựa chọn của một lượt tìm kiếm tự động hoàn thành của người dùng thành một phiên riêng biệt cho mục đích thanh toán.

Các trường, thuộc tính và lựa chọn hỗ trợ tiếp cận mới

Places API (Mới) bao gồm các trường, thuộc tính và lựa chọn hỗ trợ tiếp cận mới để cung cấp cho người dùng thêm thông tin về một địa điểm. Những khía cạnh này được mô tả trong các phần sau.

Trường

Places API (Mới) bao gồm một số trường mới:

Trường Mô tả
regularSecondaryOpeningHours Mô tả thời gian cụ thể cho một số hoạt động nhất định. Giờ mở cửa phụ khác với giờ mở cửa chính của doanh nghiệp. Ví dụ: một nhà hàng có thể chỉ định giờ mua hàng ngay trên xe hoặc giờ giao hàng là giờ phụ.
paymentOptions Các phương thức thanh toán mà địa điểm chấp nhận. Một địa điểm có thể chấp nhận nhiều phương thức thanh toán. Nếu không có dữ liệu về phương thức thanh toán, thì trường phương thức thanh toán sẽ không được đặt. Các lựa chọn bao gồm:
  • Thẻ tín dụng
  • Thẻ ghi nợ
  • Chỉ nhận tiền mặt
  • Thanh toán qua NFC
parkingOptions Các lựa chọn đỗ xe mà địa điểm này cung cấp. Các lựa chọn bao gồm:
  • Bãi đỗ xe miễn phí
  • Bãi đỗ xe có tính phí
  • Đỗ xe miễn phí trên đường
  • Có nhân viên đỗ xe
  • Chỗ đỗ xe miễn phí trong gara
  • Chỗ đỗ xe có tính phí trong gara
subDestinations Các địa điểm riêng biệt có liên quan đến một địa điểm cụ thể. Ví dụ: nhà ga sân bay được coi là điểm đến phụ của sân bay.
fuelOptions Thông tin mới nhất về các loại nhiên liệu có tại một trạm xăng. Thông tin này được cập nhật thường xuyên. Các lựa chọn bao gồm:
  • Dầu diesel
  • Xăng không chì thông thường
  • Loại trung
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • Khí dầu mỏ hoá lỏng (LPG)
  • E80
  • E85
  • Khí methane
  • Diezen sinh học
  • Dầu diesel cho xe tải
evChargeOptions Số lượng bộ sạc xe điện (EV) tại trạm này. Mặc dù một số bộ sạc xe điện có nhiều đầu nối, nhưng mỗi bộ sạc chỉ có thể sạc một xe tại một thời điểm; do đó, trường này phản ánh số lượng bộ sạc xe điện hiện có tại một thời điểm nhất định.
shortFormattedAddress Địa chỉ ngắn gọn, con người có thể đọc được của một địa điểm.
primaryType Loại chính của kết quả đã cho. Ví dụ: một địa điểm có thể được phân loại là cafe hoặc airport. Một địa điểm chỉ có thể có một loại chính. Để biết danh sách đầy đủ các giá trị có thể có, hãy xem phần Các loại được hỗ trợ.
primaryTypeDisplayName Tên hiển thị của loại chính, được bản địa hoá theo ngôn ngữ của yêu cầu (nếu có). Để xem danh sách đầy đủ các giá trị có thể có, hãy xem phần Các loại được hỗ trợ.
entrances Lối vào điểm đến. Lối vào là một cặp toạ độ vĩ độ/kinh độ duy nhất xác định vị trí của điểm vào và điểm ra của một địa điểm.
navigationPoints Điểm điều hướng cho điểm đến. Điểm điều hướng là một vị trí bên cạnh đường mà tại đó, quá trình điều hướng có thể kết thúc, bao gồm cả các phương thức di chuyển và cách sử dụng được hỗ trợ.

Thuộc tính

Places API (Mới) có một số thuộc tính mới:

Thuộc tính Mô tả
outdoorSeating Địa điểm này có chỗ ngồi ngoài trời.
liveMusic Địa điểm có nhạc sống.
menuForChildren Địa điểm này có thực đơn dành cho trẻ em.
servesCocktails Địa điểm phục vụ cocktail.
servesDessert Địa điểm này có phục vụ món tráng miệng.
servesCoffee Địa điểm này có phục vụ cà phê.
goodForChildren Địa điểm này phù hợp với trẻ em.
allowsDogs Địa điểm cho phép mang theo chó.
restroom Địa điểm có nhà vệ sinh.
goodForGroups Địa điểm này phù hợp cho nhóm.
goodForWatchingSports Địa điểm này phù hợp để xem thể thao.

Tuỳ chọn hỗ trợ tiếp cận

Places API (Mới) bao gồm các trường tuỳ chọn hỗ trợ tiếp cận sau:

Trường Mô tả
wheelchairAccessibleParking Địa điểm có bãi đỗ xe dành cho xe lăn.
wheelchairAccessibleEntrance Địa điểm có lối vào cho xe lăn.
wheelchairAccessibleRestroom Địa điểm có nhà vệ sinh phù hợp cho xe lăn.
wheelchairAccessibleSeating Địa điểm có chỗ ngồi cho xe lăn.

Bản tóm tắt dựa trên AI

Bản tóm tắt dựa trên AI của Places API (Mới) sử dụng các chức năng của mô hình Gemini để trả về bản tóm tắt về các địa điểm và khu vực có thể giúp người dùng quyết định nơi sẽ đến.

Bản tóm tắt dựa trên AI tổng hợp dữ liệu từ nhiều nguồn thông tin đầu vào để giúp người dùng đưa ra quyết định sáng suốt hơn về một địa điểm. Ví dụ: nếu bạn đang cân nhắc thử một nhà hàng mới, bản tóm tắt dựa trên AI có thể hiển thị các món ăn nổi bật phổ biến trong thực đơn, giúp bạn hình dung về bầu không khí hoặc tổng hợp các chủ đề từ bài đánh giá của người dùng. Nếu bạn đang ghé thăm một thành phố mới, thông tin tóm tắt dựa trên AI có thể cung cấp thông tin tổng quan về các điểm tham quan và tiện ích lân cận.

Các tính năng dựa trên AI được thêm vào Places API (Mới)

Bản tóm tắt dựa trên AI được hỗ trợ bởi Place Details (Mới), Tìm kiếm văn bản (Mới), và Nearby Search (Mới). Các bản tóm tắt sau đây do AI tạo có trong phản hồi của API Địa điểm (Mới):

  • Bản tóm tắt về địa điểm, là bản tóm tắt tổng quan ngắn gọn liên quan đến một địa điểm cụ thể.
  • Bản tóm tắt bài đánh giá, là bản tóm tắt dễ hiểu về những điều người đánh giá đã nói về một địa điểm.
  • Thông tin tóm tắt về khu vực, cung cấp thông tin tổng quan về các địa điểm lân cận và phổ biến trong khu vực xung quanh. Các thông tin này bao gồm thông tin tóm tắt về khu vực lân cận và thông tin tóm tắt về trạm sạc xe điện.

Google thường xuyên tạo lại các bản tóm tắt này để đảm bảo rằng chúng luôn mới dựa trên thông tin mới nhất hiện có. Khi đưa ra yêu cầu về Places API (Mới), bạn sẽ hiển thị dữ liệu mới nhất trong ứng dụng của mình.

Di chuyển sang Places API (Mới)

Nếu bạn là khách hàng hiện tại của Places API (Cũ) và muốn di chuyển ứng dụng của mình để sử dụng Places API (Mới), hãy xem tài liệu di chuyển sau: