Metadane zdjęć Street View

Wprowadzenie

Żądania metadanych interfejsu Street View Static API dostarczają danych o panoramach Street View. Na podstawie 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 i informacji o prawach autorskich do obrazu. Dostęp do tych metadanych umożliwia dostosowywanie zachowania aplikacji w przypadku błędów.

Żądania metadanych interfejsu Street View Static API są dostępne bezpłatnie. Gdy prosisz o metadane, nie wykorzystujesz limitu. Limit jest wykorzystywany tylko wtedy, gdy wczytujesz obraz za pomocą interfejsu Street View Static API.

Podczas wysyłania próśb o metadane zdjęć Street View dokładność zdjęć panoramicznych wynosi 50 metrów.

Dostęp do metadanych zdjęć

Żądanie metadanych obrazu Street View to adres URL HTTP w tym formacie:

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

Zgodnie ze standardem adresów URL wszystkie parametry są rozdzielone znakiem „&”.

Wymagane parametry w przypadku żądań metadanych

Żądania metadanych przyjmują te same parametry adresu URL co żądania obrazów z interfejsu 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 rozdzielonych przecinkiem (40.457375,-80.009353).

Lub:

• pano – identyfikator konkretnej panoramy. Panoramy mogą z czasem zmieniać identyfikatory, więc nie zapisuj tego identyfikatora. 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.

Oprócz tego:

• key i signature – do uwierzytelnienia żądania wymagany jest klucz interfejsu API. Podpis cyfrowy jest też wymagany w niektórych przypadkach i 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 podczas próby pobrania identyfikatora panoramy otrzymasz wartość ZERO_RESULTS lub brak wartości, oznacza to, że identyfikator panoramy został usunięty i musisz go odświeżyć.

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

2. Gdy wykryjesz zmianę identyfikatora panoramy, użyj pierwotnego adresu lokalizacji lub współrzędnych geograficznych, aby ponownie wyszukać najbliższe panoramy w tej lokalizacji i uzyskać nowy identyfikator panoramy.

Parametry opcjonalne w przypadku żą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 panoramy ani na to, która panorama zostanie znaleziona. Interfejs API umożliwia uwzględnienie tych samych parametrów co żądanie obrazów, aby ułatwić tworzenie żądania metadanych związanego z konkretnym żądaniem obrazów. W przypadku żądań metadanych interfejs API ignoruje jednak 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 metadanych są zwracane tylko w formacie JSON.

Przykłady

Przykład 1. Znaleziono panoramę

Poniższe adresy URL pomyślnie wysyłają prośby o metadane i obraz 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

Poniższe adresy URL wysyłają prośbę o metadane i obraz 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 obrazów

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 do debugowania, które pomogą Ci rozwiązać problem z działaniem żądania Street View. Pole status może zawierać te wartości:

Więcej informacji

Więcej informacji o korzystaniu z interfejsu Street View Static API lub innych usług Google Maps API znajdziesz na stronie pomocy dotyczącej interfejsów API Map.