Metadane zdjęć Street View

Wprowadzenie

Żądania metadanych interfejsu Street View Static API dostarczają danych o panoramach Street View. Korzystając z metadanych, 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 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.

W przypadku przesył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 ampersand (&).

Wymagane parametry żądań metadanych

Żądania metadanych akceptują 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 – konkretny identyfikator 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 – klucz interfejsu API jest wymagany do uwierzytelnienia żądania. W niektórych przypadkach wymagany jest też podpis cyfrowy, ale zawsze jest on 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 należy 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, że identyfikator panoramy uległ zmianie, użyj pierwotnej lokalizacji, adresu lub współrzędnych geograficznych, aby ponownie wyszukać najbliższe panoramy w tej lokalizacji i uzyskać nowy identyfikator panoramy.

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 dotyczące 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 dotyczącym interfejsu Street View Static API.

Format odpowiedzi

Odpowiedzi dotyczące metadanych są zwracane tylko w formacie JSON.

Przykłady

Przykład 1. Znaleziono panoramę

Poniższe adresy URL skutecznie wysyłają prośby o metadane i obraz tej samej panoramy.

Żądanie metadanych i odpowiedź na nie

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 obrazu i odpowiedź, w której 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ą żądanie 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 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 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 usług interfejsu API Map Google znajdziesz na stronie pomocy interfejsu API Map.