Omówienie interfejsu Geolocation API

Interfejs Geolocation API to usługa, która akceptuje żądanie HTTPS z informacjami o masztach telefonii komórkowej i punktach dostępu Wi-Fi wykrywanych przez klienta mobilnego. Zwraca współrzędne szerokości i długości geograficznej oraz promień wskazujący dokładność wyniku dla każdego prawidłowego wejścia.

Dlaczego warto korzystać z interfejsu Geolocation API

Używaj interfejsu Geolocation API do lokalizowania urządzeń mobilnych, które nie mają wbudowanych funkcji geolokalizacji.

Możliwości interfejsu Geolocation API

Interfejs Geolocation API umożliwia korzystanie z danych geoprzestrzennych ze stacji bazowych i węzłów Wi-Fi w celu określania lokalizacji urządzenia, które nie ma wbudowanej funkcji geolokalizacji ani GPS-u.

Jak działa interfejs Geolocation API

Interfejs Geolocation API używa pól danych urządzenia komórkowego, danych stacji bazowych i danych tablicy punktów dostępu Wi-Fi, aby zwracać współrzędne geograficzne (szerokość i długość geograficzną) oraz promień dokładności. Akceptuje żądanie HTTPS POST wysłane do punktu końcowego wraz z treścią żądania w formacie JSON. Poniższy przykład pokazuje adres 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 typowych pól danych komórkowych, jak wskazano poniżej.

Zasoby

W tabeli poniżej znajdziesz podsumowanie pól w treści żądania wywołania punktu końcowego geolokalizacji wraz z rodzajem danych dostarczanych przez takie zapytania.

Zasoby danych Zwrócone dane Format zwrotu
Pola danych urządzenia mobilnego, takie jak informacje o operatorze, urządzeniu i sieci. współrzędne geograficzne szerokości i długości oraz promień dokładności, JSON
Dane ze stacji bazowych, takie jak kod obszaru lokalizacji i kody kraju sieci komórkowej.
Dane punktów dostępu Wi-Fi, takie jak adres MAC i siła sygnału.

Jak korzystać z interfejsu Geolocation API

1 Konfiguracja Zacznij od artykułu Konfigurowanie projektu Google Cloud i postępuj zgodnie z instrukcjami konfiguracji.
2 Wypróbuj prośbę o lokalizację Gdy uzyskasz klucz interfejsu API, możesz zacząć testować interfejs Geolocation API za pomocą cURL lub Postmana. Szczegółowe informacje znajdziesz w przykładowych żądaniach w przewodniku Żądania i odpowiedzi dotyczące geolokalizacji.
3 Pobieranie identyfikatora komórki z różnych wież radiowych Aby uzyskać dostęp do starszych i nowszych wież, zapoznaj się z sekcjami Obliczanie identyfikatora komórki i Obliczanie identyfikatora komórki newRadioCellID.
4 Podstawowe informacje o odpowiedziach Zapoznaj się z odpowiedziami dotyczącymi danych geolokalizacyjnych, aby przygotować się do korzystania z danych o wysokości w aplikacji. Więcej informacji znajdziesz w artykule Odpowiedzi dotyczące geolokalizacji.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w wybranym języku za pomocą jednej z tych bibliotek klienta:

Klient Java, klient Python, klient Go i klient Node.js dla usług Map Google to biblioteki klientów obsługiwane przez społeczność, udostępniane na licencji Apache 2.0. Możesz je pobrać z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?