
API vị trí địa lý 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à ứng dụng di động có thể phát hiện. Mô-đun này trả về vĩ độ/kinh độ và bán kính cho biết độ chính xác của kết quả đối với mỗi đầu vào hợp lệ.
Lý do 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 tính năng định vị vị trí gốc.
Những việc bạn có thể làm 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 trạm phát sóng và nút Wi-Fi để biết vị trí của một thiết bị không có định vị vị trí gốc hoặc GPS.
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 về 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. 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 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à 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ư thể hiện 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 về 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. | 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 vị trí và mã di động quốc gia. | ||
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 API vị trí địa lý
1 | Bắt đầu thiết lập | Hãy bắt đầu từ việc Thiết lập dự án Google Cloud và hoàn thành hướng dẫn thiết lập tiếp theo. |
2 | Thử yêu cầu cung cấp thông tin đị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 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ề 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 từ các tháp vô tuyến khác nhau | Hãy xem bài viết Tính toán mã nhận dạng điện thoại di động và Tính toán newRadioCellID để có quyền truy cập vào các 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á 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. Xem bài viết 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
Hãy 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 cho Dịch vụ Google Maps
- Ứng dụng Python cho các dịch vụ của Google Maps
- Ứng dụng Go cho Dịch vụ Google Maps
- Ứng dụng Node.js cho Dịch vụ Google Maps
Ứ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ợ, nguồn mở theo Giấy phép Apache 2.0. Tải các mẫu 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.
Các bước tiếp theo
- Bắt đầu với các yêu cầu và phản hồi mẫu: Chuyển đến bài viết Phản hồi và yêu cầu vị trí địa lý
- Làm theo các phương pháp hay nhất: Chuyển đến phần Các phương pháp hay nhất dành cho dịch vụ web.
- Tìm hiểu về việc thanh toán: Chuyển đến phần Sử dụng và thanh toán.