Metadane zdjęć Street View

Wstęp

Dane o panoramach Street View zawierają żądania metadanych Street View Static API. Dzięki metadanym dowiesz się, czy zdjęcie Street View jest dostępne w danym miejscu, a także uzyskasz programowy dostęp do współrzędnych szerokości i długości geograficznej, identyfikatora panoramy, daty wykonania zdjęcia oraz informacji o prawach autorskich do zdjęcia. Dostęp do tych metadanych pozwala dostosować sposób postępowania w przypadku błędów w aplikacji.

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

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

Dostęp do metadanych zdjęć

Żądanie metadanych zdjęcia w Street View ma postać adresu 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 znakami „&”.

Parametry wymagane w żądaniach 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 (40.457375,-80.009353) rozdzielonych przecinkami.

lub:

  • pano – identyfikator wybranej panoramy. Identyfikator nie może być zachowywany w przypadku panoram, ponieważ z czasem mogą się one zmieniać. Zamiast tego zapisz adres lokalizacji lub współrzędne szerokości i długości geograficznej, by móc odświeżyć identyfikator panoramy. Więcej informacji znajdziesz w opisie odświeżania usuniętych identyfikatorów panoram.

a także:

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

Twoje żą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 w ten sposób:

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

Odśwież usunięte identyfikatory panoram

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

  1. Zapisz adres lokalizacji lub współrzędne geograficzne, które zostały użyte do uzyskania identyfikatora panoramy, aby w razie potrzeby można było go odświeżyć.

  2. Po wykryciu zmiany identyfikatora panoramy użyj pierwotnego adresu lokalizacji lub współrzędnych geograficznych, aby wyszukać najbliższe panoramy i uzyskać nowy identyfikator.

Parametry opcjonalne w przypadku żądań metadanych

W żądaniu metadanych możesz uwzględnić te parametry: size, heading, fov i pitch. Te parametry nie mają wpływu na dane o panoramie ani na to, jaką panoramę można znaleźć. Interfejs API umożliwia uwzględnienie tych samych parametrów co żądanie obrazów, aby ułatwić tworzenie żądania metadanych powiązanego z określonym żądaniem obrazów. W przypadku żądań metadanych interfejs API ignoruje 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 pomyślnie wysyłają żądanie metadanych i obrazu 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 obrazów, w których 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

Poniższe URL-e proszą o metadane i zdjęcie panoramy, których nie udało się znaleźć w podanej lokalizacji lub w jej pobliżu.

Żądanie i odpowiedź na metadane

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ź

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 odpowiedzi z metadanymi zawiera informacje o stanie żądania i może zawierać informacje o debugowaniu, które mogą pomóc w rozwiązaniu problemów, które powodują nieprawidłowe działanie żądania 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, a metadane są zwracane.
"ZERO_RESULTS" Wskazuje, że w pobliżu podanej lokalizacji nie udało się znaleźć żadnej panoramy. Ten problem może wystąpić, jeśli podasz nieistniejący lub nieprawidłowy identyfikator panoramy. Zobacz [Odświeżanie identyfikatorów usuniętych panoram](#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 zostanie podany nieistniejący adres.
"OVER_QUERY_LIMIT" Wskazuje, że przekroczono limit dzienny lub limit czasu na sekundę dla tego interfejsu API.
"REQUEST_DENIED" Wskazuje, że prośba została odrzucona. Ten komunikat może się pojawić, jeśli żądanie nie zostało autoryzowane lub gdy 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, 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 często ma charakter przejściowy. Jeśli spróbujesz ponownie, żądanie może się powieść.

Więcej informacji

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