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 dostępne jest 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 wysyłasz żądanie metadanych, 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 „&”.

Parametry wymagane 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 użyte 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 brakuje 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

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 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 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.