Package google.streetview.publish.v1

Indeks

StreetViewPublishService

Publikuje i łączy zdjęcia przesyłane przez użytkowników w Street View.

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Usuwa listę elementów Photos i ich metadanych.

Jeśli nie uda się wykonać żądania BatchDeletePhotos, oznacza to, że brakuje pól krytycznych lub występuje błąd uwierzytelniania. Nawet jeśli proces BatchDeletePhotos się powiedzie, poszczególne zdjęcia w grupie mogą zawierać błędy. Te błędy są wyszczególnione na każdym PhotoResponse.status w BatchDeletePhotosResponse.results. Na stronie DeletePhoto znajdziesz informacje o konkretnych błędach, które mogą wystąpić w przypadku poszczególnych zdjęć.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

Pobiera metadane określonego wsadu Photo.

Jeśli nie uda się wykonać żądania BatchGetPhotos, oznacza to, że brakuje pól krytycznych lub występuje błąd uwierzytelniania. Nawet jeśli proces BatchGetPhotos się powiedzie, poszczególne zdjęcia w grupie mogą zawierać błędy. Te błędy są wyszczególnione na każdym PhotoResponse.status w BatchGetPhotosResponse.results. Na stronie GetPhoto znajdziesz informacje o konkretnych błędach, które mogą wystąpić w przypadku poszczególnych zdjęć.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

Aktualizuje metadane elementu Photos, takie jak pozowanie, powiązanie miejsc, połączenia itp. Zmiana pikseli zdjęć nie jest obsługiwana.

Jeśli nie uda się wykonać żądania BatchUpdatePhotos, oznacza to, że brakuje pól krytycznych lub występuje błąd uwierzytelniania. Nawet jeśli proces BatchUpdatePhotos się powiedzie, poszczególne zdjęcia w grupie mogą zawierać błędy. Te błędy są wyszczególnione na każdym PhotoResponse.status w BatchUpdatePhotosResponse.results. Na stronie UpdatePhoto znajdziesz informacje o konkretnych błędach, które mogą wystąpić w przypadku poszczególnych zdjęć.

Używane są tylko pola określone w polu updateMask. Jeśli wartość updateMask nie jest podana, aktualizacja zostanie zastosowana do wszystkich pól.

Liczba wiadomości UpdatePhotoRequest w BatchUpdatePhotosRequest nie może przekraczać 20.

Uwaga: aby zaktualizować pole Pose.altitude, musisz też podać pole Pose.latLngPair. W przeciwnym razie żądanie się nie powiedzie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

Gdy klient zakończy przesyłanie zdjęcia ze zwróconym UploadRef, CreatePhoto publikuje przesłane zdjęcie Photo do Street View w Mapach Google.

Obecnie jedynym sposobem ustawienia nagłówka, tonu i przesuwania w CreatePhoto jest użycie metadanych XMP Photo Sphere w bajtach zdjęć. CreatePhoto ignoruje pola pose.heading, pose.pitch, pose.roll, pose.altitude i pose.level w ustawieniu.

Ta metoda zwraca te kody błędów:

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

