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 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 API Địa điểm
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 hoàn thành 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 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 để 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á.
Chọn phiên bản API Địa điểm
API Địa điểm hỗ trợ hai phiên bản API: API Địa điểm là các API hiện có và API Địa điểm (Mới) là các phiên bản API thế hệ mới.
Với bản phát hành API Địa điểm (Mới), nhiệm vụ đầu tiên của bạn là quyết định nên sử dụng tập hợp API nào. Điều này đúng nếu bạn là khách hàng mới hoặc khách hàng hiện tại đã sử dụng các API. Hãy sử dụng hướng dẫn này để tìm hiểu những điểm khác biệt chính giữa hai API.
Cách hoạt động của API Địa điểm
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 đị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ó một điểm cuối dịch vụ cụ thể, 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. Yêu cầu dịch vụ 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 Thông tin chi tiết về đị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 API Địa điểm.
| Places API | Places API (Mới) | Lưu ý |
|---|---|---|
| Tìm địa điểm | Tìm kiếm bằng văn bản (Mới) | Không có phiên bản mới của tính năng 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ả các yêu cầu sử dụng API hiện có có chứa cụm từ tìm kiếm dạng văn bản đều phải sử dụng Tìm kiếm bằng 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 bằng 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) | |
| Place Photo | Ả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 truy vấn | Tự động hoàn thành (Mới) | Các tính năng được thêm vào tính năng Tự động hoàn thành (Mới) |
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 và Ảnh địa điểm.| 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. Đối với Places API (Mới), bạn cũng có thể sử dụng mã thông báo OAuth. |
| 2 | Dùng thử tính năng tìm kiếm văn bản cơ bản | Tìm kiếm bằng văn bản bằng cách sử dụng Tìm kiếm bằng văn bản (Mới) hoặc Tìm kiếm bằng văn bản. |
| 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ề một địa điểm. Xem phần Chi tiết địa điểm (Mới) và Chi tiết địa điểm. |
| 4 | Tải ảnh về một địa điểm | Dịch vụ Ảnh địa điểm 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 thẻ Ảnh địa điểm (Mới) hoặc Chi tiết địa điểm để truy cập vào ảnh của một địa điểm. |