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=

lub w ten sposób:

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

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

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 o panoramie 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 jednak parametry opcjonalne 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 z metadanymi zawiera stan żądania i może zawierać informacje debugowania, które pomogą Ci ustalić, dlaczego żądanie Street View nie działa. 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. To wiadomość 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 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 korzystaniu z interfejsu Street View Static API lub innych interfejsów API Map Google znajdziesz na stronie pomocy Map API.