Metadane zdjęć Street View

Wprowadzenie

Żądania metadanych Street View Static API zawierają dane o Street View Wyświetl panoramy. Korzystając z metadanych, możesz sprawdzić, czy zdjęcie Street View dostępnych w danej lokalizacji oraz w automatyczny dostęp do szerokość i długość geograficzną, identyfikator panoramy i datę zrobienia zdjęcia. oraz informacje o prawach autorskich do zdjęcia. Dostęp do tego pozwalają dostosować działanie błędów w aplikacji.

Żądania metadanych interfejsu Street View Static API są dostępne nie ładowania. Gdy wysyłasz żądanie metadanych, nie jest zużywany limit. Limit jest zużywany tylko podczas wczytywania obrazu za pomocą Street View Static API

Przy wysyłaniu żądań o metadane zdjęć Street View z dokładnością do 50 metrów.

Dostęp do metadanych zdjęć

Żądanie metadanych zdjęcia Street View to URL HTTP w tym formacie:

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

Zgodnie ze standardem w adresach URL wszystkie parametry są oddzielane znakiem „&”. (&).

Parametry wymagane w przypadku żądań metadanych

Żądania metadanych akceptują te same parametry adresu URL jak żądania zdjęć Street View Static API, ale tylko wymagane są te parametry:

Wykonaj jedną z tych czynności:

  • location – może być ciągiem tekstowym (np. Chagrin Falls, OH) lub pary współrzędnych szerokości i długości geograficznej (40.457375,-80.009353) rozdzielonych przecinkami.

Lub:

  • pano – identyfikator konkretnej panoramy. Panoramy mogą z czasem zmieniać identyfikator, dlatego nie zachowuj tego identyfikatora. Zamiast tego zapisz adres lokalizacji lub długości i szerokości geograficznej, by umożliwić odświeżenie identyfikatora panoramy. Dla: Więcej informacji znajdziesz w artykule Odświeżanie usuniętych identyfikatorów panoram.

oraz:

  • key i signature – klucz interfejsu API jest wymagany do uwierzytelnienia użytkownika. w niektórych przypadkach wymagany jest również podpis cyfrowy. jest zawsze zalecana. Więcej informacji: Uzyskaj klucz i podpis.

Żądanie metadanych, które zawiera tylko wymagane parametry, wygląda tak:

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

lub podobny:

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

Odśwież identyfikatory usuniętych panoram

Jeśli spróbujesz pobrać identyfikator panoramy i pojawi się ZERO_RESULTS lub brak wartości, identyfikator panoramy został usunięty i trzeba go odświeżyć.

  1. Zapisz adres lokalizacji lub współrzędne szerokości i długości geograficznej użyte wcześniej pobierz identyfikator panoramy, by w razie potrzeby odświeżyć widok.

  2. Jeśli zauważysz, że identyfikator panoramy się zmienił, użyj oryginalnej lokalizacji. adresu lub współrzędnych geograficznych, aby znaleźć najbliższą panoramę tego miejsca i uzyskaj nowy identyfikator panoramy.

Opcjonalne parametry żądań metadanych

Żądanie metadanych może zawierać te parametry: size, heading, fov i pitch. Te parametry nie mają wpływu na działanie funkcji dane o danej panoramie lub znaleziona panorama. Interfejs API umożliwia uwzględnianie tych samych parametrów, co parametr prośba o obraz aby ułatwić tworzenie żądań metadanych związanych z konkretnymi zdjęciami , ale w przypadku żądań metadanych interfejs API ignoruje opcjonalne parametry i własnymi wartościami. Informacje o korzystaniu z tych parametrów znajdziesz tutaj: Przewodnik po interfejsie Street View Static API dla programistów.

Format odpowiedzi

Odpowiedzi na metadane są zwracane tylko w formacie JSON.

Przykłady

Przykład 1: znaleziono panoramę

Następujące adresy URL żądają metadanych i obrazu tego samego panoramę.

Żądanie metadanych i odpowiedź

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ęcia, w przypadku którego powinien brakować 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
Wieża Eiffla

Przykład 2: nie znaleziono panoramy

Poniższe adresy URL wymagają metadanych i zdjęcia panoramy, która nie udało się go znaleźć w podanej lokalizacji lub w pobliżu tej lokalizacji.

Żądanie metadanych i odpowiedź

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
Obiekt zastępczy „Brak zdjęć”

Kody stanu

Pole status w obiekcie odpowiedzi metadanych zawiera stan żądania i może zawierać informacje na potrzeby debugowania, które ułatwiają rozwiązywanie problemów dlaczego prośba do Street View nie działa. Pole status może zawierać następujące wartości:

Stan Opis
"OK" Wskazuje, że nie wystąpiły żadne błędy. jeśli zostanie znaleziona panorama, metadane zostaną .
"ZERO_RESULTS" Wskazuje, że w pobliżu podanej lokalizacji nie można znaleźć panoramy. Taka odpowiedź może wystąpić, jeśli podasz nieistniejący lub nieprawidłowy identyfikator panoramy. Przeczytaj sekcję [Odświeżanie usuniętych identyfikatorów panoram](#refresh-pano).
"NOT_FOUND" Wskazuje, że ciąg adresu podany w polu location nie udało się znaleźć parametru. Ten komunikat może się pojawić, jeśli adres nie istnieje .
"OVER_QUERY_LIMIT" Wskazuje, że został przekroczony limit dzienny 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 autoryzuje Twojej prośby lub Nie aktywowano statycznego interfejsu Street View API w Projekt w konsoli Google Cloud zawierający Twój klucz interfejsu API.
"INVALID_REQUEST" Ogólnie wskazuje, że parametry zapytania (adres, szerokości i długości geograficznej ani komponentów).
"UNKNOWN_ERROR" Wskazuje, że nie udało się przetworzyć żądania z powodu błędu serwera. Ten problem jest często tymczasowy. Jeśli spróbujesz ponownie, żądanie może się udać.

Więcej informacji

Aby dowiedzieć się więcej o korzystaniu ze statycznego interfejsu API Street View lub innych produktów interfejsu API Map Google, zapoznaj się z interfejsem API Map Google Strona pomocy.