Lý do bạn nên sử dụng Places API
Tạo các tính năng nhận biết vị trí để giúp người dùng của bạn dễ dàng cung cấp dữ liệu vị trí chi tiết. Dữ liệu có sẵn thông qua Places API được xây dựng dựa trên một trong những dữ liệu chính xác nhất, mới nhất và mô hình địa điểm toàn diện của thế giới thực. Sau đây là ví dụ về các trường hợp sử dụng ứng dụng:
- Hiển thị thông tin cho thuê căn hộ trong các khu vực đô thị lớn với kết quả được nhắm mục tiêu riêng đến các thành phố.
- Thêm thông tin chi tiết về địa điểm trong thông tin cập nhật về trạng thái đến lấy hàng hoặc giao hàng.
- Hiển thị danh sách các công viên trong một khu vực cùng với ảnh và bài đánh giá do người dùng gửi.
- Cung cấp thông tin liên hệ, bài đánh giá và mức giá của các cơ sở trong quá trình thực hiện chuyến đi cho những người đang lên kế hoạch cho chuyến đi.
Những việc bạn có thể làm với API Địa điểm
Bạn có thể sử dụng Places API để đưa các tính năng sau vào ứng dụng:
- Cung cấp kết quả tìm kiếm địa điểm từ các loại truy vấn khác nhau của người dùng, chẳng hạn như nhập văn bản, vị trí lân cận và truy vấn không rõ ràng hoặc theo danh mục của người dùng.
- Bật tính năng tự động hoàn thành cho các loại tìm kiếm khác nhau, kể cả các truy vấn văn bản cụ thể hoặc truy vấn phân loại.
- Tinh chỉnh loại thông tin chi tiết về một địa điểm được trả về, chẳng hạn như giờ hoạt động, bản tóm tắt, bài đánh giá của người dùng và một bức ảnh.
- Thêm ảnh chất lượng cao vào những vị trí mà ứng dụng của bạn phân phát.
Nhiều API Nền tảng Google Maps hỗ trợ place ID, trong đó ID địa điểm là duy nhất xác định một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Có nhiều cách để lấy mã địa điểm, bao gồm cả từ API địa điểm và từ API mã hoá địa lý, API tuyến đường và API xác thực địa chỉ.
Sau khi có mã địa điểm, bạn có thể sử dụng Places API để yêu cầu thêm thông tin chi tiết về cơ sở hoặc địa điểm ưa thích cụ thể, 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á.
Chọn phiên bản Places API của bạn
Places API hỗ trợ hai phiên bản API: API Địa điểm là API hiện có và API Địa điểm (Mới) là các phiên bản thế hệ tiếp theo của các API.
Với việc phát hành Places API (Mới), nhiệm vụ đầu tiên của bạn là quyết định để sử dụng. Điều này đúng nếu bạn là khách hàng mới hoặc hiện tại đã sử dụng API. Sử dụng hướng dẫn này để tìm hiểu sự khác biệt giữa hai API.
Cách hoạt động của API Địa điểm
Places API (Mới)
Places API (Mới) chấp nhận các yêu cầu dưới dạng URL chuẩn có một URL cụ thể
điểm cuối dịch vụ, chẳng hạn như /places hoặc places:searchText
và trả về phản hồi JSON. Places API (Mới) hỗ trợ việc uỷ quyền theo
Khoá API và mã thông báo OAuth.
Ví dụ sau đây tạo một yêu cầu Chi tiết địa điểm để trả về các thành phần địa chỉ cho một
mã địa điểm bằng cách sử dụng khoá API:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
API Địa điểm chấp nhận các yêu cầu dưới dạng URL chuẩn có chứa
điểm cuối dịch vụ, chẳng hạn như /place hoặc /photo. Các điểm cuối cũng
chấp nhận loại định dạng được chỉ định trong yêu cầu, JSON hoặc XML. Dịch vụ
yêu cầu này sử dụng các tham số liên quan đến điểm cuối cụ thể đó để tinh chỉnh dữ liệu được trả về.
Ví dụ sau đây tạo một yêu cầu Chi tiết địa điểm để trả về các thành phần địa chỉ cho một
mã địa điểm ở định dạng JSON:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
Trong trường hợp này, dịch vụ sử dụng mã địa điểm được cung cấp để tìm địa điểm được yêu cầu và trả về các thành phần địa chỉ ở định dạng JSON.
Tài nguyên
Bảng sau đây tóm tắt các tài nguyên có sẵn thông qua Places API.
| Places API | Places API (Mới) | Lưu ý |
|---|---|---|
| Tìm địa điểm | Tìm kiếm văn bản (Mới) | Chưa có phiên bản mới của Tìm địa điểm. Tính năng Tìm kiếm văn bản (Mới) đã thay thế tính năng này. |
| Tìm kiếm lân cận | Tìm kiếm lân cận (Mới) | Tất cả yêu cầu sử dụng API hiện có mà bao gồm cả truy vấn văn bản đều nên sử dụng Tìm kiếm văn bản (Mới) vì tính năng Tìm kiếm lân cận (Mới) không hỗ trợ nhập văn bản. |
| Tìm kiếm văn bản | Tìm kiếm văn bản (Mới) | |
| Thông tin chi tiết về địa điểm | Thông tin chi tiết về địa điểm (Mới) | |
| Ảnh địa điểm | Ảnh địa điểm (Mới) | |
| Tự động hoàn thành địa điểm | Tự động hoàn thành (Mới) | |
| Tự động hoàn thành cụm từ tìm kiếm | Tự động hoàn thành (Mới) | Đã thêm các tính năng vào Tự động hoàn thành (Mới) |
Cách sử dụng Places API
Các bước dưới đây đề cập đến một trường hợp sử dụng điển hình khi sử dụng dịch vụ API Địa điểm. Khi bạn xây dựng giải pháp của mình, bạn có thể sử dụng các điểm cuối khác, chẳng hạn như Tìm kiếm lân cận và Địa điểm ảnh.| 1 | Thiết lập | Hãy bắt đầu bằng việc Thiết lập làm theo hướng dẫn thiết lập, sau đó hoàn tất hướng dẫn thiết lập, sau đó làm theo các bước trên Google Cloud hãy tìm hiểu cách sử dụng khoá API. Đối với Places API (Mới), bạn cũng có thể sử dụng Mã thông báo OAuth. |
| 2 | Thử tìm kiếm bằng văn bản cơ bản | Tìm kiếm văn bản đơn giản bằng cách sử dụng Tìm kiếm văn bản (Mới) hoặc Tìm kiếm văn bản. |
| 3 | Sử dụng mã địa điểm để biết thêm thông tin | Nhiều API Nền tảng Google Maps trả về một mã địa điểm trong phản hồi. Sử dụng mã địa điểm để biết thông tin chi tiết về một địa điểm. Xem Thông tin về địa điểm (mới) và Thông tin về địa điểm. |
| 4 | Tìm ảnh cho một địa điểm | Dịch vụ Hình ảnh địa điểm cung cấp cho bạn quyền truy cập vào hàng triệu ảnh được lưu trữ trong Địa điểm cơ sở dữ liệu. Sử dụng Ảnh địa điểm (Mới) hoặc Chi tiết địa điểm để truy cập vào ảnh cho một địa điểm. |