Omówienie interfejsu Geolocation API

Geolocation API to usługa, która akceptuje żądania HTTPS z parametrem stacji bazowej i punktów dostępu Wi-Fi, które klient komórkowy może wykryć. Zwraca szerokości i długości geograficznej oraz promień oznaczający dokładność dla wszystkich prawidłowych danych wejściowych.

Dlaczego warto korzystać z interfejsu Geolocation API

Używanie interfejsu API geolokalizacji do lokalizowania urządzeń mobilnych, które nie zapewniają natywnej geolokalizacji funkcje zabezpieczeń.

Do czego służy interfejs Geolocation API

Dzięki interfejsowi Geolocation API możesz korzystać z danych geoprzestrzennych z masztów telefonii komórkowej. i węzłów Wi-Fi, aby określić lokalizację urządzenia, które nie ma natywnej geolokalizacji ani GPS.

Jak działa interfejs API geolokalizacji

Interfejs Geolocation API korzysta z pól danych z urządzenia komórkowego, stacji bazowej sieci komórkowej danych, a także dane w tablicy punktów dostępu Wi-Fi w celu zwrócenia współrzędnych geograficznych w promieniu wokół punktu 1. Akceptuje żądanie HTTPS POST do swojego punktu końcowego oraz uporządkowane żądanie JSON . Poniżej znajduje się przykład adresu URL i treści żą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 dla wielu typowych pól danych komórkowych, jak opisano poniżej.

Zasoby

Poniższa tabela zawiera podsumowanie pól w treści żądania punktu końcowego geolokalizacji. oraz rodzaj danych dostarczonych z takich zapytań.

Zasoby danych Zwrócone dane Format zwrotu
Pola danych z urządzeń komórkowych takie jak operator, urządzenie i informacje o sieci. Współrzędne szerokości i długości geograficznej oraz promień dokładności JSON
dane z masztów telefonii komórkowej, np. numeru kierunkowego lokalizacji i numerów kierunkowych kraju.
Dane punktów dostępu Wi-Fi, takie jak adres MAC czy siła sygnału.

Jak korzystać z interfejsu Geolocation API

1 Konfiguracja Zacznij od Konfigurowanie projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji.
2 Spróbuj przesłać prośbę o geolokalizację Po uzyskaniu klucza interfejsu API możesz rozpocząć testowanie interfejsu Geolocation API za pomocą cURL lub Postmana. Zobacz przykładowe żądania. Więcej informacji znajdziesz w przewodniku Żądania i odpowiedzi związane z geolokalizacją.
3 Uzyskiwanie identyfikatorów komórek z różnych stacji radiowych Patrz: obliczanie identyfikatora komórki. i obliczanie wartości newRadioCellID z dostępem do starszych i nowszych wież.
4 Podstawowe informacje o odpowiedziach Przejrzyj odpowiedzi dotyczące danych geolokalizacji, by przygotować się do korzystania z danych o wysokości względnej w aplikacji. Zobacz Odpowiedzi na geolokalizację .

Dostępne biblioteki klienta

Wywołaj ten interfejs API w języku możesz wybrać za pomocą jednej z tych bibliotek klienta:

klient Java, Python, Go i Node.js dla Map Google; Usługi to obsługiwane przez społeczność biblioteki klienckie udostępniane na zasadach open source Licencja Apache 2.0 Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?