Żądanie i odpowiedź w Street View

Żą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ądzenie location 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ład size=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ć.

  1. 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.

  2. 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 od 0 do 360 (obie oznaczają północ, 90 to wschód, a 180 południe). Jeśli nie określisz kierunku, obliczona zostanie wartość kierująca aparat w stronę wskazanego obiektu location od punktu, w którym zrobiono najbliższe zdjęcie.
  • fov (wartość domyślna to 90) 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.


    Zrzut ekranu z szerokim polem widzenia, w którym widać sufit, ściany, podłogę i okno zbiornika wewnątrz oceanarium. Zrzut ekranu ze zbliżeniem w polu widzenia przedstawiającym powiększone szczegóły zdjęcia Street View znajdującego się w oceanarium.
    (po lewej: fov=120; po prawej: fov=20)

  • pitch (wartość domyślna to 0) 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 to 50) 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 to true i false. 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 to default) 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
Zrzut ekranu z punktem widokowym z poziomu ulicy przedstawiający zelektryzowane tory kolejowe.

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:

Zrzut ekranu pokazujący ogólny obraz wyświetlany, gdy dla określonej lokalizacji nie są dostępne żadne zdjęcia. Tło jest jasnobrązowe z tekstem „Brak zdjęć”.
Ilustracja: ogólny obraz wyświetlany, gdy nie ma dostępnych zdjęć dla określonej lokalizacji.

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 na true. 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ę.