Zanim zaczniesz kodować swoją pierwszą aplikację kliencką, musisz wykonać kilka czynności, jeśli jeszcze nie zostało to zrobione.
Załóż konto Google
Aby utworzyć projekt w konsoli interfejsów API Google, musisz mieć konto Google. Jeśli masz już konto, nie musisz nic więcej robić.
Możesz też utworzyć osobne konto Google na potrzeby testów.
Wypróbuj Google Street View
W dokumentacji API założono, że korzystasz z Google Street View i znasz pojęcia związane z programowaniem i formatami danych internetowych.
Jeśli nie używasz Google Street View, zanim zaczniesz kodować, wypróbuj interfejs.
Tworzenie projektu dla klienta
Zanim będzie można wysyłać żądania do Google Street View, musisz poinformować Google o swoim kliencie i aktywować dostęp do interfejsu API. W tym celu trzeba użyć konsoli API Google do utworzenia projektu, który jest nazwaną kolekcją ustawień i informacji o dostępie do interfejsu API, a następnie zarejestrować aplikację.
Aby zacząć korzystać z interfejsu Google Street View Publish API, musisz najpierw użyć narzędzia do konfiguracji, które przeprowadzi Cię przez proces tworzenia projektu w konsoli Google API, włączania interfejsu API i tworzenia danych logowania.
Jeśli nie masz jeszcze utworzonego klucza interfejsu API aplikacji, kliknij Utwórz dane logowania. Poszukaj swojego klucza interfejsu API w sekcji Klucze interfejsu API.
Poznaj podstawy REST
Interfejs API można wywołać na 2 sposoby:
- Wysyłanie żądań HTTP i analizowanie odpowiedzi.
- Korzystasz z bibliotek klienta.
Jeśli nie chcesz korzystać z bibliotek klienckich, musisz zrozumieć podstawy REST.
REST to architektura oprogramowania zapewniająca wygodne i spójne podejście do żądania oraz modyfikowania danych.
Termin REST to skrót od " State State Transfer. W kontekście interfejsów API Google oznacza to użycie czasowników HTTP do pobierania i modyfikowania danych przechowywanych przez Google.
W systemie REST zasoby są przechowywane w magazynie danych. Klient wysyła żądanie wykonania określonego działania (na przykład utworzenia, pobrania, zaktualizowania lub usunięcia zasobu), a serwer wykonuje działanie i wysyła odpowiedź, często w postaci reprezentacji określonego zasobu.
W interfejsach API REST Google klient określa działanie za pomocą czasownika HTTP, takiego jak POST
, GET
, PUT
lub DELETE
. Określa zasób przez unikalny globalnie identyfikator URI tego formularza:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Wszystkie zasoby API mają unikalne identyfikatory URI dostępne przy użyciu HTTP, dlatego funkcja REST umożliwia zapisywanie danych w pamięci podręcznej i jest zoptymalizowana pod kątem współpracy z rozproszoną infrastrukturą sieciową.
Definicje metod znajdziesz w dokumentacji standardu HTTP 1.1. Zawierają one specyfikacje GET
, POST
, PUT
i DELETE
.
REST w interfejsie Google Street View Publish API
Operacje interfejsu API Google Street View Publish są mapowane bezpośrednio na czasowniki HTTP REST.
Konkretne formaty identyfikatorów URI interfejsu Google Street View Publish API:
https://www.googleapis.com/streetviewpublish/v1/resourcePath?parameters
Pełny zestaw identyfikatorów URI używanych w każdej obsługiwanej operacji w interfejsie API znajdziesz w dokumentacji Google Street View Publish API.
Poznaj podstawy JSON
Interfejs Google Street View Publish API zwraca dane w formacie JSON.
JSON (JavaScript Object Notation) to popularny, niezależny od języka format danych, który reprezentuje prosty tekst reprezentujący dowolne struktury danych. Więcej informacji znajdziesz na stronie json.org.