Omówienie interfejsu Geolocation API

Geolocation API to usługa, która akceptuje żądanie HTTPS z wieżą 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łowego sygnału.

Dlaczego warto korzystać z interfejsu API geolokalizacji

Znajdź urządzenia mobilne, które nie obsługują natywnych funkcji geolokalizacji za pomocą interfejsu API geolokalizacji.

Możliwości interfejsu Geolocation API

Za pomocą interfejsu Geolocation API możesz wykorzystać dane geoprzestrzenne z wież bazowych sieci komórkowych i węzłów Wi-Fi, aby określić lokalizację urządzenia bez geolokalizacji lub GPS-a.

Jak działa interfejs API geolokalizacji

Interfejs Geolocation API wykorzystuje pola danych urządzeń komórkowych, dane masztów telefonii komórkowej oraz dane tablicy punktów dostępu Wi-Fi do zwracania współrzędnych szerokości i długości geograficznej oraz promienia dokładności. Przyjmuje żądanie HTTPS POST do punktu końcowego wraz z treścią żądania JSON. Poniższy przykład pokazuje adres URL żądania i przykładową treść żądania: 

    https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY

    {
      "homeMobileCountryCode": 310,
      "homeMobileNetworkCode": 410,
      "radioType": "gsm",
      "carrier": "Vodafone",
      "considerIp": true,
      "cellTowers": [
        // See the Cell Tower Objects section below.
      ],
      "wifiAccessPoints": [
        // See the WiFi Access Point Objects section below.
      ]
    }
Interfejs API może zwracać dane dla wielu typowych pól komórkowej transmisji danych, jak podano poniżej.

Zasoby

Poniższa tabela zawiera podsumowanie pól w treści żądania wywołania punktu geolokalizacji oraz typ danych przesłanych z takich zapytań.

Zasoby danych Zwrócone dane Format zwrotu
Pola dotyczące urządzeń mobilnych, takie jak informacje o operatorze, urządzeniu i sieci. współrzędne geograficzne i promień dokładności. JSON
Dane dotyczące masztów telefonii komórkowej, takie jak kod kraju i kod kraju.
Dane punktów dostępu Wi-Fi, takie jak adres MAC i siła sygnału.

Jak korzystać z interfejsu API geolokalizacji

1 Konfiguracja Zacznij od Skonfiguruj projekt Google Cloud i postępuj zgodnie z instrukcjami konfiguracji, które znajdziesz poniżej.
2 Spróbuj przesłać prośbę o lokalizację Gdy masz już klucz interfejsu API, możesz zacząć testować interfejs Geolocation API za pomocą narzędzia cURL lub Postman. Patrz Przykładowe żądania w przewodniku Prośby o geolokalizację i odpowiedź.
3 Pobierz identyfikator stacji z różnych wież radiowych Aby dowiedzieć się, jak uzyskać dostęp do starszych i nowszych wież, zobacz, jak obliczam IDID i Calculating newRadioCellID.
4 Podstawowe informacje o odpowiedziach Zapoznaj się z odpowiedziami na temat danych geolokalizacyjnych, aby przygotować się do korzystania z danych o wysokości dla aplikacji. Więcej informacji znajdziesz w artykule Odpowiedzi geolokalizacji.

Dostępne biblioteki klienta

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

Klient Java, Python, Go Client i Node.js dla Map Google to obsługiwane przez społeczność biblioteki klienta na licencji open source na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz również instrukcje instalacji i przykładowy kod.

Co dalej?