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ę elementu Photos wraz z jego metadanymi.

Pamiętaj, że jeśli BatchDeletePhotos nie powiedzie się, oznacza to, że brakuje kluczowych pól lub wystąpił błąd uwierzytelniania. Nawet jeśli BatchDeletePhotos powiedzie się, poszczególne zdjęcia w serii mogą zawierać błędy. Te błędy są wymienione w każdym elemencie PhotoResponse.status w BatchDeletePhotosResponse.results. Na stronie DeletePhoto znajdziesz listę konkretnych błędów, 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.

Pamiętaj, że jeśli BatchGetPhotos nie powiedzie się, oznacza to, że brakuje kluczowych pól lub wystąpił błąd uwierzytelniania. Nawet jeśli BatchGetPhotos powiedzie się, poszczególne zdjęcia w serii mogą zawierać błędy. Te błędy są wymienione w każdym elemencie PhotoResponse.status w BatchGetPhotosResponse.results. Na stronie GetPhoto znajdziesz listę konkretnych błędów, 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 obiektu Photos, np. pozycję, powiązanie miejsca, połączenia itp. Zmienianie pikseli zdjęć nie jest obsługiwane.

Pamiętaj, że jeśli BatchUpdatePhotos nie powiedzie się, oznacza to, że brakuje kluczowych pól lub wystąpił błąd uwierzytelniania. Nawet jeśli BatchUpdatePhotos powiedzie się, poszczególne zdjęcia w serii mogą zawierać błędy. Te błędy są wymienione w każdym elemencie PhotoResponse.status w BatchUpdatePhotosResponse.results. Na stronie UpdatePhoto znajdziesz listę konkretnych błędów, które mogą wystąpić w przypadku poszczególnych zdjęć.

Użyte są tylko pola określone w polu updateMask. Jeśli pole updateMask nie jest podane, aktualizacja zostanie zastosowana do wszystkich pól.

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

Uwaga: aby zaktualizować pole Pose.altitude, musisz też wypełnić pole Pose.latLngPair. W przeciwnym razie prośba nie zostanie zrealizowana.

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 modelem UploadRef, CreatePhoto publikuje przesłane Photo do Street View w Mapach Google.

Obecnie jedynym sposobem na ustawienie nagłówka, tonacji i obrót w CreatePhoto jest użycie metadanych Photo Sphere XMP znajdujących się w bajtach zdjęcia. CreatePhoto ignoruje pola pose.heading, pose.pitch, pose.roll, pose.altitude i pose.level w pozycji.

Ta metoda zwraca następujące 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 obiektu PhotoSequence ze zwróconym przez klienta UploadRef, CreatePhotoSequence wyodrębnia sekwencję zdjęć sferycznych z filmu lub metadanych urządzenia Extensible Device Metadata (XDM, http://www.xdm.org/), aby opublikować je w Street View w Mapach Google.

Funkcja CreatePhotoSequence zwraca wartość Operation z identyfikatorem PhotoSequence określonym w polu Operation.name.

Ta metoda zwraca następujące 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 element Photo i jego metadane.

Ta metoda zwraca następujące 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 element PhotoSequence i jego metadane.

Ta metoda zwraca następujące 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 następujące 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 o określonym elemencie PhotoSequence przez interfejs Operation.

Ta metoda zwraca te 3 typy odpowiedzi:

  • Operation.done = fałsz, jeśli przetwarzanie danych PhotoSequence nie zostało jeszcze zakończone.
  • Jeśli podczas przetwarzania wystąpił błąd, pole Operation.done zawiera wartość Operation.error.
  • Operation.done = prawda, a Operation.response jest wypełniane z komunikatem PhotoSequence.

Ta metoda zwraca następujące 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)

Wyświetla wszystkie elementy PhotoSequences należące do użytkownika w kolejności malejącej według sygnatury czasowej 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)

Wyświetla listę wszystkich elementów Photos należących do użytkownika.

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

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 zwróconego pliku UploadRef jest używany do przesyłania danych funkcji photoSequence.

Po zakończeniu przesyłania element UploadRef jest używany w połączeniu z protokołem 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 korzysta z adresu URL przesyłania zwróconego UploadRef do przesyłania bajtów obiektu Photo.

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

Po zakończeniu przesyłania metoda używa elementu UploadRef z atrybutem 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 obiektu Photo, np. pozycję, powiązanie miejsca, połączenia itp. Zmienianie pikseli zdjęcia nie jest obsługiwane.

