Metadane zdjęć Street View

Wprowadzenie

Żądania metadanych Street View Static API dostarczają danych o panoramach Street View. Dzięki metadanym dowiesz się, czy zdjęcie Street View jest dostępne w danym miejscu, a także uzyskasz programowy dostęp do szerokości i długości geograficznej, identyfikatora panoramy, daty zrobienia zdjęcia i informacji o prawach autorskich do zdjęcia. Dostęp do tych metadanych pozwala dostosować sposób działania błędów w aplikacji.

Żądania metadanych do interfejsu Street View Static API są dostępne bezpłatnie. Przesłanie prośby o metadane nie powoduje zużywania limitu. Limit jest wykorzystywany tylko wtedy, gdy wczytujesz zdjęcie za pomocą interfejsu Street View Static API.

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

Dostęp do metadanych zdjęć

Żądanie metadanych zdjęcia w Street View to adres 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 znakiem „&”.

Parametry wymagane w przypadku żądań 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 rozdzielonej przecinkami (40.457375,-80.009353).

lub:

  • pano – identyfikator konkretnej panoramy. Zwykle są one stabilne, chociaż identyfikator panoramy może się zmieniać wraz z odświeżaniem zdjęć.

a także:

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

Żądanie metadanych, które będzie zawierać 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 żądań metadanych

W żądaniu metadanych możesz umieścić te parametry: size, heading, fov i pitch. Pamiętaj, że te parametry nie mają wpływu na dane panoramy ani to, na jaką panoramę zostanie znaleziona. Interfejs API umożliwia uwzględnienie tych samych parametrów co żądanie obrazów, co ułatwia tworzenie żądania metadanych związanych z określonym żądaniem zdjęć. Jednak w przypadku żądań metadanych interfejs API ignoruje opcjonalne parametry i ich wartości. Więcej informacji 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ę

Następujący URL udało się przesłać żądanie metadanych i zdjęcia 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 dotyczące zdjęć i odpowiedź na nie, tam, gdzie 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
Wieża Eiffla

Przykład 2: nie znaleziono panoramy

Te adresy URL umożliwiają żądanie metadanych i zdjęcia do panoramy, której nie udało się znaleźć w 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"
}

Żądanie dotyczące zdjęć i odpowiedź na nie

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
Symbol zastępczy braku zdjęć

Kody stanu

Pole status w obiekcie metadanych odpowiedzi zawiera informacje o stanie żądania i może zawierać informacje na potrzeby debugowania, które pomogą Ci rozwiązać problem z niedziałającym żądaniem 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 i metadane są zwracane.
"ZERO_RESULTS" Wskazuje, że nie udało się znaleźć panoramy w podanej lokalizacji. Może się tak zdarzyć w przypadku podania nieistniejącego lub nieprawidłowego identyfikatora panoramy.
"NOT_FOUND" Wskazuje, że nie udało się znaleźć ciągu adresu podanego w parametrze location. Może się tak zdarzyć w przypadku podania nieistniejącego adresu.
"OVER_QUERY_LIMIT" Wskazuje, że przekroczono dzienny limit lub limit na sekundę dla tego interfejsu API.
"REQUEST_DENIED" Wskazuje, że żądanie zostało odrzucone. Może się tak zdarzyć, jeśli nie autoryzujesz żądania lub jeśli 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, długości geograficznej lub składników).
"UNKNOWN_ERROR" Wskazuje, że nie udało się przetworzyć żądania z powodu błędu serwera. Zwykle jest to stan tymczasowy. Jeśli spróbujesz ponownie, prośba może zostać zrealizowana.

Więcej informacji

Więcej informacji o używaniu interfejsu Street View Static API lub innych usług interfejsu API Map Google znajdziesz na stronie pomocy interfejsu API Map Google.