![Tổng quan về API vị trí địa lý](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/landing/places-api_480.png?authuser=7&hl=vi)
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:
- Java Ứng dụng cho Dịch vụ Google Maps
- Python Ứng dụng cho Dịch vụ Google Maps
- Ứng dụng Go cho Dịch vụ Google Maps
- Node.js Ứng dụng 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 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
- Bắt đầu với các yêu cầu và phản hồi mẫu: Truy cập Yêu cầu và phản hồi về vị trí địa lý
- Làm theo các phương pháp hay nhất: Chuyển đến Các phương pháp hay nhất về dịch vụ web.
- Tìm hiểu về việc thanh toán: Chuyển đến bài viết Mức sử dụng và thanh toán.