Żą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. 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ądzenie location może zostać przyciągnięte do innej panoramy.

Lub:

  • pano to identyfikator konkretnej 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ł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 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ć.

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

  2. 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 , aby zweryfikować, czy wszystkie 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 od 0 do 360 (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ślonego location, od punktu, w którym znajdowało się najbliższe zdjęcie podjętych działań.
  • fov (wartość domyślna to 90) 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.


    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 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 to 50) 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 to true i false 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 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. 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
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 szary obraz ogólny z tekstem „Niestety, brak zdjęć tutaj.”, 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ęć”.
Rysunek: zdjęcie ogólne wyświetlane, gdy brak dostępnych zdjęć dla w określonej lokalizacji.

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