Metadane zdjęć Street View

Wprowadzenie

Żądania metadanych Street View Static API dostarczają danych o panoramach Street View. Dzięki metadanym możesz sprawdzić, czy zdjęcie Street View jest dostępne w danym miejscu, a także uzyskać automatyczny dostęp do współrzędnych 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 umożliwia dostosowanie zachowania aplikacji w przypadku błędu.

Uwaga: wartość pola daty może się różnić:

• Pole daty może mieć różną szczegółowość w przypadku różnych panoram. Na przykład pole daty w przypadku niektórych panoram zawiera rok i miesiąc, a w przypadku innych tylko rok.
• Jeśli nie ma dostępnych danych, pole daty jest pomijane.

Żądania metadanych Street View Static API są dostępne bezpłatnie. Żądanie metadanych nie powoduje wykorzystania limitu. Limit jest wykorzystywany tylko wtedy, gdy wczytujesz obraz za pomocą interfejsu Street View Static API.

W przypadku żądań metadanych zdjęć Street View zdjęcia panoramiczne są dokładne do 50 metrów.

Dostęp do metadanych zdjęć

Żądanie metadanych zdjęć Street View to adres URL HTTP w następującym formacie:

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

Uwaga: w przypadku żądań metadanych wymagany jest protokół https://.

Zgodnie ze standardem adresów URL wszystkie parametry są oddzielone znakiem ampersand (&).

Wymagane parametry żą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 to być ciąg tekstowy (np. Chagrin Falls, OH) lub para współrzędnych szerokości i długości geograficznej rozdzielonych przecinkiem (40.457375,-80.009353).

Lub:

• pano – identyfikator konkretnej panoramy. Identyfikatory panoram mogą się zmieniać, więc nie zapisuj ich na stałe. 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 sekcji Odświeżanie usuniętych identyfikatorów panoram.

oraz:

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

Żądanie metadanych zawierające tylko wymagane parametry wygląda tak:

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

lub w ten sposób:

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

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

Jeśli spróbujesz pobrać identyfikator panoramy i otrzymasz wartość ZERO_RESULTS lub nie otrzymasz żadnej wartości, oznacza to, że identyfikator panoramy został usunięty i należy go odświeżyć.

1. Zapisz adres lokalizacji lub współrzędne geograficzne, których użyto do uzyskania identyfikatora panoramy, aby móc go odświeżyć w razie potrzeby.

2. Jeśli wykryjesz, że identyfikator panoramy uległ zmianie, użyj pierwotnego adresu lokalizacji lub współrzędnych geograficznych, aby ponownie wyszukać najbliższe panoramy dla tej lokalizacji i uzyskać nowy identyfikator panoramy.

Uwaga: zdjęcia Street View są okresowo odświeżane i za każdym razem mogą być robione z nieco innych pozycji, dlatego dany identyfikator panoramy może zostać przypisany do innej panoramy, gdy zdjęcia lub identyfikator panoramy zostaną zaktualizowane.

Opcjonalne parametry żądań metadanych

W żądaniu metadanych możesz uwzględnić te parametry: size, heading, fov i pitch. Pamiętaj, że te parametry nie mają wpływu na dane o panoramie ani na to, która panorama zostanie znaleziona. Interfejs API umożliwia uwzględnienie tych samych parametrów co żądanie zdjęć, aby ułatwić tworzenie żądania metadanych powiązanego z konkretnym żądaniem zdjęć. Jednak w przypadku żądań metadanych interfejs API ignoruje parametry opcjonalne i ich wartości. Informacje o korzystaniu z tych parametrów znajdziesz w przewodniku dla deweloperów 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 wysyłają żądania metadanych i obrazu tej samej panoramy.

Żądanie i odpowiedź dotyczące 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 zdjęć, w których oczekiwany jest 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

Przykład 2. Nie znaleziono panoramy

Te adresy URL żądają metadanych i obrazu panoramy, której nie udało się znaleźć w określonej lokalizacji ani w jej pobliżu.

Żądanie i odpowiedź dotyczące 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ą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ą Ci rozwiązać problem z żądaniem Street View. Pole status może zawierać te wartości:

Stan	Opis
"OK"	Wskazuje, że nie wystąpiły żadne błędy. Znaleziono panoramę i zwrócono metadane.
"ZERO_RESULTS"	Wskazuje, że nie udało się znaleźć panoramy w pobliżu podanej lokalizacji. Taka odpowiedź może wystąpić, jeśli podasz nieistniejący lub nieprawidłowy identyfikator panoramy. Zobacz [Odświeżanie usuniętych identyfikatorów 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 podany adres nie istnieje.
"OVER_QUERY_LIMIT"	Wskazuje, że przekroczono dzienny limit lub limit na sekundę dla tego interfejsu API.
"REQUEST_DENIED"	Oznacza, że prośba została odrzucona. Ten komunikat 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 interfejsu API.
"INVALID_REQUEST"	Zwykle 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 jest zwykle 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 i innych interfejsów API Map Google znajdziesz na stronie pomocy interfejsu API Map Google.