Omówienie interfejsu Geolocation API

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:

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