Bevor Sie mit der Codierung Ihrer ersten Client-Anwendung beginnen, müssen Sie einige Vorbereitungen treffen (falls noch nicht geschehen).
Erstellen Sie sich ein Google-Konto
Sie benötigen ein Google-Konto, um ein Projekt in der Google API Console zu erstellen. Wenn Sie bereits ein solches Konto haben, sind Sie schon startklar.
Für Testzwecke könnte ein separates Google-Konto sinnvoll sein.
Google Street View ausprobieren
In dieser API-Dokumentation wird davon ausgegangen, dass Sie bereits Google Street View verwendet haben und mit Webprogrammierung und Webdatenformaten vertraut sind.
Wenn Sie Google Street View noch nicht verwendet haben, sehen Sie sich die Benutzeroberfläche an, bevor Sie mit dem Programmieren beginnen.
Projekt für den Client erstellen
Bevor Sie Anfragen an Google Street View senden können, müssen Sie Google über Ihren Kunden informieren und den Zugriff auf die API aktivieren. Dazu verwenden Sie die Google API-Konsole, um ein Projekt zu erstellen, bei dem es sich um eine benannte Sammlung von Einstellungen und API-Zugriffsinformationen handelt, und registrieren Ihre Anwendung.
Damit Sie die Google Street View Publish API verwenden können, müssen Sie verwenden das Einrichtungstool, das Sie durch die Erstellung eines Projekts im Google API Console, um die API zu aktivieren und Anmeldedaten zu erstellen
Erstellen Sie, falls noch nicht geschehen, den API-Schlüssel für die Anwendung. Dazu klicken Sie auf Anmeldedaten erstellen > API-Schlüssel. Suchen Sie dann in der API- Schlüssel.
Informieren Sie sich über die REST-Grundlagen
Es gibt zwei Möglichkeiten, die API aufzurufen:
- HTTP-Anfragen senden und die Antworten parsen
- Clientbibliotheken verwenden
Wenn Sie sich gegen die Verwendung von Clientbibliotheken entscheiden, müssen Sie die Grundlagen von REST verstehen.
REST ist eine Art Softwarearchitektur, die einen bequemen und einheitlichen Ansatz zur Abfrage und Bearbeitung von Daten bietet.
Der Begriff REST steht für Representational State Transfer. Im Zusammenhang mit Google-APIs bezieht es sich auf die Verwendung von HTTP-Verben zum Abrufen und Ändern von Darstellungen von Daten, die von Google gespeichert sind.
In einem als "RESTful" bezeichneten System werden Ressourcen in einem Datenspeicher abgelegt; ein Client sendet eine Aufforderung, der Server möge eine bestimmte Aktion ausführen (z. B. eine Ressource erstellen, abfragen, aktualisieren oder löschen), und der Server führt die Aktion aus und sendet eine Antwort, oft in Form einer Darstellung der angegebenen Ressource.
In Googles RESTful APIs spezifiziert der Client eine Aktion mit einem HTTP-Verb wie POST, GET, PUT oder DELETE. Eine Ressource wird anhand eines weltweit eindeutigen URIs im folgenden Format spezifiziert:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Weil alle API-Ressourcen eindeutige, über HTTP zugängliche URIs haben, ermöglicht REST das Caching von Daten und ist optimal geeignet, mit der verteilten Infrastruktur des Webs zu arbeiten.
Dafür können die Methodendefinitionen in der Dokumentation der HTTP 1.1-Standards hilfreich sein. Hier finden Sie auch die Spezifikationen für GET, POST, PUT und DELETE.
REST in der Google Street View Publish API
Die Google Street View Publish API-Vorgänge lassen sich direkt REST-HTTP-Verben zuordnen.
Für die Google Street View Publish API-URIs gelten folgende spezielle Formate:
https://www.googleapis.com/streetviewpublish/v1/resourcePath?parameters
Die vollständige Gruppe von URIs, die für die einzelnen unterstützten Vorgänge in der API verwendet wird, ist in der Referenz zur Google Street View Publish API zusammengefasst.
Informationen zu JSON-Grundlagen
Die Google Street View Publish API gibt Daten im JSON-Format zurück.
JSON (JavaScript Object Notation) ist ein gängiges sprachunabhängiges Datenformat, das eine einfache Textdarstellung beliebiger Datenstrukturen bietet. Weitere Informationen finden Sie unter json.org.