Tổng quan

Chọn nền tảng: Android iOS JavaScript Dịch vụ web
API Địa điểm là một dịch vụ chấp nhận các yêu cầu HTTP cho dữ liệu vị trí thông qua nhiều phương thức. Phương thức này trả về dữ liệu vị trí đã định dạng và hình ảnh về các cơ sở, vị trí địa lý hoặc điểm yêu thích nổi bật.

Tại sao nên 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 của bạn một cách dễ 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 trong thế giới thực. Dưới đây là ví dụ về các trường hợp sử dụng cho ứng dụng:

  • Cho thuê căn hộ trong khu đô thị lớn với kết quả được nhắm mục tiêu cụ thể đến thành phố.
  • Cung cấp thông tin chi tiết về địa điểm trong phần cập nhật 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 các ảnh và bài đánh giá của người dùng.
  • Cung cấp cho những người đang lên kế hoạch chuyến đi với thông tin liên hệ, đánh giá và mức giá cho các cơ sở trên đường đi.

Bạn có thể làm gì 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 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 văn bản, vị trí lân cận và cụm từ tìm kiếm không rõ ràng hoặc theo danh mục người dùng.
  • Bật tính năng tự động hoàn thành cho nhiều loại tìm kiếm, cho dù là truy vấn dạng văn bản cụ thể hay 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 vị trí do ứng dụng của bạn phân phát.

Cách API Địa điểm hoạt động

API Địa điểm chấp nhận các yêu cầu dưới dạng một URL tiêu 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, dưới dạng JSON hoặc XML. Cuối cùng, yêu cầu dịch vụ sẽ 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ụ: yêu cầu Chi tiết địa điểm cho các thành phần địa chỉ sau đây hoạt động như sau, giả sử có yêu cầu trả về ở đị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 đã cung cấp để tìm địa điểm đã 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 cùng với dữ liệu mà API này trả về.

Tài nguyên dữ liệu Đã trả về dữ liệu Định dạng trả về
Tìm kiếm địa điểm Trả về danh sách các địa điểm dựa trên vị trí thiết bị hoặc chuỗi tìm kiếm.

Xem thông tin chi tiết về Phản hồi tìm kiếm địa điểm, Phản hồi cho tìm kiếm lân cậnPhản hồi cho tìm kiếm văn bản.

  • JSON
  • XML
Thông tin chi tiết về địa điểm Trả về thông tin chi tiết hơn về một địa điểm cụ thể, bao gồm cả các bài đánh giá của người dùng.

Hãy xem thông tin chi tiết trong phần Phản hồi của thông tin chi tiết về địa điểm.

  • JSON
  • XML
Ảnh địa điểm Cấp quyền truy cập vào hàng triệu ảnh liên quan đến địa điểm được lưu trữ trong cơ sở dữ liệu Địa điểm của Google.

Xem chi tiết về Phản hồi của địa điểm qua ảnh.

  • JSON
  • XML
Đặt tính năng tự động hoàn thành Tự động điền tên và/hoặc địa chỉ của địa điểm khi người dùng nhập.

Xem chi tiết về Phản hồi của tính năng tự động hoàn thành địa điểm.

  • JSON
  • XML
Tự động hoàn thành truy vấn Cung cấp dịch vụ truy vấn dự đoán cho các lượt tìm kiếm địa lý dựa trên văn bản, trả về các truy vấn đề xuất khi người dùng nhập dữ liệu.

Xem chi tiết về Phản hồi của tính năng tự động hoàn thành truy vấn.

  • JSON
  • XML

Cách sử dụng API địa điểm

Các bước dưới đây bao gồm trường hợp sử dụng điển hình khi sử dụng ba trong số các điểm cuối trong 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, Ảnh địa điểm và Tự động hoàn thành truy vấn.
1 Bắt đầu thiết lập Hãy bắt đầu bằng việc Thiết lập dự án trên Google Cloud và hoàn thành các hướng dẫn thiết lập, sau đó tìm hiểu cách sử dụng khoá API.
2 Thử tìm kiếm văn bản cơ bản Sau khi có khoá API, bạn hãy thực hiện một thao tác tìm kiếm văn bản đơn giản như đã nêu trong các Ví dụ cơ bản về tìm kiếm văn bản trong hướng dẫn Tìm kiếm văn bản.
3 Sử dụng yêu cầu Tìm địa điểm Yêu cầu Tìm địa điểm sẽ trả về mã địa điểm cùng với các trường dữ liệu mà bạn yêu cầu, chẳng hạn như giờ mở cửa, địa chỉ và ảnh. Xem Tìm ví dụ về Địa điểm và thử một ví dụ phù hợp hơn với trường hợp sử dụng của bạn.
4 Tìm hiểu thông tin cơ bản về phản hồi của tính năng Tìm địa điểm Khám phá dữ liệu được trả về qua phản hồi Tìm địa điểm. Xem bài viết Tìm câu trả lời cho địa điểm để biết thêm chi tiết.
5 Sử dụng mã địa điểm để biết thêm thông tin chi tiết Phản hồi Tìm địa điểm không cung cấp tất cả dữ liệu có sẵn cho một địa điểm cụ thể. Bạn có thể sử dụng ID địa điểm được trả về từ phản hồi Tìm địa điểm để nhận thêm thông tin chi tiết về một địa điểm. Xem Thông tin chi tiết về địa điểm.

Thư viện ứng dụng có sẵn

Hãy gọi API này bằng ngôn ngữ mà bạn chọn thông qua một trong các thư viện ứng dụng sau:

Ứng dụng khách Java, Ứng dụng khách Python, Máy khách Go và Ứng dụng khách Node.js cho Dịch vụ Google Maps là các thư viện ứng dụng được cộng đồng hỗ trợ, có nguồn mở theo Giấy phép Apache 2.0. Tải xuống từ GitHub, nơi bạn cũng có thể tìm thấy hướng dẫn cài đặt và mã mẫu.

Các bước tiếp theo