Użyte są tylko pola określone w polu updateMask. Jeśli pole updateMask nie jest podane, aktualizacja zostanie zastosowana do wszystkich pól.

Ta metoda zwraca następujące 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

To pole jest wymagane. Identyfikatory zasobów Photos. Żądania HTTP GET dla parametru zapytania adresu URL wymagają takiej składni: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

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

Pola
status[]

Status

Stan operacji usunięcia pojedynczego obiektu Photo z żądania zbiorczego.

BatchGetPhotosRequest

Poproś o co najmniej 1 Photos. Domyślnie

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

Parametry:

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

string

To pole jest wymagane. Identyfikatory zasobów Photos. W przypadku żądań HTTP GET parametr zapytania w adresie URL powinien mieć wartość photoIds=<id1>&photoIds=<id2>&....
view

PhotoView

To pole jest wymagane. Określa, czy w odpowiedzi zdjęcia ma być zwracany adres URL pobierania bajtów zdjęcia.
language_code

string

Opcjonalnie. Kod języka BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jeśli wartość parametru language_code nie została określona, używane są ustawienia języka użytkownika w usługach Google.

BatchGetPhotosResponse

Odpowiedź na zbiorcze pobieranie pliku Photos.

Pola
results[]

PhotoResponse

Lista wyników dla każdego żądanego elementu (Photo) w tej samej kolejności co żądania w grupie BatchGetPhotos.

BatchUpdatePhotosRequest

Prośba o zaktualizowanie metadanych zdjęć. Aktualizowanie pikseli zdjęć nie jest obsługiwane.

Pola
update_photo_requests[]

UpdatePhotoRequest

To pole jest wymagane. Lista wartości UpdatePhotoRequests.

BatchUpdatePhotosResponse

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

Pola
results[]

PhotoResponse

Lista wyników dla każdego użytkownika Photo została zaktualizowana w tej samej kolejności co żądanie.

Połączenie

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

Pola
target

PhotoId

To pole jest wymagane. Miejsce docelowe połączenia między zdjęciem zawierającym a innym zdjęciem.

CreatePhotoRequest

Prośba o utworzenie Photo.

Pola
photo

Photo

To pole jest wymagane. Zdjęcie do utworzenia.

CreatePhotoSequenceRequest

Prośba o utworzenie PhotoSequence z filmu.

Pola
photo_sequence

PhotoSequence

To pole jest wymagane. PhotoSequence, aby utworzyć.
input_type

InputType

To pole jest wymagane. Forma wejściowa PhotoSequence.

InputType

Formy wprowadzania tekstu 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

To pole jest wymagane. Identyfikator zasobu Photo.

DeletePhotoSequenceRequest

Prośba o usunięcie elementu (PhotoSequence).

Pola
sequence_id

string

To pole jest wymagane. Identyfikator zasobu PhotoSequence.

GetPhotoRequest

Poproś o Photo.

Domyślnie

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

Parametry:

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

string

To pole jest wymagane. Identyfikator zasobu Photo.
view

PhotoView

To pole jest wymagane. Określa, czy w odpowiedzi Photo ma być zwracany adres URL pobierania bajtów zdjęcia.
language_code

string

Kod języka BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jeśli wartość parametru language_code nie została określona, używane są ustawienia języka użytkownika w usługach Google.

GetPhotoSequenceRequest

Poproś o PhotoSequence.

Domyślnie

Parametry:

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

string

To pole jest wymagane. Identyfikator sekwencji zdjęć.
view
(deprecated)

PhotoView

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

Uwaga: obecnie nie zaimplementowano.
filter

string

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

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

GpsDataGapFailureDetails

Szczegóły związane z atrybutem ProcessingFailureReason#GPS_DATA_GAP. Jeśli występuje wiele luk w danych GPS, w raporcie uwzględniany jest tylko ten o najdłuższym czasie trwania.

Pola
gap_duration

Duration

Czas trwania przerwy w znalezionych danych GPS.
gap_start_time

Duration

Czas względny (od początku strumienia wideo), w którym rozpoczęła się przerwa.

Imu

Dane IMU z czujników urządzenia.

Pola
accel_mpsps[]

Measurement3d

Pomiary akcelerometru w metrach/s^2 z coraz większą liczbą sygnatur czasowych z urządzeń.
gyro_rps[]

Measurement3d

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

