Lý do sử dụng API Địa điểm
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 đượ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 về thế giới thực. Dưới đây là ví dụ về các trường hợp sử dụng ứ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 đến 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
Bạn có thể sử dụng API Địa điểm để đư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ừ 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 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 điền cho nhiều loại nội dung tìm kiếm, chẳng hạn như cụm từ tìm kiếm văn bản cụ thể hoặc cụm từ tìm kiếm 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, nhưng cũng có thể lấy từ Geocoding API (API Địa mã hoá), 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 để yêu cầu thêm thông tin chi tiết về một cơ sở hoặc đ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 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 tiêu chuẩn có một đ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ợ 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ộ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
Cách sử dụng API Địa điểm
Các bước dưới đây trình bày một trường hợp sử dụng thông thường khi 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 rồi hoàn tất hướng dẫn thiết lập theo 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 của một địa điểm | Dịch vụ Ả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 Ảnh địa điểm (Mới) để truy cập vào ảnh của một địa điểm. |