Żą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. Standardowo w adresach URL wszystkie parametry są oddzielane 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 parą współrzędnych szerokości i długości geograficznej (40.457375,-80.009353
) i musi być zakodowane w adresie URL. Przed wysłaniem zgłoszenia zmień adresy takie jak „City Hall, New York, NY” na „City+Hall,New+York,NY”. Interfejs Street View Static API zostanie przyciągnięty do zdjęcia panoramicznego znajdującego się najbliżej lokalizacji. Gdy podasz ciąg tekstowy adresu, interfejs API może użyć innej lokalizacji kamery, aby lepiej wyświetlić określoną lokalizację. Gdy podasz współrzędne szerokości i długości geograficznej, interfejs API wyszukuje zdjęcie o promieniu 50 metrów znajdującym się najbliżej lokalizacji. Zdjęcia Street View są co jakiś czas odświeżane i za każdym razem mogą zostać zrobione z nieco innej pozycji, dlatego podczas aktualizowania zdjęć urządzenielocation
może zostać przyciągnięte do innej panoramy.
Lub:
pano
to identyfikator konkretnej panoramy. Panoramy mogą zmieniać identyfikator z czasem, więc nie zachowuj go. Zamiast tego zapisz adres lokalizacji lub współrzędne szerokości i długości geograficznej, by można było odświeżyć identyfikator panoramy. Szczegółowe informacje 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 konsoli Google Cloud i umożliwia Google skontaktowanie się z Tobą w sprawie aplikacji. Więcej informacji znajdziesz w artykule na temat uzyskiwania klucza i podpisu.
Odśwież identyfikatory usuniętych panoram
Jeśli przy próbie pobrania identyfikatora panoramy zobaczysz ZERO_RESULTS
lub jej brak, oznacza to, że identyfikator został usunięty i trzeba go odświeżyć.
Zapisz adres lokalizacji lub współrzędne szerokości i długości geograficznej, które posłużyły Ci do uzyskania identyfikatora panoramy. W razie potrzeby możesz odświeżyć widok.
Gdy wykryjesz zmianę identyfikatora panoramy, użyj adresu pierwotnej lokalizacji lub współrzędnych szerokości i długości geograficznej, by ponownie wyszukać najbliższe panoramy w tej lokalizacji i uzyskać nowy identyfikator.
Parametry opcjonalne
signature
(zalecane) to podpis cyfrowy używany do sprawdzania, czy każda witryna generująca żądania przy użyciu Twojego klucza interfejsu API jest do tego upoważniona. Żą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 korzystających z abonamentu Premium na Google Maps Platform wymagany jest podpis cyfrowy. Dowiedz się więcej o parametrach uwierzytelniania w przypadku klientów korzystających z abonamentu Premium.
heading
wskazuje na kompas, w kierunku kamery. Akceptowane wartości to od0
do360
(obie oznaczają północ,90
to wschód, a180
południe). Jeśli nie określisz kierunku, obliczona zostanie wartość kierująca aparat w stronę wskazanego obiektulocation
od punktu, w którym zrobiono najbliższe zdjęcie.fov
(wartość domyślna to90
) określa poziome pole widzenia obrazu wyrażone w stopniach, z maksymalną dozwoloną wartością120
. Gdy korzystasz z widocznego obszaru o stałym rozmiarze, np. w przypadku zdjęcia Street View o określonej wielkości, pole widzenia jest powiązane z powiększeniem, przy czym mniejsze liczby oznaczają 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 pojazdu Street View. Często, ale nie zawsze, jest to płaska orientacja pozioma. Wartości dodatnie powodują obrót kamery w górę (90
stopni oznacza pionowy widok w górę), a ujemne w dół (-90
oznacza pionowy widok w dół).radius
(wartość domyślna to50
) określa promień (w metrach), w którym należy wyszukać panoramę, wyśrodkowany na danej szerokości i długości geograficznej. Prawidłowe wartości to nieujemne liczby całkowite.return_error_code
wskazuje, czy interfejs API powinien zwrócić kod błędu, jeśli nie znaleziono żadnego obrazu (404 NOT FOUND) czy w odpowiedzi na nieprawidłowe żądanie (400 BAD REQUEST). Prawidłowe wartości totrue
ifalse
. Jeśli ma wartośćtrue
, w miejscu ogólnego szarego obrazu wyświetlany jest komunikat o błędzie. Dzięki temu nie musisz wykonywać osobnego wywołania w celu sprawdzenia dostępności 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. Wyszukiwanie nie jest ograniczone do konkretnych źródeł.outdoor
ogranicza wyszukiwanie do kolekcji plenerowych. Kolekcje wnętrz nie są uwzględniane w wynikach wyszukiwania. W danej lokalizacji mogą nie istnieć panoramy na zewnątrz. Pamiętaj też, że wyszukiwanie zwróci tylko panoramy, jeśli można określić, czy zdjęcia są wewnątrz czy na zewnątrz. Na przykład zdjęcia sferyczne nie są zwracane, ponieważ nie wiadomo, czy znajdują się w pomieszczeniu 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 szare zdjęcie ogólne z tekstem „Brak zdjęć”, jak widać w tym przykładzie:
Pokaż tylko prawidłowe obrazy
Aby uniknąć wyświetlania zdjęcia ogólnego i upewnić się, że na stronie internetowej wyświetlają się tylko prawidłowe zdjęcia ze statycznego interfejsu Street View API, postępuj zgodnie z tymi wskazówkami:
- Ustaw parametr
return_error_code
natrue
. Jeśli nie ma takiego zdjęcia, interfejs Street View static API zwraca błąd 404 (NIE ZNALEZIONO) zamiast ogólnego szarego zdjęcia. - Zanim wyślesz prośbę, poproś o metadane zdjęcia Street View, aby określić, czy są dostępne zdjęcia przedstawiające daną lokalizację.