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

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

Lý do nên sử dụng Geolocation API

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

Những việc bạn có thể làm với Geolocation API

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

Cách hoạt động của Geolocation API

Geolocation API sử dụng các trường dữ liệu của thiết bị di động, dữ liệu 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à bán kính độ chính xác. Nó chấp nhận yêu cầu HTTPS POST đến điểm cuối cùng với một nội dung yêu cầu có cấu trúc JSON. Ví dụ sau đây cho thấy URL yêu cầu và một ví dụ về nội dung yêu cầ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 này 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 lệnh gọi đ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ề
Các trường dữ liệu của thiết bị di động chẳng hạn như thông tin về nhà mạng, thiết bị và mạng. Toạ độ vĩ độ/kinh độ và bán kính độ chính xác JSON
Dữ liệu về trạm phát sóng, chẳng hạn như mã vùng vị trí và mã quốc gia của thiết bị di động.
Dữ liệu về đ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 Geolocation API

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

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

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

Ứng dụng Java, ứng dụng Python, ứng dụng Go và ứng dụng 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. Bạn có thể tải các tệp này 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.

Bước tiếp theo