Tổng quan về API vị trí địa lý

API vị trí địa lý là dịch vụ chấp nhận yêu cầu HTTPS có trạm phát sóng và điểm truy cập Wi-Fi mà ứng dụng di động có thể phát hiện. Trả về vĩ độ/kinh độ và bán kính cho biết độ chính xác của kết quả cho từng đầu vào hợp lệ.

Tại sao bạn nên sử dụng API vị trí địa lý

Sử dụng API vị trí địa lý để định vị thiết bị di động không cung cấp vị trí địa lý gốc các tính năng AI mới.

Bạn có thể làm gì với API vị trí địa lý

Với API vị trí địa lý, bạn có thể sử dụng dữ liệu không gian địa lý từ các tháp phát sóng và nút Wi-Fi để xác định vị trí của thiết bị không có GPS hoặc vị trí địa lý gốc.

Cách hoạt động của API vị trí địa lý

API vị trí địa lý sử dụng các trường dữ liệu thiết bị di động, trạm phát sóng và dữ liệu mảng điểm truy cập Wi-Fi để trả về toạ độ vĩ độ/kinh độ và độ chính xác của bạn. Phương thức này chấp nhận yêu cầu POST qua HTTPS đến điểm cuối cùng với yêu cầu có cấu trúc JSON nội dung. Ví dụ sau đây cho thấy URL yêu cầu và nội dung yêu cầu mẫu: 

curl -X POST "https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d \
'{ "homeMobileCountryCode":310,
   "homeMobileNetworkCode":410,
   "radioType":"gsm",
   "carrier":"Vodafone",
   "considerIp":true
}'
API có thể trả về dữ liệu cho một số trường dữ liệu di động phổ biến như được chỉ ra dưới đây.

Tài nguyên

Bảng sau đây tóm tắt các trường trong nội dung yêu cầu của điểm cuối vị trí địa lý cùng với loại dữ liệu được cung cấp từ các truy vấn đó.

Tài nguyên dữ liệu Dữ liệu được trả về Định dạng trả về
Trường dữ liệu thiết bị di động chẳng hạn như thông tin về nhà mạng, thiết bị và mạng. Vĩ độ/kinh độ và bán kính chính xác JSON
Dữ liệu trạm di động, chẳng hạn như mã vùng của vị trí và mã di động quốc gia.
dữ liệu điểm truy cập Wi-Fi, chẳng hạn như địa chỉ MAC và cường độ tín hiệu.

Cách sử dụng API vị trí địa lý

1 Thiết lập Bắt đầu bằng Thiết lập dự án trên Google Cloud và hoàn thành hướng dẫn thiết lập tiếp theo.
2 Thử dùng một yêu cầu định vị vị trí Sau khi có khoá API, bạn có thể bắt đầu thử nghiệm API vị trí địa lý bằng cách sử dụng cURL hoặc Người đưa thư. Hãy xem phần Yêu cầu mẫu trong hướng dẫn Yêu cầu về vị trí địa lý và phản hồi để biết thông tin chi tiết.
3 Lấy mã nhận dạng điện thoại di động (cellID) từ các tháp phát thanh Xem bài viết Tính toán cellID và Tính toán newRadioCellID để truy cập vào các toà tháp cũ và mới hơn tương ứng.
4 Tìm hiểu thông tin cơ bản về câu trả lời Khám phá phản hồi về dữ liệu định vị vị trí để chuẩn bị sử dụng dữ liệu về độ cao cho ứng dụng. Xem Phản hồi về vị trí địa lý để biết thông tin chi tiết.

Thư viện ứng dụng hiện có

Gọi API này bằng ngôn ngữ của thông qua một trong các thư viện ứng dụng sau đây:

Ứng dụng Java, Ứng dụng Python, Ứng dụng Go và Ứng dụng Node.js cho Google Maps Các dịch vụ là thư viện ứng dụng được cộng đồng hỗ trợ, nguồn mở theo Giấy phép Apache 2.0. Tải các tệp đó 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