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

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.

Thông tin chi tiết về đị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. Khi có 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 điểm tham quan cụ thể bằng cách bắt đầu yêu cầu Thông tin chi tiết về địa điểm (Mới). Yêu cầu Thông tin chi tiết về địa điểm (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 của 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 về địa điểm (Mới)

API Ả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 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ả các yêu cầu gửi đến API Ảnh địa điểm (Mới) đều phải có tên tài nguyên ảnh. Tên này sẽ 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:

Để thêm tên tài nguyên ảnh vào phản hồi từ yêu cầu Thông tin chi tiết về địa điểm (Mới), Tìm kiếm bằng văn bản (Mới) hoặc Tìm kiếm lân cận (Mới), hãy đảm bảo bạn thêm 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à Tìm kiếm lân cận (Mới)

API Địa điểm bao gồm hai API tìm kiếm:

  • Tìm kiếm bằng 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 một địa điểm. Ví dụ: "Đồ ăn chay cay ở Sydney, Úc" hoặc "Nhà hàng hải sản cao cấp gần Palo Alto, California".

    Bạn có thể tinh chỉnh kết quả tìm kiếm bằng cách chỉ định thông tin chi tiết như mức giá, trạng thái hoạt động hiện tại, điểm xếp hạng hoặc cá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 cho một vị trí cụ thể.

  • Tìm kiếm lân cận (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 vòng tròn được xác định bằng toạ độ vĩ độ và kinh độ của tâm điể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 kiếm một nhà hàng pizza nằm trong một trung tâm mua sắm ở khu vực đã chỉ định.

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

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ề thông tin gợi ý về địa điểm và cụm từ tìm kiếm để phản hồi một 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à các giới hạn đị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à tuỳ chọn hỗ trợ tiếp cận mới

API Địa điểm (Mới) bao gồm các trường, thuộc tính và tuỳ 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. Các 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ố thao tác nhất định. Giờ mở cửa phụ khác với giờ 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àm giờ hoạt động 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, trường phương thức thanh toán sẽ không được đặt. Các tuỳ 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 do địa điểm cung cấp. Các tuỳ 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
  • Gara đỗ xe miễn phí
  • Gara đỗ xe có tính phí
subDestinations Những địa điểm độc đáo có liên quan đến một địa điểm cụ thể. Ví dụ: nhà ga sân bay được coi là đích đế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 tuỳ chọn bao gồm:
  • Dầu diesel
  • Xăng không chì thông thường
  • Loại trung
  • Cao cấp
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • Khí dầu mỏ hoá lỏng (LPG)
  • E80
  • E85
  • Khí mêtan
  • 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 có sẵn tại một thời điểm nhất định.
shortFormattedAddress Địa chỉ ngắn, dễ đọc cho 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ó. Để 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ợ.

Thuộc tính

Places API (Mới) bao gồm 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 này có chương trình 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 phục vụ món tráng miệng.
servesCoffee Địa điểm phục vụ cà phê.
goodForChildren Địa điểm 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 phù hợp với các nhóm.
goodForWatchingSports Địa điểm phù hợp để xem các trận đấu thể thao.

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

API Địa điểm (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ó chỗ đỗ xe cho xe lăn.
wheelchairAccessibleEntrance Địa điểm có lối vào dành cho xe lăn.
wheelchairAccessibleRestroom Địa điểm có nhà vệ sinh cho xe lăn.
wheelchairAccessibleSeating Địa điểm có chỗ ngồi cho xe lăn.

Di chuyển sang API Địa điểm mới

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