Wprowadzenie
Żądania metadanych Street View Static API zawierają dane o Street View Wyświetl panoramy. Korzystając z metadanych, możesz sprawdzić, czy zdjęcie Street View dostępnych w danej lokalizacji oraz w automatyczny dostęp do szerokość i długość geograficzną, identyfikator panoramy i datę zrobienia zdjęcia. oraz informacje o prawach autorskich do zdjęcia. Dostęp do tego pozwalają dostosować działanie błędów w aplikacji.
Żądania metadanych interfejsu Street View Static API są dostępne nie ładowania. Gdy wysyłasz żądanie metadanych, nie jest zużywany limit. Limit jest zużywany tylko podczas wczytywania obrazu za pomocą Street View Static API
Przy wysyłaniu żądań o metadane zdjęć Street View z dokładnością 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
Zgodnie ze standardem w adresach URL wszystkie parametry są oddzielane znakiem „&”. (&).
Parametry wymagane w przypadku żądań metadanych
Żądania metadanych akceptują te same parametry adresu URL jak żądania zdjęć Street View Static API, ale tylko wymagane są te parametry:
Wykonaj jedną z tych czynności:
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
) rozdzielonych przecinkami.
Lub:
pano
– 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:
key
isignature
– klucz interfejsu API jest wymagany do uwierzytelnienia użytkownika. w niektórych przypadkach wymagany jest również podpis cyfrowy. jest zawsze zalecana. Więcej informacji: Uzyskaj klucz i podpis.
Żą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=<YOUR_SIGNATURE>
lub podobny:
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
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ć.
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.
Jeśli zauważysz, że identyfikator panoramy się zmienił, użyj oryginalnej lokalizacji. adresu lub szerokości i długości geograficznej, by ponownie wyszukać najbliższą panoramę tego miejsca i uzyskaj nowy identyfikator panoramy.
Opcjonalne parametry żądań metadanych
Żądanie metadanych może zawierać te parametry: size
,
heading
, fov
i pitch
. Te parametry nie mają wpływu na działanie funkcji
dane o danej panoramie lub znaleziona panorama.
Interfejs API umożliwia uwzględnianie tych samych parametrów, co parametr
prośba o obraz
aby ułatwić tworzenie żądań metadanych związanych z konkretnymi zdjęciami
, ale w przypadku żądań metadanych interfejs API ignoruje opcjonalne parametry i
własnymi wartościami. Informacje o korzystaniu z tych parametrów znajdziesz tutaj:
Przewodnik po interfejsie Street View Static API dla programistów.
Format odpowiedzi
Odpowiedzi na metadane są zwracane tylko w formacie JSON.
Przykłady
Przykład 1: znaleziono panoramę
Następujące adresy URL żądają metadanych i obrazu tego samego panoramę.
Żą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
Poniższe adresy URL wymagają metadanych i zdjęcia panoramy, która nie udało się go znaleźć w podanej lokalizacji lub w pobliżu tej lokalizacji.
Żą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 ułatwiają rozwiązywanie problemów
dlaczego prośba do Street View nie działa. Pole status
może zawierać
następujące wartości:
Stan | Opis |
---|---|
"OK" |
Wskazuje, że nie wystąpiły żadne błędy. jeśli zostanie znaleziona panorama, metadane zostaną . |
"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 ciąg adresu podany w polu location
nie udało się znaleźć parametru. Ten komunikat może się pojawić, jeśli adres nie istnieje
. |
"OVER_QUERY_LIMIT" |
Wskazuje, że został przekroczony limit dzienny lub limit na sekundę dla tego interfejsu API. |
"REQUEST_DENIED" |
Oznacza, że prośba została odrzucona. Ten komunikat może się pojawić, jeśli: nie autoryzuje Twojej prośby lub Nie aktywowano statycznego interfejsu Street View API w Projekt w konsoli Google Cloud zawierający Twój klucz interfejsu API. |
"INVALID_REQUEST" |
Ogólnie wskazuje, że parametry zapytania (adres, szerokości i długości geograficznej ani 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
Aby dowiedzieć się więcej o korzystaniu ze statycznego interfejsu API Street View lub innych produktów interfejsu API Map Google, zapoznaj się z interfejsem API Map Google Strona pomocy.