Żądanie zdjęcia Street View to adres URL HTTP w tym formacie:
https://maps.googleapis.com/maps/api/streetview?parameters
Obraz jest określany za pomocą parametrów żądania. Zgodnie ze standardem adresów URL, wszystkie parametry są rozdzielone znakiem „&”. Dozwolone parametry i ich możliwe wartości podano poniżej.
Wymagane parametry
Wykonaj jedną z tych czynności:
- Pole
location
może być ciągiem tekstowym (np.Chagrin Falls, OH
) lub pary współrzędnych szerokości i długości geograficznej (40.457375,-80.009353
), i powinien być zakodowany w adresie URL. Dlatego konwertuj adresów, takich jak „City Hall, New York, NY” do „City+Hall,New+York,NY” przed wysłaniem prośby. Interfejs Street View Static API lokalizacji. Gdy podasz ciąg tekstowy adresu, interfejs API może użyć zmienić lokalizację kamery, by lepiej wyświetlić określoną lokalizację. Gdy podasz współrzędne szerokości i długości geograficznej, interfejs API wyszukuje zdjęcie znajdujące się najbliżej lokalizacji w promieniu 50 metrów. Ponieważ zdjęcia Street View są okresowo odświeżane i mogą być za każdym razem traktowane z nieco innych pozycji, możliwe jest, Po zaktualizowaniu zdjęć urządzenielocation
może zostać przyciągnięte do innej panoramy.
Lub:
pano
to konkretny identyfikator panoramy. Panoramy mogą z czasem zmieniać identyfikator, dlatego nie zachowuj tego identyfikatora. Zamiast tego zapisz adres lokalizacji lub długości i szerokości geograficznej, by umożliwić odświeżenie identyfikatora panoramy. Dla: Więcej informacji znajdziesz w artykule Odświeżanie usuniętych identyfikatorów panoram.
oraz:
size
określa rozmiar wyjściowy obrazu w pikselach. Rozmiar jest określony jako{width}x{height}
– na przykładsize=600x400
. zwraca obraz o szerokości 600 pikseli i wysokości 400 pikseli.key
umożliwia monitorowanie wykorzystania interfejsu API przez aplikację w Konsola Google Cloud, i umożliwia Google skontaktowanie się z Tobą w sprawie Twojej aplikacji, jeśli zajdzie taka potrzeba. Więcej informacji znajdziesz w artykule na temat uzyskiwania klucza i podpisu.
Odśwież identyfikatory usuniętych panoram
Jeśli spróbujesz pobrać identyfikator panoramy i pojawi się ZERO_RESULTS
lub
brak wartości, identyfikator panoramy został usunięty i trzeba go odświeżyć.
Zapisz adres lokalizacji lub współrzędne szerokości i długości geograficznej użyte wcześniej pobierz identyfikator panoramy, by w razie potrzeby odświeżyć widok.
Jeśli zauważysz, że identyfikator panoramy się zmienił, użyj oryginalnej lokalizacji. adresu lub współrzędnych geograficznych, aby znaleźć najbliższą i pobierz nowy identyfikator panoramy.
Parametry opcjonalne
signature
(zalecane) to używany podpis cyfrowy do sprawdzania, czy witryny generujące żądania przy użyciu Twojego klucza interfejsu API są autoryzowane aby to zrobić. Żądania, które nie zawierają podpisu cyfrowego, mogą zakończyć się niepowodzeniem. Więcej informacji znajdziesz w artykule na temat uzyskiwania klucza i podpisu.Uwaga: w przypadku byłych klientów Google Maps Platform Premium usługi cyfrowe podpis jest wymagany. Więcej informacji: parametrów uwierzytelniania Klienci korzystający z abonamentu Premium.
heading
wskazuje kierunek kompasu aparat. Akceptowane wartości mieszczą się w zakresie od0
do360
(obie wartości oznaczają północ,90
to wschód,180
na południe). Jeśli nie określisz nagłówka, zostanie użyta wartość który kieruje kamerę w kierunku określonegolocation
, od punktu, w którym znajdowało się najbliższe zdjęcie podjętych działań.fov
(wartość domyślna to90
) określa poziome pole widzenia obrazu wyrażone w stopniach z maksymalną dozwoloną wartością120
. Pracując z widocznym obszarem o stałym rozmiarze, jak w przypadku zdjęcia w Street View ustaw rozmiar, pole widzenia to w gruncie rzeczy powiększenie, z mniejszymi wartościami co wskazuje wyższy poziom powiększenia.
(Po lewej:fov=120
; Po prawej:fov=20
)pitch
(wartość domyślna to0
) określa kąt obrotu kamery w górę lub w dół względem Street View pojazdu. Często, ale nie zawsze, jest to płaska orientacja pozioma. Wartości dodatnie przechyl kamerę do góry (90
stopni oznacza pionowo); wartości ujemne powodują obrót kamery w dół (-90
to oznacza prosto w dół).radius
(wartość domyślna to50
) ustawia promień (w metrach), jaki pozwala wyszukać panoramę, względem danej szerokości i długości geograficznej. Prawidłowe wartości są nieujemne liczb całkowitych.return_error_code
wskazuje, czy interfejs API powinien zwrócić kod błędu w przypadku braku obrazu (404 NOT FOUND) lub w odpowiedzi na nieprawidłowe żądanie (400 BAD REQUEST). Prawidłowe wartości totrue
ifalse
Jeśli ma wartośćtrue
, komunikat o błędzie będzie wyglądał tak: zamiast ogólnego szarego obrazu. Dzięki temu nie trzeba: utwórz osobne wywołanie, aby sprawdzić dostępność obrazu.source
(wartość domyślna todefault
) ogranicza wyszukiwanie w Street View do wybranych źródeł. Prawidłowe wartości to:default
korzysta z domyślnych źródeł Street View. wyszukiwania nie są ograniczone do konkretnych źródeł.outdoor
ogranicza wyszukiwanie do kolekcji plenerowych. Do użytku wewnątrz kolekcje nie są uwzględniane w wynikach wyszukiwania. Pamiętaj, że panoramy na zewnątrz mogą nie istnieć dla określonej lokalizacji. Pamiętaj też, że wyszukiwanie zwróci tylko panoramy gdzie można ustalić, czy są one wewnątrz czy na zewnątrz. Przykład: Zdjęcia sferyczne nie są zwracane, ponieważ nie wiadomo, czy znajdują się wewnątrz czy na zewnątrz.
To jest przykładowe żądanie.
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Brak dostępnych zdjęć
W przypadku miejsc, w których zdjęcia Street View są niedostępne, interfejs Street View Static API zwraca szary obraz ogólny z tekstem „Niestety, brak zdjęć tutaj.”, jak widać w tym przykładzie:
.Pokaż tylko prawidłowe obrazy
Aby uniknąć wyświetlania obrazu ogólnego i upewnić się, że Twoja strona internetowa wyświetlają tylko prawidłowe zdjęcia ze Street View Static API, postępuj zgodnie z sugestie:
- Ustaw parametr
return_error_code
natrue
. Powoduje to, że interfejs Street View Static API zwraca błąd 404 – NIE ZNALEZIONO zamiast ogólnego szarego obrazu, jeśli dla określoną lokalizację. - Prośba o metadane zdjęcia Street View czy są dostępne zdjęcia dla danej lokalizacji do wysłania prośby.