Ta strona została przetłumaczona przez Cloud Translation API.

Metadane zdjęć Street View

Wstęp

Dane o panoramach Street View zawierają żądania metadanych Street View Static API. Korzystając z metadanych, możesz sprawdzić, czy w danym miejscu jest dostępne zdjęcie Street View, a także uzyskać programowy dostęp do współrzędnych geograficznych, identyfikatora panoramy, daty wykonania zdjęcia oraz informacji o prawach autorskich do zdjęcia. Dostęp do tych metadanych pozwala dostosować działanie błędów w aplikacji.

Żądania dotyczące metadanych Street View Static API są dostępne bezpłatnie. Gdy wysyłasz żądanie metadanych, nie jest zużywany limit. Limit jest zużywany tylko podczas wczytywania zdjęcia za pomocą interfejsu Street View Static API.

Po wysłaniu żądań o metadane zdjęć Street View zdjęcia panoram mają dokładność 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

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

Parametry wymagane w przypadku żądań metadanych

Żądania metadanych akceptują te same parametry adresu URL co żądania zdjęć ze Street View static API w interfejsie 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 (40.457375,-80.009353) rozdzielonych przecinkami.

Lub:

pano – identyfikator konkretnej panoramy. Panoramy mogą z czasem zmieniać identyfikator, więc nie zachowuj go. Zamiast tego zapisz adres lokalizacji lub współrzędne szerokości i długości geograficznej, by można było odświeżyć identyfikator panoramy. Szczegółowe informacje znajdziesz w artykule Odświeżanie usuniętych identyfikatorów panoram.

oraz:

key i signature – klucz interfejsu API jest wymagany do uwierzytelnienia żądania. Podpis cyfrowy jest też wymagany w niektórych przypadkach i zawsze zalecany. Więcej informacji znajdziesz w artykule na temat uzyskiwania klucza i podpisu.

Żą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=

lub podobny:

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

Odśwież identyfikatory usuniętych panoram

Jeśli przy próbie pobrania identyfikatora panoramy zobaczysz ZERO_RESULTS lub jej brak, oznacza to, że identyfikator został usunięty i trzeba go odświeżyć.

Zapisz adres lokalizacji lub współrzędne szerokości i długości geograficznej, które posłużyły Ci do uzyskania identyfikatora panoramy. W razie potrzeby możesz odświeżyć widok.
Gdy wykryjesz zmianę identyfikatora panoramy, użyj adresu pierwotnej lokalizacji lub współrzędnych szerokości i długości geograficznej, by ponownie wyszukać najbliższe panoramy w tej lokalizacji i uzyskać nowy identyfikator.

Opcjonalne parametry żądań metadanych

Żądanie metadanych może zawierać te parametry: size, heading, fov i pitch. Pamiętaj, że te parametry nie mają wpływu na dane o panoramie ani na znalezioną panoramę. Interfejs API umożliwia uwzględnianie tych samych parametrów co w żądaniu obrazów, aby ułatwić tworzenie żądania metadanych związanych z konkretnym żądaniem dotyczącym zdjęć, ale w przypadku żądań metadanych interfejs API ignoruje opcjonalne parametry 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ę

Poniższe adresy URL wysyłają żądania o metadane i zdjęcie 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 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

Podane niżej adresy URL wysyłają prośby o metadane i zdjęcie panoramy, której nie można 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 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 pomogą w rozwiązaniu problemu, dla którego żądanie Street View nie działa. Pole status może zawierać te wartości:

Stan	Opis
`"OK"`	Wskazuje, że nie wystąpiły żadne błędy – panorama zostaje znaleziona i zwracane są metadane.
`"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 nie udało się znaleźć ciągu znaków adresu podanego w parametrze `location`. Ten komunikat może się pojawić, jeśli podany zostanie nieistniejący adres.
`"OVER_QUERY_LIMIT"`	Wskazuje, że został przekroczony limit dzienny lub na sekundę dla tego interfejsu API.
`"REQUEST_DENIED"`	Oznacza, że prośba została odrzucona. Ten komunikat może się pojawić, jeśli prośba nie została autoryzowana lub jeśli nie aktywowano statycznego interfejsu Street View API w projekcie konsoli Google Cloud zawierającym klucz interfejsu API.
`"INVALID_REQUEST"`	Ogólnie oznacza, że brakuje parametrów zapytania (adresu, 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ę udać.

Więcej informacji

Więcej informacji o korzystaniu ze statycznego interfejsu Street View Street View lub innych usług interfejsu Google Maps API znajdziesz na stronie pomocy dotyczącej interfejsu API Map Google.