Zanim zaczniesz kodować swoją pierwszą aplikację kliencką, zapoznaj się z tymi co trzeba zrobić, jeśli jeszcze nie wykonali tych czynności.
Załóż konto Google
Aby utworzyć projekt w Konsoli interfejsów API Google, musisz mieć konto Google. Jeśli masz już konto, nie musisz nic robić.
Możesz też utworzyć oddzielne konto Google do celów testowych.
Wypróbuj Google Street View
W tej dokumentacji zakładamy, że korzystasz z Google Street View, znasz pojęcia z dziedziny programowania stron internetowych oraz znasz formaty danych z sieci.
Jeśli nie znasz jeszcze Google Street View, wypróbuj interfejs, zanim zaczniesz pisać kod.
Tworzenie projektu dla klienta
Zanim zaczniesz wysyłać prośby do Google Street View, musisz powiadomić Google o swoim kliencie i aktywować dostęp do interfejsu API. W tym celu użyj Konsoli interfejsów API Google, aby utworzyć projekt, czyli nazwany zbiór ustawień i informacji o dostępie do interfejsu API, a następnie zarejestrować swoją aplikację.
Aby zacząć korzystać z interfejsu Google Street View Publish API, musisz: użyj w narzędziu konfiguracji, które przeprowadzi Cię przez proces tworzenia projektu w Konsola interfejsów API Google, włączenie interfejsu API i tworzenie danych logowania.
Jeśli jeszcze nie masz klucza interfejsu API aplikacji, utwórz go, klikając Utwórz dane logowania > API. Następnie znajdź klucz interfejsu API w interfejsie API .
Podstawy REST
Interfejs API można wywołać na 2 sposoby:
- wysyłanie żądań HTTP i analizowanie odpowiedzi;
- Za pomocą bibliotek klienta.
Jeśli zdecydujesz się nie używać bibliotek klienta, musisz znać podstawy REST.
REST to styl architektury oprogramowania, który zapewnia wygodne i spójne podejście do żądania i modyfikowania danych.
Skrót REST to reprezentatywny transfer stanowy. W kontekście interfejsów API Google oznacza to używanie czasowników HTTP do pobierania i modyfikowania reprezentacji danych przechowywanych przez Google.
W systemie REST zasoby są przechowywane w magazynie danych. klient wysyła żądanie, aby serwer wykonał określone działanie (takie jak utworzenie, pobranie, zaktualizowanie lub usunięcie zasobu), a serwer wykonuje tę czynność i wysyła odpowiedź, często w formie reprezentacji określonego zasobu.
W interfejsach API typu REST firmy Google klient określa działanie za pomocą czasownika HTTP, takiego jak POST, GET, PUT lub DELETE. Wskazuje zasób za pomocą globalnie unikalnego identyfikatora URI o następującej postaci:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Ponieważ wszystkie zasoby interfejsu API mają unikalne identyfikatory URI dostępne przez HTTP, interfejs REST umożliwia buforowanie danych i jest zoptymalizowany pod kątem pracy z rozproszoną infrastrukturą sieciową.
Definicje metod znajdziesz w dokumentacji standardów HTTP 1.1. zawierają one specyfikacje GET, POST, PUT i DELETE.
REST w interfejsie Google Street View Publish API
Operacje Google Street View Publish API są mapowane bezpośrednio na czasowniki HTTP REST.
Identyfikatory URI Google Street View Publish API mają mieć następujące formaty:
https://www.googleapis.com/streetviewpublish/v1/resourcePath?parameters
Pełny zestaw identyfikatorów URI używanych w przypadku każdej obsługiwanej operacji w interfejsie API znajduje się w dokumencie Materiały referencyjne interfejsu Google Street View Publish API.
Podstawy kodu 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 w prosty sposób przedstawia dowolne struktury danych w formie tekstowej. Więcej informacji znajdziesz na stronie json.org.