Kafelki Street View

Karty Street View są podobne do: Kafelki 2D z wyjątkiem tych, które zawierają panoramiczne zdjęcia wykonane z poziomu ulicy. Na W Street View możesz poznawać zabytki z całego świata, podziwiać cuda natury i przechadzać się w miejscach takich jak muzea, obiekty sportowe, restauracje czy małe firmy. Ten punkt końcowy API zapewnia dostęp do:

• Kafelki Street View w Mapach Google
• Metadane Street View
• Miniatury Street View

Możesz łączyć ze sobą kafelki zdjęć zrobione z poziomu ulicy, realistyczny efekt panoramiczny. Możesz przesłać zapytanie o maksymalnie 100 identyfikatorów panoram w ramach zestawu lokalizacji (np. trasy) i uzyskać bardziej szczegółowe metadane dotyczące aparatu. pozycji.

Aby połączyć kafelki Street View, potrzebujesz gogli. Na przykład parametr Street View niestandardową przeglądarkę panoram.

Wskazówka: więcej informacji znajdziesz w Street View Static API oraz Usługa Street View.

Po uzyskaniu klucza interfejsu API możesz uzyskać dostęp do zdjęć Street View, wykonując te czynności.

1. Uzyskaj token sesji. Upewnij się, aby ustawić wartość mapType na streetview.

2. Użyj tokena sesji, aby: pobierz identyfikator panoramy (panoId) dla co najmniej jednego obszaru geograficznego lokalizacji.

3. Użyj identyfikatorów panoram z odpowiedzi wyszukiwania panoId, aby uzyskać:

   1. Metadane Street View Możesz też kupić Wyświetlanie metadanych przez przekazanie współrzędnych geograficznych oraz promienia.

   2. Miniatury Street View

   3. Kafelki Street View

.

Uwaga: przy każdej panoramie Street View musisz podać informacje o prawach autorskich. Ciąg, który należy wyświetlić, może być różny w zależności od panoramy. Uzyskanie praw autorskich musisz poprosić o metadane Street View oraz możesz skorzystać z pola copyright odpowiedzi.

Metody Street View

Aby uzyskać dostęp do zdjęć i metadanych Street View, wywołaj jedną z tych opcji 4 metody.

Metoda	Opis
https://tile.googleapis.com/v1/streetview/tiles	Zwraca poszczególne kafelki Street View. Kafelki Street View możesz wybierać na 6 poziomach powiększenia: od 512 do 13 312 pikseli.
https://tile.googleapis.com/v1/streetview/panoIds	Umożliwia zbiorcze wyszukiwanie do 100 lokalizacji. Zwraca identyfikatory panoram dla wszystkich lokalizacji ze zdjęciami.
https://tile.googleapis.com/v1/streetview/thumbnail	Zwraca miniaturę JPEG sceny ze Street View. Umożliwia określenie nagłówka, wysokości, wymiarów i pola widzenia. Minimalne wymiary to 16 x 16 pikseli. Maksymalne wymiary to 250 x 600 pikseli.
https://tile.googleapis.com/v1/streetview/metadata	Podaje szczegółowe informacje o określonej panoramie. Szczegóły obejmują powiązany adres i linki do sąsiednich panoram.

Wyszukiwanie panoram w Street View

Identyfikator panoramy dla co najmniej jednej lokalizacji geograficznej znajdziesz w przekazywanie ich współrzędnych (lat, lng) do metody panoIds. Żądanie [body] to obiekt JSON zawierający tablicę locations oraz opcjonalnie radius zgodnie z poniższym przykładem kodu JSON.

curl -X POST -d '{
  "locations": [
    {"lat": -33.883837, "lng": 151.209307},
    {"lat": -33.883700, "lng": 151.210307},
    {"lat": 0, "lng": 0}
  ],
  "radius": 50
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/streetview/panoIds?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY"

locations