Gdy klient zakończy przesyłanie PhotoSequence ze zwróconym UploadRef, CreatePhotoSequence wyodrębnia sekwencję zdjęć sferycznych z filmu lub metadanych urządzenia Extensible Device Metadata (XDM, http://www.xdm.org/) do opublikowania w Street View w Mapach Google.

CreatePhotoSequence zwraca wartość Operation z identyfikatorem PhotoSequence ustawionym w polu Operation.name.

Ta metoda zwraca te kody błędów:

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

Usuwa obiekt Photo i jego metadane.

Ta metoda zwraca te kody błędów:

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

Usuwa obiekt PhotoSequence i jego metadane.

Ta metoda zwraca te kody błędów:

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

Pobiera metadane określonego elementu Photo.

Ta metoda zwraca te kody błędów:

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

Pobiera metadane określonego obiektu PhotoSequence przez interfejs Operation.

Ta metoda zwraca 3 typy odpowiedzi:

  • Operation.done = fałsz, jeśli przetwarzanie danych PhotoSequence jeszcze się nie zakończyło.
  • Operation.done = true i Operation.error, jeśli podczas przetwarzania wystąpił błąd.
  • Operation.done = prawda i pole Operation.response zawiera komunikat PhotoSequence.

Ta metoda zwraca te kody błędów:

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

Zawiera listę wszystkich elementów PhotoSequences należących do użytkownika, w kolejności według sygnatur czasowych CreatePhotoSequence.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

Zawiera listę wszystkich Photos należących do użytkownika.

Uwaga: ostatnio utworzone zdjęcia, które są nadal indeksowane, nie są zwracane w odpowiedzi.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

Tworzy sesję przesyłania, aby rozpocząć przesyłanie danych sekwencji zdjęć. Adres URL przesyłania zwróconego obiektu UploadRef jest używany do przesyłania danych dotyczących źródła danych photoSequence.

Po zakończeniu przesyłania obiekt UploadRef zostanie użyty razem z zasadą CreatePhotoSequence do utworzenia wpisu obiektu PhotoSequence.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
StartUpload

rpc StartUpload(Empty) returns (UploadRef)

Tworzy sesję przesyłania, aby rozpocząć przesyłanie bajtów zdjęć. Metoda używa adresu URL przesyłania zwróconego obiektu UploadRef, aby przesłać bajty dla zasobu Photo.

Oprócz spełnienia wymagań dotyczących zdjęć opisanych na stronie https://support.google.com/maps/answer/7012050?ref_topic=6275604 zdjęcie musi też spełniać te wymagania:

Po zakończeniu przesyłania metoda używa UploadRef z CreatePhoto do utworzenia wpisu obiektu Photo.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

Aktualizuje metadane elementu Photo, np. pozycję, skojarzenie miejsc, połączenia itp. Zmiana pikseli zdjęcia nie jest obsługiwana.

Używane są tylko pola określone w polu updateMask. Jeśli wartość updateMask nie jest podana, aktualizacja zostanie zastosowana do wszystkich pól.

Ta metoda zwraca te kody błędów:

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

BatchDeletePhotosRequest

Prośba o usunięcie wielu elementów: Photos.

Pola
photo_ids[]

string

Wymagane. Identyfikator elementu Photos. Żądania HTTP GET wymagają tej składni parametru zapytania w adresie URL: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

Odpowiedź na zbiorcze usunięcie co najmniej 1 Photos.

Pola
status[]

Status

Stan operacji usuwania pojedynczego elementu Photo z żądania zbiorczego.

BatchGetPhotosRequest

Poproś o co najmniej 1 Photos. Domyślnie

  • nie zwraca adresu URL pobierania dla bajtów zdjęć.

Parametry:

  • view określa, czy zwracany jest adres URL pobierania bajtów zdjęć.
Pola
photo_ids[]

string

Wymagane. Identyfikator elementu Photos. W przypadku żądań HTTP GET parametrem zapytania URL powinien być photoIds=<id1>&photoIds=<id2>&....
view

PhotoView

Wymagane. Określa, czy w odpowiedzi zdjęcia powinien być zwracany adres URL pobierania bajtów zdjęć.
language_code

string

Opcjonalnie: Kod języka BCP-47, na przykład „en-US”. czy „sr-Latn”. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jeśli parametr language_code nie jest określony, używany jest język wybrany przez użytkownika w usługach Google.

BatchGetPhotosResponse

Odpowiedź na pobieranie zbiorcze Photos.

Pola
results[]

PhotoResponse

Lista wyników dla każdego żądania z pola Photo, w takiej samej kolejności jak żądania w tabeli BatchGetPhotos.

BatchUpdatePhotosRequest

Prośba o aktualizację metadanych zdjęć. Aktualizacja pikseli zdjęć nie jest obsługiwana.

Pola
update_photo_requests[]

UpdatePhotoRequest

Wymagane. Lista: UpdatePhotoRequests.

BatchUpdatePhotosResponse

Odpowiedź na zbiorczą aktualizację metadanych co najmniej 1 elementu Photos.

Pola
results[]

PhotoResponse

Lista wyników dla każdego elementu Photo została zaktualizowana, w takiej samej kolejności jak w żądaniu.

Połączenie

Połączenie to link ze zdjęcia źródłowego do zdjęcia docelowego.

Pola
target

PhotoId

Wymagane. Miejsce docelowe połączenia między zdjęciem zawierającym a innym zdjęciem.

CreatePhotoRequest

Prośba o utworzenie: Photo.

Pola
photo

Photo

Wymagane. Zdjęcie do utworzenia.

CreatePhotoSequenceRequest

Prośba o utworzenie PhotoSequence z filmu.

Pola
photo_sequence

PhotoSequence

Wymagane. PhotoSequence, aby utworzyć.
input_type

InputType

Wymagane. Forma wejściowa PhotoSequence.

InputType

Wejściowe formy liczb PhotoSequence.

Wartości w polu enum
INPUT_TYPE_UNSPECIFIED Nie określono. Serwer zwróci wartość google.rpc.Code.INVALID_ARGUMENT.
VIDEO Film sferyczny.
XDM Extensible Device Metadata, http://www.xdm.org

DeletePhotoRequest

Prośba o usunięcie elementu Photo.

Pola
photo_id

string

Wymagane. Identyfikator elementu Photo.

DeletePhotoSequenceRequest

Prośba o usunięcie elementu PhotoSequence.

Pola
sequence_id

string

Wymagane. Identyfikator elementu PhotoSequence.

GetPhotoRequest

Prośba o: Photo.

Domyślnie

  • nie zwraca adresu URL pobierania dla bajtów zdjęć.

Parametry:

  • view określa, czy zwracany jest adres URL pobierania bajtów zdjęć.
Pola
photo_id

string

Wymagane. Identyfikator elementu Photo.
view

PhotoView

Wymagane. Określa, czy w odpowiedzi Photo powinien być zwracany adres URL pobierania bajtów zdjęć.
language_code

string

Kod języka BCP-47, na przykład „en-US”. czy „sr-Latn”. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jeśli parametr language_code nie jest określony, używany jest język wybrany przez użytkownika w usługach Google.

GetPhotoSequenceRequest

Prośba o: PhotoSequence.

Domyślnie

Parametry:

  • view określa, czy zwracany jest adres URL pobierania dla PhotoSequence.
Pola
sequence_id

string

Wymagane. Identyfikator sekwencji zdjęć.
view
(deprecated)

PhotoView

Określa, czy adres URL pobierania dla sekwencji zdjęć ma być zwracany w polu download_url pojedynczych zdjęć w odpowiedzi PhotoSequence.

Uwaga: obecnie nie wdrożono.
filter

string

Opcjonalnie: Wyrażenie filtra. Na przykład: published_status=PUBLISHED.

Obsługiwane filtry to: published_status. Więcej informacji znajdziesz na stronie https://google.aip.dev/160.

GpsDataGapFailureDetails

Szczegóły dotyczące błędu ProcessingFailureReason#GPS_DATA_GAP. Jeśli w danych GPS występuje wiele luk, w tym raporcie uwzględniana jest tylko ta o najdłuższym czasie trwania.

Pola
gap_duration

Duration

Czas trwania luki w danych GPS, które zostały znalezione.
gap_start_time

Duration

Względny czas (od początku strumienia wideo), w którym zaczęła się przerwa.

Imu

Dane IMU z czujników urządzenia.

Pola
accel_mpsps[]

Measurement3d

Pomiary przy użyciu akcelerometru w metrach/s^2 wraz z rosnącą liczbą sygnatur czasowych z urządzeń.
gyro_rps[]

Measurement3d

Pomiary żyroskopu w radianach/s z coraz większą liczbą sygnatur czasowych z urządzeń.
mag_ut[]

Measurement3d

Pomiary pola magnetycznego przez magnetometr w mikroteslach (uT) z coraz większą liczbą sygnatur czasowych z urządzeń.

Pomiary3d

Ogólna próbka do pomiaru w 3D.

Pola
capture_time

Timestamp

Sygnatura czasowa pomiaru IMU.
x

float

Pomiar z czujnika na osi X.
y

float

Pomiar z czujnika na osi Y.
z

float

Pomiar czujnika na osi Z.

ImuDataGapFailureDetails

Szczegóły dotyczące błędu ProcessingFailureReason#IMU_DATA_GAP. Jeśli występuje wiele luk w danych IMU, w tym raporcie podawana jest tylko ta o najdłuższym czasie trwania.

Pola
gap_duration

Duration

Czas trwania luki w znalezionych danych IMU.
gap_start_time

Duration

Względny czas (od początku strumienia wideo), w którym zaczęła się przerwa.

InsufficientGpsFailureDetails

Szczegóły dotyczące błędu ProcessingFailureReason#INSUFFICIENT_GPS.

Pola
gps_points_found

int32

Liczba punktów GPS znalezionych w filmie.

LatLngBounds

Prostokąt we współrzędnych geograficznych.

Pola
southwest

LatLng

Południowo-zachodni róg tych granic.
northeast

LatLng

Północno-wschodni róg tych granic.

Poziom

Informacje o poziomie zawierające numer poziomu i jego nazwę.

Pola
number

double

Opcjonalnie: Numer piętra użyty do składania zamówienia. 0 wskazuje poziom gruntu, 1 oznacza pierwszy poziom powyżej gruntu, -1 oznacza pierwszy poziom pod ziemią. Wartości inne niż całkowite są dozwolone.
name

string

Wymagane. Nazwa przypisana do tego poziomu, ograniczona do 3 znaków. Zastanów się, jak przyciski windy byłyby oznaczone na tym poziomie, gdyby nie było windy.

ListPhotoSequencesRequest

Prośba o wyświetlenie wszystkich sekwencji zdjęć należących do użytkownika, który wysłał prośbę.

Parametry:

  • pageSize określa maksymalną liczbę sekwencji zdjęć do zwrócenia.
  • pageToken to wartość tokena następnej strony zwrócona z poprzedniego żądania ListPhotoSequences (jeśli miało to miejsce).
Pola
page_size

int32

Opcjonalnie: Maksymalna liczba sekwencji zdjęć do zwrócenia. Wartość pageSize nie może być liczbą ujemną. Jeśli pageSize ma wartość 0 lub nie jest podana, używany jest domyślny rozmiar strony 100. Liczba sekwencji zdjęć zwróconych w odpowiedzi może być mniejsza niż pageSize, jeśli liczba dopasowań jest mniejsza niż pageSize. Obecnie nie zaimplementowano tej funkcji, ale jest ona przetwarzana.
page_token

string

Opcjonalnie: Wartość nextPageToken zwrócona z poprzedniego żądania ListPhotoSequences (jeśli miało to miejsce).
filter

string

Opcjonalnie: Wyrażenie filtra. Na przykład: imagery_type=SPHERICAL.

Obsługiwane filtry to: imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, `max_capture_time_seconds. Więcej informacji znajdziesz na stronie https://google.aip.dev/160. Zapytania dotyczące nazw plików powinny być wysyłane jako wyrażenie, ponieważ wymagają dodawania wielu słów i znaków specjalnych po dodaniu cudzysłowów ze zmianą znaczenia. Przykład: filename_query="przykładowy tekst do wyrażenia.mp4"

ListPhotoSequencesResponse

Odpowiedź na wyświetlenie listy wszystkich sekwencji zdjęć należących do użytkownika.

Pola
photo_sequences[]

Operation

Lista sekwencji zdjęć dostępnych w interfejsie Operation.

Maksymalna liczba zwróconych produktów jest określana na podstawie pola pageSize w żądaniu.

Każdy element na liście może mieć 3 możliwe stany:

  • Operation.done = fałsz, jeśli przetwarzanie danych PhotoSequence jeszcze się nie zakończyło.
  • Operation.done = true i Operation.error, jeśli podczas przetwarzania wystąpił błąd.
  • Operation.done = true, a Operation.response zawiera komunikat PhotoSequence. W każdej sekwencji wypełnione jest tylko Id.
next_page_token

string

Token pobierający następną stronę wyników lub pusty, jeśli na liście nie ma więcej wyników.

ListPhotosRequest

Poproś o listę wszystkich zdjęć należących do użytkownika, który wysłał prośbę.

Domyślnie

  • nie zwraca adresu URL pobierania dla bajtów zdjęć.

Parametry:

  • view określa, czy zwracany jest adres URL pobierania bajtów zdjęć.
  • pageSize określa maksymalną liczbę zdjęć do zwrócenia.
  • pageToken to wartość tokena następnej strony zwrócona z poprzedniego żądania ListPhotos (jeśli miało to miejsce).
  • Funkcja filter umożliwia filtrowanie według określonego parametru. „placeId” to jedyny obsługiwany parametr.
Pola
view

PhotoView

Wymagane. Określa, czy adres URL pobierania bajtów zdjęć powinien być zwracany w odpowiedzi Zdjęcia.
page_size

int32

Opcjonalnie: Maksymalna liczba zdjęć do zwrócenia. Wartość pageSize nie może być liczbą ujemną. Jeśli pageSize ma wartość 0 lub nie jest podana, używany jest domyślny rozmiar strony 100. Liczba zdjęć zwróconych w odpowiedzi może być mniejsza niż pageSize, jeśli liczba zdjęć należących do użytkownika jest mniejsza niż pageSize.
page_token

string

Opcjonalnie: Wartość nextPageToken zwrócona z poprzedniego żądania ListPhotos (jeśli miało to miejsce).
filter

string

Opcjonalnie: Wyrażenie filtra. Na przykład: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw.

Obsługiwane filtry to: placeId, min_latitude, max_latitude, min_longitude, max_longitude. Więcej informacji znajdziesz na stronie https://google.aip.dev/160.
language_code

string

Opcjonalnie: Kod języka BCP-47, na przykład „en-US”. czy „sr-Latn”. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jeśli parametr language_code nie jest określony, używany jest język wybrany przez użytkownika w usługach Google.

ListPhotosResponse

Odpowiedź na wyświetlenie listy wszystkich zdjęć należących do użytkownika.

Pola
photos[]

Photo

Lista zdjęć. Pole pageSize w żądaniu określa liczbę zwróconych elementów.
next_page_token

string

Token pobierający następną stronę wyników lub pusty, jeśli na liście nie ma więcej wyników.

NoOverlapGpsFailureDetails

Szczegóły dotyczące błędu PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.

Pola
gps_start_time

Timestamp

Czas pierwszego zarejestrowania punktu GPS.
gps_end_time

Timestamp

Czas ostatniego zarejestrowania punktu GPS.
video_start_time

Timestamp

Czas rozpoczęcia filmu.
video_end_time

Timestamp

Czas zakończenia filmu.

NotOutdoorsFailureDetails

Szczegóły dotyczące parametru ProcessingFailureReason#NOT_OUTDOORS. Jeśli zostanie znalezionych kilka klatek wewnątrz, tutaj zostanie zarejestrowana pierwsza z nich.

Pola
start_time

Duration

Względny czas (od początku strumienia wideo), w którym znaleziono klatkę wewnętrzną.

Zdjęcie

Zdjęcie służy do przechowywania zdjęć sferycznych wraz z ich metadanymi.

Pola
photo_id

PhotoId

Wymagane. Tylko dane wyjściowe. Wymagane podczas aktualizowania zdjęcia. Dane wyjściowe tylko podczas tworzenia zdjęcia. Identyfikator zdjęcia, który jest niepowtarzalny wśród wszystkich zdjęć w Google.
upload_reference

UploadRef

Tylko dane wejściowe. Wymagane podczas tworzenia zdjęcia. Tylko dane wejściowe. URL zasobu, do którego przesyłane są bajty zdjęć.
download_url

string

Tylko dane wyjściowe. Adres URL pobierania bajtów zdjęć. To pole jest ustawiane tylko wtedy, gdy GetPhotoRequest.view ma wartość PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnail_url

string

Tylko dane wyjściowe. Adres URL miniatury do wyświetlania podglądu danego zdjęcia.
pose

Pose

Opcjonalnie: Pozycja zdjęcia.
connections[]

Connection

Opcjonalnie: Połączenia z innymi zdjęciami. Połączenie oznacza link z tego zdjęcia do innego.
capture_time

Timestamp

Opcjonalnie: Bezwzględny czas, w którym zrobiono zdjęcie. Jeśli zdjęcie nie ma sygnatury czasowej EXIF, służy do ustawiania sygnatury czasowej w metadanych zdjęcia.
upload_time

Timestamp

Tylko dane wyjściowe. Czas przesłania obrazu.
places[]

Place

Opcjonalnie: Miejsca, w których znajduje się to zdjęcie.
view_count

int64

Tylko dane wyjściowe. Liczba wyświetleń zdjęcia.
transfer_status

TransferStatus

Tylko dane wyjściowe. Stan przeniesienia praw do tego zdjęcia.
maps_publish_status

MapsPublishStatus

Tylko dane wyjściowe. Informacja o tym, czy zdjęcie zostało opublikowane czy odrzucone w Mapach Google.

MapsPublishStatus

Stan publikacji zdjęcia w Mapach Google.

Wartości w polu enum
UNSPECIFIED_MAPS_PUBLISH_STATUS Stan zdjęcia jest nieznany.
PUBLISHED Zdjęcie jest publikowane publicznie w Mapach Google.
REJECTED_UNKNOWN Zdjęcie zostało odrzucone z nieznanego powodu.

TransferStatus

Stan przenoszenia praw.

Wartości w polu enum
TRANSFER_STATUS_UNKNOWN Stan tego przenoszenia jest nieokreślony.
NEVER_TRANSFERRED To zdjęcie nigdy nie było przesyłane.
PENDING Przesyłanie zdjęć zostało rozpoczęte, ale odbiorca jeszcze nie odpowiedział.
COMPLETED Zdjęcia zostały przeniesione i zostało przekazane odbiorcy.
REJECTED Odbiorca odrzucił to przeniesienie zdjęć.
EXPIRED Przesyłanie zdjęć wygasło, zanim odbiorca wykonał jakiekolwiek działania.
CANCELLED Nadawca anulował to przeniesienie zdjęć.
RECEIVED_VIA_TRANSFER Odbiorca jest właścicielem tego zdjęcia ze względu na przeniesienie praw.

PhotoId

Identyfikator elementu Photo.

Pola
id

string

Unikalny identyfikator zdjęcia.

PhotoResponse

Ładunek odpowiedzi dla pojedynczego obiektu Photo w operacjach wsadowych, w tym BatchGetPhotos i BatchUpdatePhotos.

Pola
status

Status

Stan operacji pobierania lub aktualizowania pojedynczego zdjęcia w żądaniu zbiorczym.
photo

Photo

Zasób Photo, jeśli żądanie zostało zrealizowane.

PhotoSequence

Sekwencja zdjęć sferycznych wraz z metadanymi.

Pola
id

string

Tylko dane wyjściowe. Unikalny identyfikator sekwencji zdjęć. Jeśli przesyłanie odbywa się asynchronicznie, pełni również funkcję identyfikatora długo trwającej operacji.
photos[]

Photo

Tylko dane wyjściowe. Zdjęcia z coraz większą liczbą sygnatur czasowych.
upload_reference

UploadRef

Tylko dane wejściowe. Wymagane przy tworzeniu sekwencji zdjęć. Nazwa zasobu, do którego przesyłane są bajty sekwencji zdjęć (w formie filmu).
capture_time_override

Timestamp

Opcjonalnie: Bezwzględny czas, w którym rozpocznie się wykonywanie sekwencji zdjęć. Jeśli sekwencja zdjęć to film, jest to czas jego rozpoczęcia. Jeśli to pole zostanie wypełnione, zastępuje czas przechwytywania filmu lub pliku XDM.
upload_time

Timestamp

Tylko dane wyjściowe. Godzina utworzenia tej sekwencji zdjęć w usłudze Sklep uSV.
raw_gps_timeline[]

Pose

Tylko dane wejściowe. Nieprzetworzone pomiary GPS z rosnącymi sygnaturami czasowymi z urządzenia, które nie są synchronizowane z każdym zdjęciem. Te nieprzetworzone pomiary posłużą do ustalenia pozycji każdej klatki. Wymagane w przypadku danych wejściowych, gdy typ źródła ma wartość VIDEO, a nieprzetworzone pomiary GPS nie są uwzględniane w ramach ścieżki metadanych aparatu (CAMM). Użytkownik może wskazać, który z nich ma pierwszeństwo, używając parametru gps_source, jeśli nieprzetworzone pomiary GPS są podane zarówno w raw_gps_timeline, jak i w Cam Motion Metadata Track (CAMM).
gps_source

GpsSource

Tylko dane wejściowe. Jeśli zarówno raw_gps_timeline, jak i ścieżka metadanych aparatu (CAMM) zawierają pomiary GPS, wskaż, który z nich ma pierwszeństwo.
imu

Imu

Tylko dane wejściowe. Trójosiowe dane IMU dla zbioru. Jeśli dane są zbyt duże, aby umieścić je w żądaniu, należy je umieścić w ścieżce CAMM dla filmu. Te dane mają zawsze pierwszeństwo przed równoważnymi danymi CAMM, jeśli istnieją.
processing_state

ProcessingState

Tylko dane wyjściowe. Stan przetwarzania tej sekwencji.
failure_reason

ProcessingFailureReason

Tylko dane wyjściowe. Jeśli ta sekwencja ma przetwarzanie_stan = FAILED, zobaczysz przyczynę niepowodzenia. Jeśli parametr „process_state” ma dowolną inną wartość, pole to jest nieskonfigurowane.
failure_details

ProcessingFailureDetails

Tylko dane wyjściowe. Jeśli ta sekwencja ma ustawiony typ failure_reason, może ona zawierać dodatkowe informacje o błędzie.
distance_meters

double

Tylko dane wyjściowe. Obliczona odległość sekwencji zdjęć w metrach.
sequence_bounds

LatLngBounds

Tylko dane wyjściowe. Prostokątne pole, które obejmuje wszystkie obrazy w tej sekwencji zdjęć.
view_count

int64

Tylko dane wyjściowe. Łączna liczba wyświetleń wszystkich opublikowanych zdjęć w tej sekwencji zdjęć.
filename

string

Tylko dane wyjściowe. Nazwa przesyłanego pliku. Nie obejmuje ścieżki katalogu. Dostępne tylko wtedy, gdy sekwencja została przesłana na platformę, która zapewnia nazwę pliku.

GpsSource

Podstawowe źródło pomiarów GPS.

Wartości w polu enum
PHOTO_SEQUENCE GPS w raw_gps_timeline ma pierwszeństwo, jeśli istnieje.
CAMERA_MOTION_METADATA_TRACK GPS w ścieżce metadanych kamery w ruchu (CAMM) ma pierwszeństwo, jeśli istnieje.

PhotoView

Określa, który widok obiektu Photo ma zostać uwzględniony w odpowiedzi.

Wartości w polu enum
BASIC Odpowiedzi serwera nie zawierają adresu URL pobierania bajtów zdjęć. Wartość domyślna.
INCLUDE_DOWNLOAD_URL Odpowiedzi serwera zawierają adres URL pobierania dla bajtów zdjęć.

Miejsce

Metadane miejsca dotyczące elementu.

Pola
place_id

string

Identyfikator miejsca, jak opisano na stronie https://developers.google.com/places/place-id.
name

string

Tylko dane wyjściowe. Nazwa miejsca zlokalizowana na wartość atrybutu language_code.
language_code

string

Tylko dane wyjściowe. Kod language_code, z którym jest zlokalizowana nazwa. Powinien to być parametr language_code określony w żądaniu, ale może to być wartość zastępcza.

Pozycja

Pomiar nieprzetworzonej pozycji jednostki.

Pola
lat_lng_pair

LatLng

Para szerokości i długości geograficznej pozycji, jak opisano tutaj: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Jeśli podczas tworzenia elementu Photo nie podano pary szerokości i długości geograficznej, używana jest geolokalizacja z nagłówka EXIF. Para szerokości i długości geograficznej, która nie jest podana w nagłówku zdjęcia lub w nagłówku EXIF, powoduje niepowodzenie przetwarzania zdjęć.
altitude

double

Wysokość pozycji w metrach nad elipsoidą WGS84. NaN wskazuje niezmierzoną ilość.
heading

double

Poniższe parametry pozycji odnoszą się do środka zdjęcia. Są zgodne z https://developers.google.com/streetview/spherical-metadata. Nagłówek kompasu mierzony na środku zdjęcia, wyrażony w stopniach w prawo, od północy. Wartość musi mieścić się w zakresie od 0 do 360. NaN wskazuje niezmierzoną ilość.
pitch

double

Wysokość jest mierzona w stopniach na środku zdjęcia. Wartość musi mieścić się w przedziale od –90 do <= 90. Wartość -90 oznacza patrzenie bezpośrednio w dół, a 90 oznacza patrzenie w górę. NaN wskazuje niezmierzoną ilość.
roll

double

Obrót mierzony w stopniach. Wartość musi mieścić się w zakresie od 0 do 360. Wartość 0 oznacza poziom wzdłuż horyzontu. NaN wskazuje niezmierzoną ilość.
gps_record_timestamp_unix_epoch

Timestamp

Czas zapisu GPS od początku epoki UTC.
level

Level

Poziom (piętro w budynku) używana do konfigurowania nawigacji w pionie.
accuracy_meters

float

Szacunkowa dokładność pozioma tej pozycji w metrach z 68% pewnością (jedno odchylenie standardowe). Na przykład na Androidzie ta wartość jest dostępna za pomocą tej metody: https://developer.android.com/reference/android/location/Location#getAccuracy(). Inne platformy stosują różne metody uzyskiwania podobnych szacunków dokładności.

ProcessingFailureDetails

Dodatkowe informacje dołączane do enum ProcessingFailureReason. Ten komunikat powinien być zawsze używany w połączeniu z parametrem ProcessingFailureReason, a jedna z wartości ustawiona w tej wiadomości powinna być zgodna z parametrem AcceptureReason.

Pola
Pole sumy details. Ustawiony zostanie tylko 1 zestaw szczegółów, który musi odpowiadać odpowiedniemu wyliczeniu w ProcessingFailureReason. details może mieć tylko jedną z tych wartości:
insufficient_gps_details

InsufficientGpsFailureDetails

Zapoznaj się z informacjami o InsufficientGpsFailureDetails.
gps_data_gap_details

GpsDataGapFailureDetails

Zobacz GpsDataGapFailureDetails.
imu_data_gap_details

ImuDataGapFailureDetails

Zobacz ImuDataGapFailureDetails.
not_outdoors_details

NotOutdoorsFailureDetails

Zobacz NotOutdoorsFailureDetails.
no_overlap_gps_details

NoOverlapGpsFailureDetails

Zobacz NoOverlapGpsFailureDetails.

ProcessingFailureReason

Możliwe przyczyny, dla których nie udało się przetworzyć tego elementu (PhotoSequence).

Wartości w polu enum
PROCESSING_FAILURE_REASON_UNSPECIFIED Przyczyna niepowodzenia nie jest określona. Jest to wartość domyślna.
LOW_RESOLUTION Rozdzielczość klatki filmu jest za mała.
DUPLICATE Ten film został już przesłany.
INSUFFICIENT_GPS Za mało punktów GPS.
NO_OVERLAP_GPS Przedział czasu ścieżki GPS nie pokrywa się z przedziałem czasu filmu.
INVALID_GPS GPS jest nieprawidłowy (np. wszystkie punkty GPS są ustawione na (0,0))
FAILED_TO_REFINE_POSITIONS Nie udało się dokładnie zlokalizować sekwencji zdjęć w różnych miejscach świata.
TAKEDOWN Sekwencja została usunięta z powodu naruszenia zasad.
CORRUPT_VIDEO Plik wideo jest uszkodzony lub nie można go zdekodować.
INTERNAL Wystąpił trwała awaria w bazowym systemie.
INVALID_VIDEO_FORMAT Nieprawidłowy lub nieobsługiwany format filmu.
INVALID_VIDEO_DIMENSIONS Znaleziono nieprawidłowy format obrazu.
INVALID_CAPTURE_TIME Nieprawidłowy czas przechwytywania. Sygnatury czasowe pochodzą z przyszłości.
GPS_DATA_GAP Dane GPS zawierają lukę trwającą ponad 5 sekund.
JUMPY_GPS Dane GPS są zbyt nieregularne, aby można je było przetworzyć.
INVALID_IMU Dane IMU (akcelerometru, żyroskopu itp.) są nieprawidłowe. Może brakować w nich wymaganych pól (x, y, z lub godzina), mają niepoprawny format lub występują inne problemy, które uniemożliwiają naszym systemom ich analizę.
INSUFFICIENT_IMU Za mało punktów IMU.
INSUFFICIENT_OVERLAP_TIME_SERIES Niewystarczające pokrywanie się przedziałów czasowych między danymi GPS, IMU i innymi ciągami czasowymi.
IMU_DATA_GAP Dane IMU (akcelerometru, żyroskopu itp.) zawierają przerwy trwające ponad 0, 1 sekundy.
UNSUPPORTED_CAMERA Aparat nie jest obsługiwany.
NOT_OUTDOORS Niektóre klatki były wyświetlane wewnątrz budynków, co nie jest obsługiwane.
INSUFFICIENT_VIDEO_FRAMES Za mało klatek wideo.
INSUFFICIENT_MOVEMENT Za mało danych w ruchu.

ProcessingState

Stan przetwarzania sekwencji. Stany Zjednoczone zmieniają się w ten sposób:

     +-------------------------+
     |                         |
 +---v---+  +----------+  +----+----+
 |PENDING+-->PROCESSING+-->PROCESSED|
 +---+---+  +----+-----+  +----+----+
     |           |             |
     |        +--v---+         |
     +-------->FAILED<---------+
              +------+

Sekwencja może przejść do stanu BŁĄD z dowolnego stanu. Dodatkowo przetworzona sekwencja może w każdej chwili zostać ponownie przetworzona.

Wartości w polu enum
PROCESSING_STATE_UNSPECIFIED Stan nie jest określony. Jest to wartość domyślna.
PENDING Jeszcze nie rozpoczęto przetwarzania sekwencji.
PROCESSING Sekwencja jest obecnie przetwarzana.
PROCESSED Zakończono przetwarzanie sekwencji, w tym doprecyzowanie pozycji.
FAILED Nie udało się przetworzyć sekwencji. Więcej informacji znajdziesz w sekcji Błąd związany z powodem niepowodzenia.

UpdatePhotoRequest

Żądanie aktualizacji metadanych obiektu Photo. Nie można aktualizować pikseli zdjęcia.

Pola
photo

Photo

Wymagane. Photo obiekt zawierający nowe metadane.
update_mask

FieldMask

Wymagane. Maska identyfikująca pola w metadanych zdjęcia, które mają być aktualizowane. Jeśli ich nie ma, stare metadane Photo zostaną w tym żądaniu całkowicie zastąpione nowymi metadanymi Photo. Aktualizacja się nie uda, jeśli podasz nieprawidłowe pola. Na liście rozdzielanej przecinkami można podać wiele pól.

Prawidłowe są te pola:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

Uwaga: gdy updateMask zawiera pola powtarzane, cały zestaw powtarzających się wartości jest zastępowany nową zawartością. Jeśli na przykład updateMask zawiera ciąg connections, a pole UpdatePhotoRequest.photo.connections jest puste, wszystkie połączenia zostaną usunięte.

UploadRef

Prześlij referencje dotyczące plików multimedialnych.

Pola
Pole sumy file_source. Wymagane. file_source może mieć tylko jedną z tych wartości:
upload_url

string

Każdy użytkownik musi mieć unikalny plik referencyjny do przesłania. Ma on format „https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"