Giới thiệu
Places API (mới) bao gồm các API sau:
- Thông tin chi tiết về địa điểm (Mới)
- Hình ảnh về địa điểm (Mới)
- Tìm kiếm lân cận (Mới)
- Tìm kiếm bằng văn bản (Mới)
- Tự động hoàn thành (Mới)
Tài liệu này chứa thông tin tổng quan về các API mới này.
Place Details (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 một yêu cầu Place Details (New) (Thông tin chi tiết về địa điểm (Mới)). Yêu cầu 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 và bài đánh giá của người dùng.
Có nhiều cách để lấy mã địa điểm. Bạn có thể sử dụng:
- Tìm kiếm bằng văn bản (Mới)
- Tìm kiếm lân cận (Mới)
- Geocoding API
- Routes API
- Address Validation API
- Tự động hoàn thành (Mới)
Ảnh về địa điểm (Mới)
Ảnh về đị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 của mình bằng cách cấp cho bạn quyền truy cập vào hàng triệu bức ảnh được lưu trữ trong cơ sở dữ liệu Địa điểm của Google. Khi sử dụng Place Photos (New) API, 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 Place Photos (New) API đều phải có tên tài nguyên ảnh. Tên này 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 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 rằng bạn đưa trường photos vào mặt nạ trường của yêu cầu.
Tìm kiếm bằng văn bản (Mới) và Tìm kiếm lân cận (Mới)
Places API bao gồm 2 API tìm kiếm:
-
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 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 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 ở một vị trí cụ thể.
-
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 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 loại tìm kiếm này là tính năng 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ính năng 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ính năng tự động hoàn thành (Mới) và mã thông báo phiên
Tính năng tự động hoàn thành (Mới) là một dịch vụ web trả về các cụm từ 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à ranh giới địa lý kiểm soát khu vực tìm kiếm.
Mã thông báo phiên là 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 cụm 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) có 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. 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ề lựa chọn thanh toán, trường lựa chọn thanh toán sẽ không được đặt. Các lựa chọn bao gồm:
|
parkingOptions |
Các lựa chọn đỗ xe do nơi lưu trú cung cấp. Các lựa chọn bao gồm:
|
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à điểm đến phụ của một 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:
|
evChargeOptions |
Số lượng bộ sạc xe điện tại trạm này. Mặc dù một số bộ sạc xe điện có nhiều giắc cắm, 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 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 duy nhất. Để 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ữ 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) 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 này có nhạc sống. |
menuForChildren |
Địa điểm này có thực đơn dành cho trẻ em. |
servesCocktails |
Địa điểm này có 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 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 có thể tiếp đón các 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 lựa chọn hỗ trợ tiếp cận sau:
| Trường | Mô tả |
|---|---|
wheelchairAccessibleParking |
Địa điểm này 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. |
Bản tóm tắt dựa trên AI
Tính năng 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ề thông tin tóm tắt về các địa điểm và khu vực, giúp người dùng quyết định nơi sẽ đến.
Các bản tóm tắt dựa trên AI tổng hợp dữ liệu từ nhiều nguồn đầ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 dùng thử một nhà hàng mới, thì thông tin tóm tắt dựa trên AI có thể cho bạn biết những món ăn nổi bật thường thấy trong thực đơn, giúp bạn hình dung được 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 nghi gần đó.
Các tính năng dựa trên AI được thêm vào Places API (Mới)
Tính năng tóm tắt dựa trên AI được hỗ trợ bởi Thông tin chi tiết về địa điểm (Mới), Tìm kiếm bằng văn bản (Mới) và Tìm kiếm lân cận (Mới). Các bản tóm tắt dựa trên AI sau đây có trong phản hồi của Places API (Mới):
- Thông tin tóm tắt về địa điểm: Thông tin tóm tắt ngắn gọn về một địa điểm cụ thể.
- Bản tóm tắt bài đánh giá: Bản tóm tắt dễ hiểu về những gì người đánh giá đã nói về một địa điểm.
- Tóm tắt khu vực, cung cấp thông tin tổng quan về các địa điểm lân cận và nổi tiếng trong khu vực xung quanh. Những 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 những bản tóm tắt này để đảm bảo chúng luôn mới dựa trên thông tin mới nhất hiện có. Khi thực hiện một yêu cầu 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 (mới) 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 đây:
- Di chuyển sang Place Details (Mới)
- Di chuyển sang Nearby Search (Mới)
- Di chuyển sang tính năng Tìm kiếm bằng văn bản (Mới)
- Di chuyển sang Place Photos (Mới)
- Di chuyển sang tính năng Tự động hoàn thành (Mới)