Wstęp
Dane o panoramach Street View zawierają żądania metadanych Street View Static API. Dzięki metadanym dowiesz się, czy zdjęcie Street View jest dostępne w danym miejscu, a także uzyskasz programowy dostęp do współrzędnych szerokości i długości geograficznej, identyfikatora panoramy, daty wykonania zdjęcia oraz informacji o prawach autorskich do zdjęcia. Dostęp do tych metadanych pozwala dostosować sposób postępowania w przypadku błędów w aplikacji.
Żądania metadanych Street View Static API są dostępne bezpłatnie. Gdy przesyłasz żądanie metadanych, nie jest zużywany limit. Limit jest zużywany tylko podczas wczytywania zdjęcia za pomocą interfejsu Street View Static API.
W przypadku przesyłania żądań metadanych zdjęć Street View zdjęcia panoramiczne muszą mieć dokładność 50 metrów.
Dostęp do metadanych zdjęć
Żądanie metadanych zdjęcia w Street View ma postać adresu URL HTTP o takiej postaci:
https://maps.googleapis.com/maps/api/streetview/metadata?parameters
Tak jak w przypadku adresów URL, wszystkie parametry są rozdzielone znakami „&”.
Parametry wymagane w żądaniach metadanych
Żądania metadanych akceptują te same parametry adresu URL co żądania zdjęć 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 wybranej panoramy. Identyfikator nie może być zachowywany w przypadku panoram, ponieważ z czasem mogą się one zmieniać. Zamiast tego zapisz adres lokalizacji lub współrzędne szerokości i długości geograficznej, by móc odświeżyć identyfikator panoramy. Więcej informacji znajdziesz w opisie odświeżania usuniętych identyfikatorów panoram.
a także:
key
isignature
– klucz interfejsu API jest wymagany do uwierzytelnienia żądania. Podpis cyfrowy jest też wymagany w niektórych przypadkach i zawsze jest zalecany. Więcej informacji znajdziesz w artykule o uzyskiwaniu klucza i podpisu.
Twoje żą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 w ten sposób:
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=
Odśwież usunięte identyfikatory panoram
Jeśli przy próbie pobrania identyfikatora panoramy zobaczysz ZERO_RESULTS
lub brak wartości, oznacza to, że został on usunięty i trzeba go odświeżyć.
Zapisz adres lokalizacji lub współrzędne geograficzne, które zostały użyte do uzyskania identyfikatora panoramy, aby w razie potrzeby można było go odświeżyć.
Po wykryciu zmiany identyfikatora panoramy użyj pierwotnego adresu lokalizacji lub współrzędnych geograficznych, aby wyszukać najbliższe panoramy i uzyskać nowy identyfikator.
Parametry opcjonalne w przypadku żądań metadanych
W żądaniu metadanych możesz uwzględnić te parametry: size
, heading
, fov
i pitch
. Te parametry nie mają wpływu
na dane o panoramie ani na to, jaką panoramę można znaleźć.
Interfejs API umożliwia uwzględnienie tych samych parametrów co żądanie obrazów, aby ułatwić tworzenie żądania metadanych powiązanego z określonym żądaniem obrazów. W przypadku żądań metadanych interfejs API ignoruje parametry opcjonalne 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ę
Te adresy URL pomyślnie wysyłają żądanie metadanych i obrazu 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 obrazów, w których powinien znajdować się brakujący obraz.
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
Poniższe URL-e proszą o metadane i zdjęcie panoramy, których nie udało się znaleźć w podanej lokalizacji lub w jej pobliżu.
Żądanie i odpowiedź na metadane
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 dotyczące zdjęć i odpowiedź
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 z metadanymi zawiera informacje o stanie żądania i może zawierać informacje o debugowaniu, które mogą pomóc w rozwiązaniu problemów, które powodują nieprawidłowe działanie żądania Street View. Pole status
może zawierać te wartości:
Stan | Opis |
---|---|
"OK" |
Wskazuje, że nie wystąpiły żadne błędy; panorama została znaleziona, a metadane są zwracane. |
"ZERO_RESULTS" |
Wskazuje, że w pobliżu podanej lokalizacji nie udało się znaleźć żadnej panoramy. Ten problem może wystąpić, jeśli podasz nieistniejący lub nieprawidłowy identyfikator panoramy. Zobacz [Odświeżanie identyfikatorów usuniętych panoram](#refresh-pano). |
"NOT_FOUND" |
Wskazuje, że nie udało się znaleźć ciągu adresu podanego w parametrze location . Ten komunikat może się pojawić, jeśli zostanie podany nieistniejący adres. |
"OVER_QUERY_LIMIT" |
Wskazuje, że przekroczono limit dzienny lub limit czasu na sekundę dla tego interfejsu API. |
"REQUEST_DENIED" |
Wskazuje, że prośba została odrzucona. Ten komunikat może się pojawić, jeśli żądanie nie zostało autoryzowane lub gdy interfejs Street View Static API nie został aktywowany w projekcie konsoli Google Cloud zawierającym Twój klucz interfejsu API. |
"INVALID_REQUEST" |
Ogólnie oznacza, że brakuje parametrów zapytania (adresu, współrzędnych 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 często ma charakter przejściowy. Jeśli spróbujesz ponownie, żądanie może się powieść. |
Więcej informacji
Więcej informacji o korzystaniu ze Street View Static API lub innych usługach interfejsu API Map Google znajdziesz na stronie pomocy interfejsu API Map Google.