Geolocation API – Übersicht

Die Geolocation API ist ein Dienst, der eine HTTPS-Anfrage mit den Mobilfunkmasten und WLAN-Zugangspunkten akzeptiert, die ein mobiler Client erkennen kann. Für jede gültige Eingabe werden Breiten- und Längengradkoordinaten und ein Radius zurückgegeben, der die Genauigkeit des Ergebnisses angibt.

Vorteile der Geolocation API

Verwenden Sie die Geolocation API, um Mobilgeräte zu finden, die keine nativen Funktionen zur Standortbestimmung bieten.

Möglichkeiten mit der Geolocation API

Mit der Geolocation API können Sie raumbezogene Daten von Mobilfunkmasten und WLAN-Knoten verwenden, um den Standort eines Geräts zu ermitteln, das keine native Standortbestimmung oder GPS hat.

Funktionsweise der Geolocation API

Die Geolocation API verwendet Datenfelder von Mobilgeräten, Daten von Mobilfunkmasten und Daten aus dem Array von WLAN-Zugangspunkten, um Breiten- und Längengradkoordinaten und einen Genauigkeitsradius zurückzugeben. Sie akzeptiert eine HTTPS-POST-Anfrage an ihren Endpunkt zusammen mit einem strukturierten JSON-Anfragetext. Das folgende Beispiel zeigt die Anfrage-URL und ein Beispiel für den Anfragetext:

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
}'
Die API kann Daten für verschiedene gängige Felder für mobile Daten zurückgeben, wie unten angegeben.

Ressourcen

In der folgenden Tabelle werden die Felder im Anfragetext des Endpunktaufrufs für die Standortbestimmung zusammengefasst, zusammen mit dem Typ der Daten, die aus solchen Abfragen bereitgestellt werden.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Datenfelder für Mobilfunkgeräte wie Mobilfunkanbieter, Gerät und Netzwerkinformationen Breiten-/Längengradkoordinaten und einen Genauigkeitsradius JSON
Mobilfunkmastdaten wie Ortsvorwahl und Mobilfunk-Ländercodes.
Daten zu WLAN-Zugangspunkten wie MAC-Adresse und Signalstärke

Geolocation API verwenden

1 Jetzt einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung für die Einrichtung.
2 Anfrage zur Standortbestimmung ausprobieren Sobald Sie einen API-Schlüssel haben, können Sie die Geolocation API mit cURL oder Postman testen. Weitere Informationen finden Sie im Leitfaden Anfragen und Antworten zur Standortbestimmung unter Beispielanfragen.
3 CellID von verschiedenen Funkmasten abrufen Weitere Informationen zum Zugriff auf ältere bzw. neuere Sendemasten finden Sie unter Calculating cellID und Calculating newRadioCellID
4 Grundlagen zu Antworten Sehen Sie sich die Antworten auf Daten zur Standortbestimmung an, um die Verwendung von Höhendaten für Ihre App vorzubereiten. Weitere Informationen finden Sie unter Antworten zur Standortbestimmung.

Verfügbare Clientbibliotheken

Rufen Sie diese API in der Sprache Ihrer Wahl über eine der folgenden Clientbibliotheken auf:

Die Java-, Python-, Go- und Node.js-Clients für Google Maps-Dienste sind von der Community unterstützte Clientbibliotheken, die unter der Apache 2.0-Lizenz als Open Source zur Verfügung gestellt werden. Laden Sie sie von GitHub herunter. Dort finden Sie auch eine Installationsanleitung und Beispielcode.

Nächste Schritte