Wstęp
Dane o panoramach Street View zawierają żądania metadanych Street View Static API. Korzystając z metadanych, możesz sprawdzić, czy w danym miejscu jest dostępne zdjęcie Street View, a także uzyskać programowy dostęp do współrzędnych geograficznych, identyfikatora panoramy, daty wykonania zdjęcia oraz informacji o prawach autorskich do zdjęcia. Dostęp do tych metadanych pozwala dostosować działanie błędów w aplikacji.
Żądania dotyczące metadanych Street View Static API są dostępne bezpłatnie. Gdy wysyłasz żądanie metadanych, nie jest zużywany limit. Limit jest zużywany tylko podczas wczytywania zdjęcia za pomocą interfejsu Street View Static API.
Po wysłaniu żądań o metadane zdjęć Street View zdjęcia panoram mają dokładność do 50 metrów.
Dostęp do metadanych zdjęć
Żądanie metadanych zdjęcia Street View to URL HTTP w tym formacie:
https://maps.googleapis.com/maps/api/streetview/metadata?parameters
Standardowo w adresach URL wszystkie parametry są oddzielane znakiem „&”.
Parametry wymagane w przypadku żądań metadanych
Żądania metadanych akceptują te same parametry adresu URL co żądania zdjęć ze Street View static API w interfejsie Street View Static API, ale wymagane są tylko te parametry:
Wykonaj jedną z tych czynności:
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
) rozdzielonych przecinkami.
Lub:
pano
– identyfikator konkretnej panoramy. Panoramy mogą z czasem zmieniać identyfikator, 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:
key
isignature
– klucz interfejsu API jest wymagany do uwierzytelnienia żądania. Podpis cyfrowy jest też wymagany w niektórych przypadkach i zawsze zalecany. Więcej informacji znajdziesz w artykule na temat uzyskiwania klucza i podpisu.
Żądanie metadanych, które zawiera tylko wymagane parametry, wygląda tak:
https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=
lub podobny:
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=
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.
Opcjonalne parametry żądań metadanych
Żądanie metadanych może zawierać te parametry: size
, heading
, fov
i pitch
. Pamiętaj, że te parametry nie mają wpływu na dane o panoramie ani na znalezioną panoramę.
Interfejs API umożliwia uwzględnianie tych samych parametrów co w żądaniu obrazów, aby ułatwić tworzenie żądania metadanych związanych z konkretnym żądaniem dotyczącym zdjęć, ale w przypadku żądań metadanych interfejs API ignoruje opcjonalne parametry i ich wartości. Informacje o korzystaniu z tych parametrów znajdziesz w przewodniku dla programistów Street View Static API.
Format odpowiedzi
Odpowiedzi na metadane są zwracane tylko w formacie JSON.
Przykłady
Przykład 1: znaleziono panoramę
Poniższe adresy URL wysyłają żądania o metadane i zdjęcie tej samej panoramy.
Żądanie metadanych i odpowiedź
https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{ "copyright" : "© 2017 Google", "date" : "2016-05", "location" : { "lat" : 48.85783227207914, "lng" : 2.295226175151347 }, "pano_id" : "tu510ie_z4ptBZYo2BGEJg", "status" : "OK" }
Żądanie i odpowiedź dotyczące zdjęcia, w przypadku którego powinien brakować obrazu.
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Przykład 2: nie znaleziono panoramy
Podane niżej adresy URL wysyłają prośby o metadane i zdjęcie panoramy, której nie można znaleźć w określonej lokalizacji lub w jej pobliżu.
Żądanie metadanych i odpowiedź
https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{ "status" : "ZERO_RESULTS" }
Żądanie i odpowiedź dotyczące zdjęć
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Kody stanu
Pole status
w obiekcie odpowiedzi metadanych zawiera stan żądania i może zawierać informacje na potrzeby debugowania, które pomogą w rozwiązaniu problemu, dla którego żądanie Street View nie działa. Pole status
może zawierać te wartości:
Stan | Opis |
---|---|
"OK" |
Wskazuje, że nie wystąpiły żadne błędy – panorama zostaje znaleziona i zwracane są metadane. |
"ZERO_RESULTS" |
Wskazuje, że w pobliżu podanej lokalizacji nie można znaleźć panoramy. Taka odpowiedź może wystąpić, jeśli podasz nieistniejący lub nieprawidłowy identyfikator panoramy. Przeczytaj sekcję [Odświeżanie usuniętych identyfikatorów panoram](#refresh-pano). |
"NOT_FOUND" |
Wskazuje, że nie udało się znaleźć ciągu znaków adresu podanego w parametrze location . Ten komunikat może się pojawić, jeśli podany zostanie nieistniejący adres. |
"OVER_QUERY_LIMIT" |
Wskazuje, że został przekroczony limit dzienny lub na sekundę dla tego interfejsu API. |
"REQUEST_DENIED" |
Oznacza, że prośba została odrzucona. Ten komunikat może się pojawić, jeśli prośba nie została autoryzowana lub jeśli nie aktywowano statycznego interfejsu Street View API w projekcie konsoli Google Cloud zawierającym klucz interfejsu API. |
"INVALID_REQUEST" |
Ogólnie oznacza, że brakuje parametrów zapytania (adresu, szerokości i długości geograficznej lub komponentów). |
"UNKNOWN_ERROR" |
Wskazuje, że nie udało się przetworzyć żądania z powodu błędu serwera. Ten problem jest często tymczasowy. Jeśli spróbujesz ponownie, żądanie może się udać. |
Więcej informacji
Więcej informacji o korzystaniu ze statycznego interfejsu Street View Street View lub innych usług interfejsu Google Maps API znajdziesz na stronie pomocy dotyczącej interfejsu API Map Google.