Tablica locations musi zawierać co najmniej jeden zbiór wartości współrzędnych, ale możesz dodać więcej – maksymalnie 100.

radius

Wartość radius (mierzona w metrach) określa promień okręgu wokół danej lokalizacji, w której chcesz wyszukać panoramy. Wartość domyślna to 50 metrów.

Odpowiedź PanoId

Interfejs Map Tiles API próbuje znaleźć panoramę najbliżej każdej lokalizacji. a następnie wyświetla identyfikatory panoram. Udane żądanie panoIds zwraca błąd Obiekt JSON zawierający tablicę panoIds. Tablica zawiera listę w kolejności, w jakiej zostały zamówione. Jeśli interfejs Map Tiles API nie może znaleźć żadnych panoram we wskazanych lokalizacjach, a następnie puste pole jest zwracany w tej lokalizacji w tablicy. Na przykład zobacz z tego kodu JSON.

{
  "panoIds": [
    "ACfH-n2HcBvRry_3oc9grw",
    "f5DJZatBAAAXHlooS2wKbw",
    ""
  ]
}

Za pomocą panoIds możesz:

• Przesyłanie prośby o metadane Street View
• Przesyłanie prośby o miniatury Street View
• Zamawianie kafelków Street View

.

Uwaga: identyfikatory panoram są przejściowe. Oznacza to, że nie trwają zbyt długo. Jako nie polega na tym, że identyfikatory panoram są ważne dłużej niż sesji użytkownika.

Metadane Street View

Żądania metadanych Street View pobierają informacje o panoramach. Ulica A Żądanie wyświetlania metadanych to żądanie HTTPS GET. Informacje można pobrać o panoramach w jeden z dwóch sposobów:

• Jeśli przekażesz pano_id, interfejs Map Tiles API zwróci jego metadane panoramę.

• Jeśli jednak przekażesz lat i lng, interfejs Map Tiles API zwróci metadane najbliższą panoramę w promieniu wyszukiwania.

Przekazuj współrzędne i promień

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&lat=lat&lng=lng&radius=meters"

Ponieważ identyfikatory panoram są przejściowe, zalecamy przekazanie i wartość radius w żądaniu metadanych Street View. Oto przykładowy fragment kodu:

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&lat=47.62066&lng=-122.34923&radius=50"

Przekazywanie identyfikatora panoId zdjęcia Street View

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

Odpowiedź na metadane

Poniższy kod JSON zawiera przykład typowej odpowiedzi metadanych.

{
 "panoId": "rZ9KeTyhA11i0VppYNzsSg",
 "lat": 37.420864219339165,
 "lng": -122.08446528377291,
 "imageHeight": 6656,
 "imageWidth": 13312,
 "tileHeight": 512,
 "tileWidth": 512,
 "heading": 94.35,
 "tilt": 88.39652,
 "roll": 1.7181772,
 "imageryType": "outdoor",
 "date": "2023-01",
 "copyright": "© 2023 Google",
 "reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0&hl=en-US&gl=us",
 "addressComponents": [
  {
   "longName": "United States",
   "shortName": "United States",
   "types": [
    "country"
   ]
  },
  {
   "longName": "Mountain View, California",
   "shortName": "Mountain View, California",
   "types": [
    "locality"
   ]
  },
  {
   "longName": "Charleston Rd",
   "shortName": "Charleston Rd",
   "types": [
    "route"
   ]
  },
  {
   "longName": "1635",
   "shortName": "1635",
   "types": [
    "street_number"
   ]
  }
 ],
 "links": [
  {
   "panoId": "Yw4pqzA4FEq1qs-BwZSvSQ",
   "heading": 274.47998046875,
   "text": "Charleston Rd"
  },
  {
   "panoId": "1cODYwFRw1aZ45IignDIMw",
   "heading": 94.47999572753906,
   "text": "Charleston Rd"
  }
 ]
}

