
Geolocation API to usługa, która akceptuje żądanie HTTPS z stacją bazową i punktami dostępu Wi-Fi, które może wykryć klient mobilny. Zwraca współrzędne szerokości i długości geograficznej oraz promień wskazujący dokładność wyniku dla każdego prawidłowej wartości wejściowej.
Dlaczego warto korzystać z interfejsu Geolocation API
Interfejs Geolocation API służy do zlokalizowania urządzeń mobilnych, które nie obsługują natywnych funkcji geolokalizacji.
Do czego służy interfejs Geolocation API
Dzięki interfejsowi Geolocation API możesz używać danych geoprzestrzennych ze stacji bazowych i węzłów sieci Wi-Fi, aby określić lokalizację urządzenia, które nie ma natywnej geolokalizacji ani GPS.
Jak działa interfejs Geolocation API
Interfejs Geolocation API korzysta z pól danych z urządzeń komórkowych, danych o stacjach bazowych sieci komórkowych oraz danych z tablicy punktów dostępu Wi-Fi, aby zwracać współrzędne szerokości i długości geograficznej oraz promień dokładności. Akceptuje żądanie HTTPS POST do swojego punktu końcowego oraz treść uporządkowanego żądania JSON. Poniższy przykład pokazuje URL żądania i przykładową treść żądania:
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 }'Interfejs API może zwracać dane z wielu popularnych pól komórkowej transmisji danych, jak opisano poniżej.
Zasoby
W tabeli poniżej znajdziesz podsumowanie pól w treści żądania wywołania punktu końcowego geolokalizacji wraz z typem danych dostarczanych z takich zapytań.
Zasoby danych | Zwrócone dane | Format zwracanych |
---|---|---|
Pola danych urządzenia mobilnego, takie jak informacje o operatorze, urządzeniu i sieci. | Współrzędne szerokości i długości geograficznej oraz promień dokładności | JSON |
Dane stacji bazowych, takie jak numer kierunkowy lokalizacji i kody krajów komórkowych. | ||
Dane punktów dostępu do sieci Wi-Fi takie jak adres MAC i siła sygnału. |
Jak korzystać z interfejsu Geolocation API
1 | Konfiguracja | Zacznij od konfigurowania projektu Google Cloud i postępuj zgodnie z podanymi niżej instrukcjami. |
2 | Wyślij prośbę o geolokalizację | Gdy masz klucz interfejsu API, możesz zacząć testować interfejs Geolocation API za pomocą cURL lub Postmana. Więcej informacji znajdziesz w sekcji Przykładowe żądania w przewodniku po żądaniach geolokalizacji i odpowiedzi. |
3 | Uzyskuj identyfikator stacji bazowej z różnych stacji radiowych | Aby uzyskać dostęp odpowiednio do starszych i nowszych wież, zapoznaj się z sekcją Obliczanie identyfikatora komórki i Obliczanie wartości newRadioCellID. |
4 | Podstawowe informacje o odpowiedziach | Zapoznaj się z danymi geolokalizacyjnymi, by przygotować aplikację do korzystania z danych o wysokości. Więcej informacji znajdziesz w artykule Odpowiedzi geolokalizacyjne. |
Dostępne biblioteki klienta
Wywołaj ten interfejs API w wybranym języku za pomocą jednej z tych bibliotek klienta:
- Klient Java dla usług Map Google
- Klient Pythona dla usług Map Google
- Klient Go dla usług Map Google
- Klient Node.js dla usług Map Google
Klienty Java, Python, Go i Node.js dla usług Map Google to obsługiwane przez społeczność biblioteki klienckie udostępniane na licencji open source na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.
Co dalej
- Pierwsze kroki z przykładowymi żądaniami i odpowiedziami: przeczytaj artykuł o żądaniach i odpowiedziach na geolokalizację.
- Zastosuj sprawdzone metody: zapoznaj się ze sprawdzonymi metodami dotyczącymi usług internetowych.
- Informacje o rozliczeniach: przeczytaj artykuł Korzystanie i płatności.