Measurement3d

Pomiary pola magnetycznego przez magnetometr w mikrotesla (uT) z rosnącymi sygnaturami czasowymi z urządzeń.

Pomiary 3D

Ogólna próbka pomiaru 3D.

Pola
capture_time

Timestamp

Sygnatura czasowa pomiaru IMU.
x

float

Pomiar czujnika na osi x.
y

float

Pomiar czujnika na osi Y.
z

float

Pomiar czujnika na osi Z.

ImuDataGapFailureDetails

Szczegóły związane z atrybutem ProcessingFailureReason#IMU_DATA_GAP. Jeśli występuje wiele luk w danych IMU, w tym miejscu raportowany jest tylko ten o najdłuższym czasie trwania.

Pola
gap_duration

Duration

Czas trwania luki w znalezionych danych IMU.
gap_start_time

Duration

Czas względny (od początku strumienia wideo), w którym rozpoczęła się przerwa.

InsufficientGpsFailureDetails

Szczegółowe informacje związane z zasadą 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 odpowiadającą mu nazwę.

Pola
number

double

Opcjonalnie. Numer piętra używany do składania zamówień. 0 oznacza poziom gruntu, 1 wskazuje pierwszy poziom nad ziemią, -1 wskazuje pierwszy poziom pod ziemią. Wartości inne niż całkowite są prawidłowe.
name

string

To pole jest wymagane. Nazwa przypisana do tego poziomu. Może mieć maksymalnie 3 znaki. Zastanów się, jak przyciski windy zostałyby oznaczone na tym poziomie, gdyby była tam winda.

ListPhotoSequencesRequest

Żądanie wyświetlenia wszystkich sekwencji zdjęć należących do użytkownika wysyłającego żądanie.

Parametry:

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

int32

Opcjonalnie. Maksymalna liczba sekwencji zdjęć do zwrócenia. pageSize nie może być liczbą ujemną. Jeśli pageSize ma wartość zero lub nie zostanie podany, używany jest domyślny rozmiar strony, czyli 100. Liczba sekwencji zdjęć zwróconych w odpowiedzi może być mniejsza niż pageSize, jeśli liczba dopasowań jest mniejsza niż pageSize. Ta funkcja nie jest obecnie zaimplementowana, ale jest w trakcie przetwarzania.
page_token

string