Poniższa lista zawiera definicje pól w treści odpowiedzi.

panoId

Unikalny identyfikator tej panoramy. Nie należy polegać na identyfikatorach panoram nie może trwać dłużej niż jedna sesja użytkownika.

lat, lng

Współrzędne (szerokość i długość geograficzna) panoramy. Wartości te mogą być inne niż współrzędne podane we wniosku, ponieważ lokalizacja zaciąga ją do najbliższej panoramy.

imageHeight, imageWidth

Wymiary połączonej panoramy.

tileHeight, tileWidth

Wymiary pojedynczego kafelka panoramy.

heading

Nagłówek kompasu, mierzony w stopniach, w prawo od północy. Nagłówki to zwracany w zakresie [0,360], przy czym 0 oznacza północ.

tilt

Kąt nachylenia panoramy mierzony w stopniach od południowego bieguna panoramę horyzontu. Zwracane wartości mieszczą się w zakresie [0–180]. Wartość A wynosi 90 stopni, co oznacza, że horyzont jest już wyrównany na równiku panoramę.

roll

Obrót w prawo wokół linii wzroku zastosowanej do panoramę, aby wyrównać horyzont. Zwracane wartości mieszczą się w zakresie [0, 360].

imageryType

Wskazuje typ obrazu. Prawidłowe wartości to indoor i outdoor.

date

Data wykonania zdjęcia. Nie wszystkie obrazy zawierają dane daty. Ale gdy jest dostępny, to pole zawiera kombinację roku (RRRR) i miesiąca (MM). np. 2023-05 lub 2024.

copyright

Tekst dotyczący praw autorskich, który musisz wyświetlać jako źródło informacji razem z informacjami o ulicy Wyświetl obraz.

reportProblemLink

Hiperłącze, którego użytkownicy mogą używać do zgłaszania problemów z tym widokiem Street View kafelek. Link ten musi znajdować się w prawym dolnym rogu musi zawierać tekst linku typu „Zgłoś problem” używając tego obrazu”.

addressComponent

Uporządkowana Geokod ze szczegółowymi informacjami o adresie panoramy. Aby dowiedzieć się więcej, zobacz Żądania i odpowiedzi geokodowania w dokumentacji interfejsu Geocoding API.

links

Lista identyfikatorów panoram, które są z nią połączone. Zawiera również nagłówek po znalezieniu linku. Jeśli na przykład nagłówek ma postać 180°, że panorama znajduje się na południe od bieżącej panoramy. Pamiętaj, że z powodu tymczasowy charakter identyfikatorów panoram, nie należy polegać na nich w przypadku niż pojedyncza sesja użytkownika.

Miniatury Street View

Możesz poprosić o zdjęcia Street View w formacie thumbnail. Miniatury są nieułożone obok siebie obrazy ze zdefiniowanymi przez użytkownika rozmiarem, nagłówkiem, tonacją i polem widzenia. Miniatury mają mniejszą rozdzielczość niż kafelki i są mniejsze w pliku rozmiaru. Aby wysłać prośbę o miniaturę, wyślij żądanie GET do usługi thumbnail. jak w poniższym prototypie kodu.

Uwaga: wartości pól w nawiasach kwadratowych w tym przykładzie pokazują zakresów. Na przykład height może mieć wartość od 16 do 250 pikseli.

curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId&height=FROM_16_TO_250&width=FROM_16_TO_600&pitch=FROM-90_TO_90&yaw=FROM-360_TO_360&fov=FROM_30_TO_120"

Weźmy pod uwagę poniższy przykład kodu, który umożliwia pobranie miniatury Street View zdjęcia zrobione w Whistler w Kanadzie.

curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=Zzl28rqGJgaL2IdkUleP8A&height=200&width=200&pitch=0&yaw=250&fov=80" --output /tmp/example_thumbnail.png

Wymagane parametry

panoId

