Metadane zdjęć Street View

Wprowadzenie

Żądania metadanych interfejsu Street View Static API dostarczają danych o panoramach Street View. Dzięki metadanym możesz sprawdzić, czy w danej lokalizacji 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 pozwala dostosować zachowanie aplikacji w przypadku wystąpienia błędu.

Żądania metadanych interfejsu Street View Static API są bezpłatne. Gdy wysyłasz żądanie metadanych, nie jest wykorzystywany żaden limit. Limit jest wykorzystywany tylko wtedy, gdy wczytujesz obraz za pomocą interfejsu Street View Static API.

W przypadku żądań metadanych 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 tej postaci:

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

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

Parametry wymagane w przypadku żądań metadanych

Żądania metadanych akceptują te same parametry adresu URL co żądania zdjęć interfejsu 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 rozdzielona przecinkami para współrzędnych geograficznych (40.457375,-80.009353).

Lub:

• pano – konkretny identyfikator panoramy. Identyfikatory panoram mogą się z czasem zmieniać, więc nie zapisuj tego identyfikatora. Zamiast tego zapisz adres lokalizacji lub współrzędne geograficzne, aby móc odświeżyć identyfikator panoramy. Więcej informacji znajdziesz w artykule Odświeżanie usuniętych identyfikatorów panoram.

Oprócz tego:

• key i signature – do uwierzytelnienia żądania wymagany jest klucz interfejsu API. W niektórych przypadkach wymagany jest też podpis cyfrowy, ale zawsze zalecamy jego używanie. 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 tak:

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 brak wartości, oznacza to, że identyfikator panoramy został usunięty i trzeba go odświeżyć.

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

2. Gdy wykryjesz, że identyfikator panoramy się zmienił, 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 wpływają na dane o panoramie ani na to, która panorama zostanie znaleziona. Interfejs API umożliwia uwzględnienie tych samych parametrów co w żądaniu zdjęć , aby ułatwić tworzenie żądania metadanych powiązanego z konkretnym żądaniem zdjęć . W przypadku żądań metadanych interfejs API ignoruje jednak parametry opcjonalne i ich wartości. Więcej informacji o korzystaniu z tych parametrów znajdziesz w przewodniku dla deweloperów interfejsu Street View Static API.

Format odpowiedzi

Odpowiedzi z metadanymi są zwracane tylko w formacie JSON.

Przykłady

Przykład 1. Znaleziono panoramę

Te adresy URL powodują wysłanie żądania metadanych i obrazu tej samej panoramy.

Żądanie i odpowiedź z metadanymi

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ź ze zdjęciem, 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 powodują wysłanie żądania metadanych i obrazu panoramy, której nie udało się znaleźć w określonej lokalizacji ani w jej pobliżu.

Żądanie i odpowiedź z metadanymi

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ź ze zdjęciem

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 z metadanymi zawiera stan żądania i może zawierać informacje na potrzeby 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 produktów interfejsu API Map Google znajdziesz na stronie pomocy interfejsu API Map Google Support page.