Prośba i odpowiedź w Street View

Żądanie zdjęcia Street View to adres URL HTTP w takim formacie:

https://maps.googleapis.com/maps/api/streetview?parameters

Obraz jest określany za pomocą parametrów żądania. Tak jak w przypadku adresów URL, wszystkie parametry są rozdzielone znakiem „&”. Dozwolone parametry i ich możliwe wartości znajdziesz poniżej.

Wymagane parametry

Wykonaj jedną z tych czynności:

• location może być ciągiem tekstowym (takim jak Chagrin Falls, OH) lub wartością szerokości/długości geograficznej (40.457375,-80.009353) i powinien być zakodowany na potrzeby kodowania URL, więc przed podpisem żądania należy przekonwertować adresy takie jak „City Hall, New York, NY”. Interfejs Street View Static API zostanie przyciągnięty do panoramy sfotografowanej najbliżej tej lokalizacji. Jeśli podasz ciąg tekstowy adresu, interfejs API może używać innej lokalizacji aparatu, aby lepiej wyświetlać określoną lokalizację. Jeśli podana jest szerokość lub długość geograficzna, interfejs API wyszukuje promień 50 metrów, aby znaleźć zdjęcie najbliżej tej lokalizacji. Zdjęcia Street View są odświeżane co jakiś czas, a zdjęcia mogą być za każdym razem zrobione z innej pozycji. W związku z tym podczas aktualizowania zdjęć location można je przyciągnąć do innej panoramy.

lub:

• pano to konkretny identyfikator panoramy. Są one na ogół stabilne.

oraz:

• size określa rozmiar wyjściowy obrazu w pikselach. Rozmiar określono za pomocą wartości {width}x{height}, np. size=600x400 zwraca obraz o szerokości 600 pikseli i wysokości 400.
• key umożliwia monitorowanie wykorzystania interfejsu API aplikacji w Google Cloud Console. W razie potrzeby Google może skontaktować się z Tobą w sprawie aplikacji. Więcej informacji znajdziesz w artykule Uzyskiwanie klucza i podpisu.

Parametry opcjonalne

• signature (zalecany) to podpis cyfrowy używany do sprawdzania, czy wszystkie witryny generujące żądania przy użyciu Twojego klucza interfejsu API są do tego autoryzowane. Żądania, które nie zawierają podpisu cyfrowego, mogą się nie powieść. Więcej informacji znajdziesz w artykule Uzyskiwanie klucza i podpisu.

  Uwaga: w przypadku byłych klientów abonamentu Google Maps Platform Premium wymagany jest podpis cyfrowy. Dowiedz się więcej o parametrach uwierzytelniania w przypadku klientów korzystających z abonamentu Premium.

• heading wskazuje położenie kompasu w kamerze. Akceptowane wartości to od 0 do 360 (obie oznaczają północ, 90, wschód, 180 i południe). Jeśli nie określisz kierunku, zostanie obliczona wartość, która skieruje aparat w kierunku wybranego punktu location od momentu zrobienia najbliższego zdjęcia.
• fov (wartość domyślna to 90) określa poziome pole widzenia obrazu. Pole widzenia jest wyrażone w stopniach, z maksymalną wartością 120. W przypadku widoku o stałym rozmiarze, tak jak w przypadku zdjęcia Street View o określonym rozmiarze, pole widzenia istotnie odzwierciedla powiększenie, a mniejsze wartości oznaczają wyższy poziom powiększenia.

  
  
  (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 standardowego ustawienia pojazdu Street View. Często jest to płaskie poziomy poziom. Wartości dodatnie powodują obrót kamery w górę (90 stopnie oznacza pionowy widok w górę), a ujemne w dół (-90 wskazuje prosto w dół).
• radius (wartość domyślna to 50) ustawia promień (w metrach), w którym wyszukiwane są panoramy, wyśrodkowane 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, gdy nie znaleziono obrazu (404 – NIE ZNALEZIONO), czy w odpowiedzi na nieprawidłowe żądanie (400 BAD REQUEST). Prawidłowe wartości to true i false. Jeśli zasada jest ustawiona na true, zamiast ogólnego szarego obrazu zwracany jest komunikat o błędzie. Dzięki temu nie będzie trzeba generować osobnego polecenia, aby sprawdzić dostępność obrazu.
• source (wartość domyślna to default) ogranicza wyszukiwanie Street View do wybranych źródeł. Prawidłowe wartości:
  • default korzysta z domyślnych źródeł w Street View; wyszukiwania nie są ograniczone do określonych źródeł.
  • outdoor ogranicza wyszukiwania do kolekcji na świeżym powietrzu. Wyniki wyszukiwania nie obejmują kolekcji wewnętrznych. Pamiętaj, że w przypadku określonej lokalizacji panoramy zewnętrzne mogą nie być dostępne. Pamiętaj, że wyszukiwanie zwraca tylko panoramy, które można określić zarówno wewnątrz, jak i na zewnątrz. Na przykład zdjęcia sferyczne nie są zwracane, ponieważ nie wiadomo, czy są one 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 lokalizacji, w których zdjęcia Street View są niedostępne, Street Static API zwraca szary obraz ogólny z tekstem „Nie mamy zdjęć” (jak widać na tym przykładzie):

Ilustracja: obraz ogólny wyświetlany, gdy nie są dostępne żadne zdjęcia dla danej lokalizacji.

Pokaż tylko prawidłowe obrazy

Aby uniknąć wyświetlania ogólnego obrazu i upewnić się, że na Twojej stronie są wyświetlane tylko prawidłowe obrazy Street View Static API, wykonaj te czynności:

• Ustaw wartość parametru return_error_code na true. Spowoduje to zwracanie błędu 404 (NIE ZNALEZIONO) zamiast ogólnego szarego zdjęcia, jeśli dla określonej lokalizacji nie jest dostępny żaden obraz.
• Zanim wyślesz prośbę, sprawdź, czy metadane zdjęcia w Street View są dostępne w określonej lokalizacji.