Unikalny identyfikator miniatury, której szukasz. Możesz uzyskać wartości identyfikatora panoramy z punktu końcowego panoIds lub z interfejsu metadata punkt końcowy – oba te punkty akceptują dane geograficzne. i zwróci odpowiednią wartość panoId.

session

Prawidłowy token sesji.

key

Twój klucz interfejsu API.

Parametry opcjonalne

height

Określa wysokość miniatury w pikselach, od 16 pikseli do 250 pikseli. Jeśli nie określisz wysokości, domyślną wartością będzie maksymalna dozwolona wartość to 250 pikseli. Jeśli podasz wartość spoza zakresu, i miniatura przyciąga się do najbliższej prawidłowej wartości.

width

Określa szerokość miniatury w pikselach, od 16 do 600 pikseli pikseli. Jeśli nie określisz szerokości, domyślnie zostanie użyta szerokość maksymalna 600 pikseli. Jeśli podasz wartość spoza zakresu, miniatura przyciąga się do najbliższej prawidłowej wartości.

pitch

Określa kąt kamery wzdłuż osi pionowej. Prawidłowe wartości są w zakres od -90 do 90 (włącznie). Wartością domyślną jest 0.

yaw

Określa kierunek kamery wzdłuż osi poziomej. Prawidłowe wartości należą do zakresu od -360 do 360 (włącznie). Wartość domyślna to s 0.

fov

Określa poziome pole widzenia, wyrażone w stopniach, z maksymalną wartością 120. Podczas korzystania z widocznego obszaru o stałym rozmiarze, jak w przypadku Street View obraz o ustalonym rozmiarze; pole widzenia to powiększenie; gdzie mniejsze wartości określają i zwiększyć powiększenie. Wartością domyślną jest 90.

Kafelki zdjęć Street View

Gdy już będziesz mieć panoId, możesz poprosić o kafelek ze zdjęciem Street View. Płytki to żądania HTTPS GET. Przyjrzyjmy się temu przykładowi.

curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

W tym przykładzie kodu z to poziom powiększenia, x i y to współrzędne kafelka na wybranym kafelku Street View. Poziomy powiększenia na panoramach Street View muszą być mieści się w zakresie [0,5], gdzie 0 reprezentuje najszersze pole widzenia.

Poziom powiększenia	Przybliżone pole widzenia
0	360°
1	180°
2	90°
3	7°
4	22,5°
5	11,25°

Uwaga:Zdjęcia Street View są dostępne z 2 źródeł: Google (niepubliczne zdjęcia kontrolowane przez dewelopera) oraz udostępnione publicznie (treści generowane przez użytkowników lub publiczne treści użytkowników). Nie ma możliwości korzystania z tylko jednego źródła informacji o ulicy Wyświetl zdjęcie nad drugim. Dowiedz się więcej o naszych Polityka prywatności zdjęć Street View

Odpowiedzi z kafelków Street View

Pomyślna prośba o kafelek Street View zwraca zdjęcie w tym formacie i rozmiarze podany w odpowiedzi createSession.

Przy zerowym poziomie powiększenia cała panorama jest zmieniana na kafelek z wymiarami. tileWidth, autor: tileHeight. Panoramy są większe w wymiarze x, kafelek będzie zawierał puste miejsce w wymiarze y:

Przy piątym poziomie powiększenia wyświetlana jest pełnowymiarowa panorama podzielona na kafelki.

Wskazówka: możesz obliczyć maksymalną wartość x i y, dzieląc wartości imageHeight i imageWidth przez: tileHeight i tileWidth.

Prawa autorskie

Każda panorama Street View musi zawierać informacje o prawach autorskich. wyświetlany ciąg znaków może być różny w zależności od panoram. Aby uzyskać informacje o prawach autorskich, musisz poprosić o metadane Street View, a potem sprawdź pole copyright odpowiedzi. Więcej informacji: Atrybucja danych.