Metadane zdjęć Street View

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Wprowadzenie

Żądania metadanych interfejsu statycznego Street View dostarczają danych o panoramach Street View. Dzięki metadanych możesz dowiedzieć się, czy zdjęcie Street View jest dostępne w danej lokalizacji, a także uzyskać dostęp do szerokości i długości geograficznej, identyfikator panoramicznego, datę zrobienia zdjęcia i informacje o prawach autorskich do zdjęcia. Dostęp do tych metadanych pozwala dostosować zachowanie błędów w aplikacji.

Żądania metadanych interfejsu statycznego Street View są dostępne bezpłatnie. Gdy poprosisz o metadane, nie zostanie wykorzystany żaden limit. Limit jest zużywanytylko podczas wczytywania obrazu za pomocą Street View Static API.

W przypadku próśb o metadane zdjęć Street View zdjęcia panoramiczne mają dokładnie 50 metrów.

Dostęp do metadanych zdjęć

Żądanie metadanych zdjęcia Street View to adres URL HTTP o następującej postaci:

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

Standardowo w adresach URL wszystkie parametry są rozdzielone znakiem „&”.

Parametry wymagane w przypadku żądań metadanych

Żądania metadanych akceptują te same parametry URL co żądania zdjęć 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 rozdzielonych przecinkami współrzędnych geograficznych (40.457375,-80.009353).

lub:

  • pano – konkretny identyfikator panoramicznej. Są one zwykle stabilne, ale widoki mogą się zmieniać w miarę odświeżania zdjęć.

Oprócz tego:

  • key i signature – klucz interfejsu API jest wymagany do uwierzytelnienia żądania. Podpis cyfrowy jest wymagany również w niektórych przypadkach i zawsze jest zalecany. Aby dowiedzieć się więcej, zobacz Pobieranie klucza i podpisu.

Żądanie metadanych, zawierające tylko wymagane parametry, będzie wyglądać tak:

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

lub tak:

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

Opcjonalne parametry na potrzeby żądań metadanych

W żądaniu metadanych możesz uwzględnić te parametry: size, heading, fov i pitch. Pamiętaj, że te parametry nie wpływają na dane dotyczące panoramicznych zdjęć ani na to, która panorama się została znaleziona. Interfejs API umożliwia uwzględnianie tych samych parametrów co w żądaniu dotyczącym obrazów, aby ułatwić utworzenie żądania metadanych dotyczącego określonego żądania zdjęcia, ale w przypadku żądań metadanych ignoruje te 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 żądają metadanych i obrazu tej samej panoramicznej strony.

Żą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"
}

Prośba o obraz i odpowiedź, w przypadku których brakuje oczekiwanych obrazów.

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 panoram

Te adresy URL żądają metadanych i obrazu panoramicznego, którego nie udało się znaleźć w pobliżu 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"
}

Prośba o zdjęcia 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
Brak obrazu zastępczego

Kody stanu

Pole status w obiekcie odpowiedzi na metadane zawiera stan żądania i może zawierać informacje ułatwiające debugowanie, dzięki którym łatwiej będzie Ci rozwiązać problem Street View. Pole status może zawierać te wartości:

Stan Opis
"OK" Wskazuje, że nie wystąpiły żadne błędy; została znaleziona panorama i zwrócono metadane.
"ZERO_RESULTS" Oznacza, że w pobliżu podanej lokalizacji nie można znaleźć żadnej panorama. Może się tak zdarzyć, jeśli podany jest nieistniejący lub nieprawidłowy identyfikator panorama.
"NOT_FOUND" Wskazuje, że nie można znaleźć ciągu adresu podanego w parametrze location. Może się tak zdarzyć, jeśli podany jest nieistniejący adres.
"OVER_QUERY_LIMIT" Przekroczono limit dzienny lub limit na sekundę dla tego interfejsu API.
"REQUEST_DENIED" Wskazuje, że Twoja prośba została odrzucona. Może się tak zdarzyć, jeśli prośba nie została przez Ciebie autoryzowana lub jeśli w projekcie Google Cloud Console zawierającym Twój klucz interfejsu API nie aktywowano interfejsu Street View Static API.
"INVALID_REQUEST" Ogólnie rzecz biorąc, brakuje parametrów zapytania (adres, długość lub składniki).
"UNKNOWN_ERROR" Wskazuje, że nie udało się przetworzyć żądania z powodu błędu serwera. Jest to często stan tymczasowy. Żądanie może się udać, jeśli spróbujesz ponownie.

Więcej informacji

Więcej informacji o korzystaniu ze Street View Static API i innych usługach Google Maps API znajdziesz na stronie pomocy interfejsu Maps API.