Giới thiệu
Places API là một dịch vụ chấp nhận các yêu cầu HTTP về dữ liệu vị trí thông qua nhiều phương thức. API này trả về dữ liệu vị trí và hình ảnh được định dạng về các cơ sở, vị trí địa lý hoặc địa điểm yêu thích nổi bật.Lý do nên sử dụng Places API (Mới)
Tạo các tính năng nhận biết vị trí để cung cấp dữ liệu vị trí chi tiết cho người dùng. Dữ liệu có sẵn thông qua Places API (mới) được xây dựng dựa trên một trong những mô hình địa điểm chính xác, mới nhất và toàn diện nhất của thế giới thực. Sau đây là ví dụ về các trường hợp sử dụng cho ứng dụng:
- Hiển thị căn hộ cho thuê trong các khu vực đô thị lớn với kết quả nhắm đến các thành phố cụ thể.
- Thêm thông tin chi tiết về địa điểm vào thông tin cập nhật trạng thái nhận 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 cho những người đang lên kế hoạch cho chuyến đi thông tin liên hệ, bài đánh giá và mức giá của các cơ sở lưu trú trên đường đi.
Bạn có thể làm gì với Places API (Mới)
Bạn có thể sử dụng Places API (mới) để thêm các tính năng sau vào ứng dụng của mình:
- Cung cấp kết quả tìm kiếm địa điểm từ nhiều loại cụm từ tìm kiếm của người dùng, chẳng hạn như nội dung nhập bằng văn bản, vị trí lân cận và cụm từ tìm kiếm của người dùng không rõ ràng hoặc theo danh mục.
- Bật các tính năng tự động hoàn thành cho nhiều loại tìm kiếm, chẳng hạn như truy vấn văn bản cụ thể hoặc truy vấn theo danh mục.
- Tinh chỉnh loại thông tin chi tiết được trả về về một địa điểm, chẳng hạn như giờ hoạt động, thông tin tóm tắt, bài đánh giá của người dùng và ảnh.
- Thêm ảnh chất lượng cao vào những địa điểm mà ứng dụng của bạn phục vụ.
Nhiều API của Google Maps Platform hỗ trợ Mã địa điểm, trong đó Mã địa điểm 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. Có nhiều cách để lấy mã địa điểm, bao gồm cả từ Places API (mới), cũng như từ Geocoding API, Routes API và Address Validation API.
Sau khi có Mã địa điểm, bạn có thể sử dụng Places API (Mới) để yêu cầu thêm thông tin chi tiết về một cơ sở hoặc địa điểm yêu thích cụ thể, 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ách hoạt động của Places API (Mới)
Places API (mới) chấp nhận các yêu cầu dưới dạng một URL tiêu chuẩn có điểm cuối dịch vụ cụ thể, chẳng hạn như /places hoặc places:searchText và trả về một phản hồi JSON.
Places API (Mới) hỗ trợ việc uỷ quyền bằng khoá API và mã thông báo OAuth.
Ví dụ sau đây đưa ra yêu cầu Chi tiết về địa điểm (Mới) để trả về các thành phần địa chỉ cho một Mã địa điểm bằng khoá API:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Cách sử dụng Places API (Mới)
Các bước dưới đây trình bày một trường hợp sử dụng điển hình để dùng dịch vụ Places API. Khi xây dựng giải pháp, bạn có thể sử dụng các điểm cuối bổ sung, chẳng hạn như Nearby Search (Mới) và Place Photos (Mới).| 1 | Thiết lập | Thiết lập thông tin thanh toán, bật Places API (Mới) và đưa ra yêu cầu đầu tiên. |
| 2 | Thử tìm kiếm văn bản cơ bản | Đưa ra yêu cầu tìm kiếm bằng văn bản bằng cách sử dụng Tìm kiếm văn bản (Mới). |
| 3 | Sử dụng mã địa điểm để biết thêm thông tin chi tiết | Nhiều API của Nền tảng Google Maps trả về mã địa điểm trong một phần của phản hồi. Sử dụng mã địa điểm để nhận Thông tin chi tiết về địa điểm (Mới). |
| 4 | Lấy ảnh cho một địa điểm | Place Photos (Mới) cho phép bạn truy cập vào hàng triệu bức ảnh được lưu trữ trong cơ sở dữ liệu Places. Sử dụng Ảnh địa điểm (Mới) để truy cập vào ảnh của một địa điểm. |