Opcjonalnie. Wartość nextPageToken zwrócona z poprzedniego żądania ListPhotoSequences (jeśli miała 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 oraz `max_capture_time_seconds. Więcej informacji znajdziesz na stronie https://google.aip.dev/160. Zapytania dotyczące nazw plików należy wysyłać jako wyrażenie, aby można było obsługiwać wiele słów i znaków specjalnych po dodaniu cudzysłowu ze znakiem zmiany znaczenia. Przykład: filename_query="przykład wyrażenia.mp4"

ListPhotoSequencesResponse

Odpowiedź na listę wszystkich sekwencji zdjęć należących do użytkownika.

Pola
photo_sequences[]

Operation

Lista sekwencji zdjęć w interfejsie Operation.

Maksymalna liczba zwracanych elementów zależy od pola pageSize w żądaniu.

Każda pozycja na liście może mieć jeden z 3 stanów:

  • Operation.done = fałsz, jeśli przetwarzanie danych PhotoSequence nie zostało jeszcze zakończone.
  • Jeśli podczas przetwarzania wystąpił błąd, pole Operation.done zawiera wartość Operation.error.
  • Operation.done = prawda, Operation.response zawiera komunikat PhotoSequence. W każdej sekwencji wypełnione jest tylko pole Id.
next_page_token

string

Token do pobrania następnej strony wyników lub pusty, jeśli na liście nie ma więcej wyników.

ListPhotosRequest

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

Domyślnie

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

Parametry:

  • view określa, czy adres URL pobierania bajtów zdjęcia ma być zwracany.
  • pageSize określa maksymalną liczbę zdjęć do zwrócenia.
  • pageToken to wartość tokena następnej strony zwrócona w odpowiedzi na poprzednie żądanie ListPhotos (jeśli miało miejsce).
  • filter umożliwia filtrowanie według danego parametru. „placeId” to obecnie jedyny obsługiwany parametr.
Pola
view

PhotoView

To pole jest wymagane. Określa, czy w odpowiedzi ze Zdjęć ma być zwracany adres URL pobierania bajtów zdjęć.
page_size

int32

Opcjonalnie. Maksymalna liczba zdjęć do zwrócenia. pageSize nie może być liczbą ujemną. Jeśli pageSize ma wartość zero lub nie zostanie podany, używany jest domyślny rozmiar strony, czyli 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ła miejsce).
filter

string

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

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

string

Opcjonalnie. Kod języka BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jeśli wartość parametru language_code nie została określona, używane są ustawienia języka użytkownika w usługach Google.

ListPhotosResponse

Odpowiedź na listę 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 do pobrania następnej strony wyników lub pusty, jeśli na liście nie ma więcej wyników.

NoOverlapGpsFailureDetails

Szczegółowe informacje związane z zasadą PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.

Pola
gps_start_time

Timestamp

Godzina pierwszego zarejestrowania punktu GPS.
gps_end_time

Timestamp

Czas ostatniego zapisu punktu GPS.
video_start_time

Timestamp

Czas rozpoczęcia filmu.
video_end_time

Timestamp

Czas zakończenia filmu.

NotOutdoorsFailureDetails

Szczegóły dotyczące atrybutu ProcessingFailureReason#NOT_OUTDOORS. Jeśli znaleziono wiele klatek wewnętrznych, w tym miejscu zostanie zarejestrowana pierwsza klatka.

Pola
start_time

Duration

Czas względny (od początku strumienia wideo), w którym znaleziono klatkę wewnątrz.

Zdjęcie

Zdjęcie jest używane do przechowywania zdjęć sferycznych i metadanych zdjęć.

Pola
photo_id

PhotoId

To pole jest wymagane. Tylko dane wyjściowe. Wymagane podczas aktualizowania zdjęcia. Wyniki tylko podczas tworzenia zdjęcia. Identyfikator zdjęcia, który jest unikalny wśród wszystkich zdjęć w Google.
upload_reference

UploadRef

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

string

Tylko dane wyjściowe. Adres URL pobierania bajtów zdjęcia. 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 reprezentuje link z tego zdjęcia do innego zdjęcia.
capture_time

Timestamp

Opcjonalnie. Całkowity czas wykonania zdjęcia. Jeśli zdjęcie nie ma sygnatury czasowej EXIF, ta opcja 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. Stan w Mapach Google (niezależnie od tego, czy zdjęcie zostało opublikowane czy odrzucone).

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 zostanie opublikowane w Mapach Google.
REJECTED_UNKNOWN Zdjęcie zostało odrzucone z nieznanego powodu.

TransferStatus

Stan przeniesienia praw.

Wartości w polu enum
TRANSFER_STATUS_UNKNOWN Stan tego przeniesienia jest nieokreślony.
NEVER_TRANSFERRED To zdjęcie nigdy nie było przenoszone.
PENDING Przenoszenie zdjęć zostało rozpoczęte, ale odbiorca jeszcze nie odpowiedział.
COMPLETED Zdjęcia zostały przeniesione i przekazano je do odbiorcy.
REJECTED Odbiorca odrzucił prośbę o przeniesienie zdjęcia.
EXPIRED Przenoszenie zdjęć wygasło, zanim odbiorca wykonał jakiekolwiek działanie.
CANCELLED Nadawca anulował to przeniesienie zdjęć.
RECEIVED_VIA_TRANSFER Odbiorca jest właścicielem zdjęcia z powodu przeniesienia 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 wykonane.

PhotoSequence

Sekwencja zdjęć sferycznych wraz z metadanymi.

Pola
id

string

Tylko dane wyjściowe. Unikalny identyfikator sekwencji zdjęć. Jest to też identyfikator długo trwającej operacji, jeśli przesyłanie odbywa się asynchronicznie.
photos[]

Photo

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

UploadRef

Tylko dane wejściowe. Wymagany 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 zaczyna się nagrywanie sekwencji zdjęć. Jeśli sekwencja zdjęć to film, jest to czas rozpoczęcia filmu. Jeśli to pole jest wypełnione danymi wejściowymi, zastępuje ono czas przechwytywania w filmie lub pliku XDM.
upload_time

Timestamp

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

Pose

Tylko dane wejściowe. Nieprzetworzone dane GPS z rosnącymi sygnaturami czasowymi z urządzenia, które nie są synchronizowane z każdym zdjęciem. Te nieprzetworzone dane posłużą do ustalenia pozycji każdej klatki. Wymagane, gdy wartość wejściowa ma wartość VIDEO, a pomiary nieprzetworzone GPS nie mają wartości CAMM do śledzenia metadanych ruchu w aparacie. Użytkownik może wskazać, który z nich ma pierwszeństwo, używając parametru gps_source, jeśli nieprzetworzone pomiary GPS są dostarczane zarówno w formacie raw_gps_timeline, jak i w CAMM.
gps_source

GpsSource

Tylko dane wejściowe. Jeśli zarówno parametr raw_gps_timeline, jak i ścieżka CAMM (Aparat Motion Metadata Track) zawierają pomiary GPS, wskaż, która z nich ma pierwszeństwo.
imu

Imu

Tylko dane wejściowe. 3-osiowe dane IMU do zbierania danych. Jeśli dane są za duże, aby je umieścić w żądaniu, uwzględnij je w ścieżce CAMM 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 sekwencja ma wartość „process_state” = BŁĄD, będzie zawierać przyczynę niepowodzenia. Jeśli parametr „process_state” [stan_przetwarzania] ma dowolną wartość, to pole nie jest skonfigurowane.
failure_details

ProcessingFailureDetails

Tylko dane wyjściowe. Jeśli ta sekwencja ma ustawiony parametr failure_reason, może 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, w którym znajdują się wszystkie obrazy z tej serii zdjęć.
view_count

int64

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

string

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

GpsSource

Główne ź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 ruchu w kamerze (CAMM) ma pierwszeństwo, jeśli istnieje.

PhotoView

Określa, który widok elementu Photo ma być uwzględniany 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 bajtów zdjęcia.

Miejsce

Umieść metadane elementu.

Pola
place_id

string

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

string

Tylko dane wyjściowe. Nazwa miejsca zlokalizowana na język language_code.
language_code

string

Tylko dane wyjściowe. Wartość language_code, za pomocą której jest zlokalizowana nazwa. Powinien to być kod języka (language_code) określony w żądaniu, ale może to być wartość zastępcza.

Pozycja

Pomiar nieprzetworzonej pozycji w przypadku jednostki.

Pola
lat_lng_pair

LatLng

Para szerokości i długości geograficznej pozycji, zgodnie z opisem tutaj: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Jeśli podczas tworzenia obiektu Photo nie podano pary szerokości i długości geograficznej, używana jest geolokalizacja z nagłówka EXIF. Brak szerokości i długości geograficznej w nagłówku zdjęcia lub pliku EXIF powoduje błąd przetwarzania zdjęcia.
altitude

double

Wysokość położenia w metrach powyżej elipsoidy WGS84. NaN wskazuje ilość niezmierzoną.
heading

double

Podane niżej parametry ułożenia odnoszą się do środka zdjęcia. Pasują do https://developers.google.com/streetview/spherical-metadata. Kierunek kompasu mierzony w środku zdjęcia w stopniach w prawo od północy. Wartość musi mieścić się w zakresie od 0 do 360. NaN wskazuje ilość niezmierzoną.
pitch

double

Ton, mierzony w środkowej części zdjęcia w stopniach. Wartość musi mieścić się w zakresie od >=-90 do <= 90. Wartość -90 oznacza spojrzenie bezpośrednio w dół, a wartość 90 oznacza patrzenie bezpośrednio w górę. NaN wskazuje ilość niezmierzoną.
roll

double

Obrót, mierzony w stopniach. Wartość musi mieścić się w zakresie od 0 do 360. Wartość 0 oznacza poziom z horyzontem. NaN wskazuje ilość niezmierzoną.
gps_record_timestamp_unix_epoch

Timestamp

Czas zapisu GPS od początku epoki UTC.
level

Level

Poziom (piętro w budynku) służący do konfiguracji nawigacji pionowej.
accuracy_meters

float

Szacowana dokładność pozioma tej pozycji w metrach z 68-procentową pewnością (jedno odchylenie standardowe). Na przykład na Androidzie ta wartość jest dostępna przy użyciu metody https://developer.android.com/reference/android/location/Location#getAccuracy(). Inne platformy mają inne metody uzyskiwania podobnych szacunków dokładności.

ProcessingFailureDetails

Dodatkowe informacje dołączone do wyliczenia ProcessingFailureReason. Ten komunikat powinien być zawsze używany razem z zasadą ProcessingFailureReason, a wartość „oneof” ustawiona w tym komunikacie powinna być zgodna z zasadą FailureReason.

Pola
Pole sumy details. Zostanie ustawiony tylko 1 zestaw szczegółów, który musi być zgodny z odpowiednią wartością wyliczeniową w ProcessingFailureReason. details może mieć tylko jedną z tych wartości:
insufficient_gps_details

InsufficientGpsFailureDetails

Zapoznaj się z informacjami o błędach niezadowalających GpsFailureDetails.
gps_data_gap_details

GpsDataGapFailureDetails

Zobacz szczegóły 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 podana. Jest to wartość domyślna.
LOW_RESOLUTION Rozdzielczość ramki wideo jest za mała.
DUPLICATE Ten film został już przesłany.
INSUFFICIENT_GPS Za mało punktów GPS.
NO_OVERLAP_GPS Zakres dat ścieżki GPS i ramek filmu nie mogą się pokrywać.
INVALID_GPS GPS jest nieprawidłowy (np. wszystkie punkty GPS znajdują się w miejscu (0,0))
FAILED_TO_REFINE_POSITIONS Nie udało się precyzyjnie ustalić położenia serii zdjęć.
TAKEDOWN Sekwencja została usunięta ze względu na zasady.
CORRUPT_VIDEO Plik wideo jest uszkodzony lub nie można go zdekodować.
INTERNAL W systemie bazowym wystąpiła trwała awaria.
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ą przerwę o długości przekraczającej 5 sekund.
JUMPY_GPS Dane GPS są zbyt nieregularne, aby można je było przetworzyć.
INVALID_IMU Dane IMU (akcelerometr, żyroskop itp.) są nieprawidłowe. Mogą one nie zawierać wymaganych pól (x, y, z lub time), być nieprawidłowo sformatowane albo mieć inny problem, który uniemożliwia naszym systemom przeanalizowanie tych informacji.
INSUFFICIENT_IMU Za mało punktów IMU.
INSUFFICIENT_OVERLAP_TIME_SERIES Niewystarczające nakładanie się w przedziale czasu między GPS, IMU i innymi danymi ciągów czasowych.
IMU_DATA_GAP Dane z jednostki IMU (akcelerometr, żyroskop itp.) zawierają przerwy dłuższe niż 0, 1 sekundy.
UNSUPPORTED_CAMERA Aparat nie jest obsługiwany.
NOT_OUTDOORS Niektóre ramki były umieszczone wewnątrz budynku, co nie jest obsługiwane.
INSUFFICIENT_VIDEO_FRAMES Za mało klatek wideo.
INSUFFICIENT_MOVEMENT Za mało danych do przeniesienia.

ProcessingState

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

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

Sekwencja może przejść do pozycji FAILED z dowolnego stanu. Poza tym przetworzona sekwencja może w każdej chwili zostać przetworzona ponownie.

Wartości w polu enum
PROCESSING_STATE_UNSPECIFIED Stan nie jest określony. Jest to wartość domyślna.
PENDING Przetwarzanie sekwencji nie zostało jeszcze rozpoczęte.
PROCESSING Sekwencja jest obecnie przetwarzana.
PROCESSED Zakończono przetwarzanie sekwencji, w tym zawężenie pozycji.
FAILED Nie udało się przetworzyć sekwencji. Więcej informacji znajdziesz w sekcji FailureReason.

UpdatePhotoRequest

Prośba o zaktualizowanie metadanych elementu Photo. Aktualizowanie pikseli zdjęcia nie jest obsługiwane.

Pola
photo

Photo

To pole jest wymagane. Obiekt Photo zawierający nowe metadane.
update_mask

FieldMask

To pole jest wymagane. Maska identyfikująca pola w metadanych zdjęcia, które mają zostać zaktualizowane. Jeśli ich nie ma, stare metadane Photo zostaną w tym żądaniu całkowicie zastąpione nowymi metadanymi Photo. Aktualizacja nie powiedzie się, jeśli podasz nieprawidłowe pola. Możesz podać wiele pól za pomocą listy rozdzielanej przecinkami.

Te pola są prawidłowe:

  • 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 zostanie zastąpiony nową treścią. Jeśli np. updateMask zawiera connections, a pole UpdatePhotoRequest.photo.connections jest puste, wszystkie połączenia zostaną usunięte.

UploadRef

Prześlij dokumentację dotyczącą plików multimedialnych.

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

string

Każdy użytkownik powinien mieć niepowtarzalny plik referencyjny. Ma on taki format: „https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}”