Metadane zdjęć Street View

Wprowadzenie

Żądania metadanych Street View Static API zawierają dane o panoramach Street View. Dzięki metadanym możesz sprawdzić, czy w danej lokalizacji dostępne jest zdjęcie Street View. Możesz też uzyskać dostęp do współrzędnych geograficznych, identyfikatora panoramy, daty wykonania zdjęcia oraz informacji o prawach autorskich do tego zdjęcia. Dostęp do tych metadanych umożliwia dostosowywanie sposobu obsługi błędów w aplikacji.

Żądania metadanych Street View Static API są dostępne bezpłatnie. Gdy żądasz metadanych, nie zużywasz limitu. Limit jest wykorzystywany tylko wtedy, gdy wczytujesz obraz za pomocą interfejsu Street View Static API.

W przypadku żądań metadanych zdjęć Street View dokładność panoramy wynosi 50 metrów.

Dostęp do metadanych obrazów

Żądanie metadanych obrazu Street View to adres URL HTTP o tym formacie:

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

Zgodnie ze standardem w adresach URL wszystkie parametry są rozdzielane znakiem „&”.

Wymagane parametry w przypadku żądań metadanych

Żądania dotyczące metadanych przyjmują te same parametry adresu URL co żądania obrazów w ramach interfejsu Street View Static API, ale wymagane są tylko te parametry:

Wykonaj jedną z tych czynności:

  • location – może to być ciąg tekstowy (np. Chagrin Falls, OH) lub para współrzędnych szerokości i długości geograficznej rozdzielona przecinkami (40.457375,-80.009353).

Lub:

  • pano – identyfikator konkretnej panoramy. Identyfikatory panoram mogą się zmienić w czasie, dlatego nie zapisuj tego identyfikatora. Zamiast tego zapisz adres lokalizacji lub współrzędne szerokości i długości geograficznej, aby móc odświeżyć identyfikator panoramy. Więcej informacji znajdziesz w artykule Odświeżanie usuniętego identyfikatora panoramy.

A także:

  • key i signature – klucz interfejsu API jest wymagany do uwierzytelnienia żądania. W niektórych przypadkach podpis cyfrowy jest wymagany, a zawsze zalecany. Więcej informacji znajdziesz w artykule Uzyskiwanie klucza i podpisu.

Twoje żądanie metadanych z wymaganymi parametrami wygląda tak:

https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

lub w ten sposób:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

Odświeżanie usuniętych identyfikatorów panoram

Jeśli podczas próby pobrania identyfikatora panoramy otrzymasz wartość ZERO_RESULTS lub no, oznacza to, że identyfikator panoramy został usunięty i należy go odświeżyć.

  1. Zapisz adres lokalizacji lub współrzędne szerokości i długości geograficznej, których użyłeś/użyłaś do uzyskania identyfikatora panoramy, aby w razie potrzeby móc je odświeżyć.

  2. Gdy wykryjesz, że identyfikator panoramy się zmienił, użyj pierwotnego adresu lub współrzędnych geograficznych, aby ponownie wyszukać najbliższe panoramy w danej lokalizacji i uzyskać nowy identyfikator panoramy.

Opcjonalne parametry żądań metadanych

W żądaniu metadanych możesz podać te parametry: size, heading, fov i pitch. Pamiętaj, że te parametry nie wpływają na dane dotyczące panoramy ani na to, która panorama zostanie znaleziona. Interfejs API umożliwia uwzględnianie tych samych parametrów co żądanie dotyczące obrazów, aby ułatwić tworzenie żądania metadanych powiązanego z konkretnym żądaniem dotyczącym obrazów. W przypadku żądań metadanych interfejs API ignoruje opcjonalne parametry i ich wartości. Informacje o używaniu tych parametrów znajdziesz w przewodniku dla deweloperów interfejsu Street View Static API.

Format odpowiedzi

Odpowiedzi dotyczące metadanych 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 i odpowiedź dotycząca metadanych

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 obrazu, w których brakuje 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
Wieża Eiffla

Przykład 2. Nie znaleziono panoramy

Te adresy URL wysyłają żądanie metadanych i obrazu panoramy, której nie udało się znaleźć w określonej lokalizacji lub w jej pobliżu.

Żądanie i odpowiedź metadanych

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ąca obrazów

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
Obiekt zastępczy „Brak obrazu”

Kody stanu

Pole status w obiekcie odpowiedzi metadanych zawiera stan żądania i może zawierać informacje debugowania, które pomogą Ci rozwiązać problem z żądaniem Street View. Pole status może zawierać te wartości:

Stan Opis
"OK" Oznacza, że nie wystąpiły żadne błędy. Znaleziono panoramę i zwrócono metadane.
"ZERO_RESULTS" Wskazuje, że w pobliżu podanej lokalizacji nie znaleziono żadnej panoramy. Ta odpowiedź może się pojawić, jeśli podasz nieistniejący lub nieprawidłowy identyfikator panoramy. Zobacz [Odświeżanie usuniętego identyfikatora panoramy](#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 podana została nieistniejąca lokalizacja.
"OVER_QUERY_LIMIT" Wskazuje, że przekroczono dzienny lub na sekundę limit interfejsu API.
"REQUEST_DENIED" Oznacza, że prośba została odrzucona. Ten komunikat może się pojawić, jeśli nie autoryzujesz żądania lub jeśli interfejs Street View Static API nie jest aktywowany w projekcie konsoli Google Cloud zawierającym Twój klucz interfejsu API.
"INVALID_REQUEST" Zwykle oznacza to, ż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 jest często tymczasowy. Jeśli spróbujesz ponownie, żądanie może się powieść.

Więcej informacji

Więcej informacji o używaniu interfejsu Street View Static API lub innych interfejsów API Map Google znajdziesz na stronie pomocy Map API.