Lý do 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 API Địa điểm (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ề trường hợp sử dụng cho các ứng dụng:
- Hiển thị các căn hộ cho thuê trong các khu đô thị lớn với kết quả được nhắm mục tiêu cụ thể theo thành phố.
- Đưa thông tin chi tiết về địa điểm vào nội dung cập nhật trạng thái giao hàng hoặc đến lấy hàng.
- Hiển thị danh sách công viên trong một khu vực cùng với hình ả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ú dọc theo tuyến đường.
Những việc bạn có thể làm với Places API (Mới)
Bạn có thể sử dụng API Địa điểm (Mới) để đưa 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ư văn bản nhập, vị trí lân cận và cụm từ tìm kiếm mơ hồ hoặc mang tính phân loại của người dùng.
- Bật tính năng tự động hoàn thành cho nhiều loại nội dung 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, bản 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 các địa điểm mà ứng dụng của bạn phân phát.
Nhiều API của Nền tảng Google Maps hỗ trợ mã địa điểm, trong đó 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. Có nhiều cách để lấy mã địa điểm, bao gồm cả từ API Địa điểm (Mới) nhưng cũng có thể lấy từ Geocoding API (API Địa chỉ), Routes API (API Tuyến đường) và Address Validation API (API Xác thực địa chỉ).
Sau khi có mã địa điểm, bạn có thể sử dụng API Địa điểm (Mới) để yêu cầu thêm thông tin chi tiết về một cơ sở hoặc điểm tham quan 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á.
Cách hoạt động của Places API (Mới)
API Địa điểm (Mới) chấp nhận các yêu cầu dưới dạng URL 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ề phản hồi JSON.
Places API (Mới) hỗ trợ uỷ quyền bằng khoá API và mã thông báo OAuth.
Ví dụ sau đây tạo một 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ã đị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
Cách sử dụng Places API (Mới)
Các bước bên dưới trình bày một trường hợp sử dụng điển hình để sử dụng dịch vụ API Địa điểm. 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ư Tìm kiếm lân cận (Mới) và Ảnh địa điểm (Mới).| 1 | Thiết lập | Bắt đầu bằng cách Thiết lập dự án Google Cloud và hoàn thành hướng dẫn thiết lập sau đó, sau đó tìm hiểu cách sử dụng khoá API. |
| 2 | Dùng thử tính năng tìm kiếm văn bản cơ bản | Thực hiện tìm kiếm bằng văn bản bằng cách sử dụng tính năng Tìm kiếm bằng văn bản (Mới). |
| 3 | Sử dụng mã địa điểm để biết thêm thông tin | Nhiều API của 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 để nhận Thông tin chi tiết về địa điểm (Mới). |
| 4 | Tải ảnh về một địa điểm | Ảnh địa điểm (Mới) cho phép bạn truy cập vào hàng triệu ảnh được lưu trữ trong cơ sở dữ liệu Địa điểm. Sử dụng tính năng Ảnh địa điểm (Mới) để truy cập vào ảnh của một địa điểm. |