- Żądanie HTTP
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- PhotoSequence
- GpsSource
- Imu
- Measurement3d
- ProcessingState
- ProcessingFailureReason
- ProcessingFailureDetails
- InsufficientGpsFailureDetails
- GpsDataGapFailureDetails
- ImuDataGapFailureDetails
- NotOutdoorsFailureDetails
- NoOverlapGpsFailureDetails
- LatLngBounds
- InputType
- Wypróbuj
Gdy klient zakończy przesyłanie obiektu PhotoSequence
ze zwróconym przez klienta UploadRef
, photoSequence.create
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 photoSequence.create
zwraca wartość Operation
z identyfikatorem PhotoSequence
określonym w polu Operation.name
.
Ta metoda zwraca następujące kody błędów:
google.rpc.Code.INVALID_ARGUMENT
, jeśli żądanie jest uszkodzone.google.rpc.Code.NOT_FOUND
, jeśli plik referencyjny nie istnieje.
Żądanie HTTP
POST https://streetviewpublish.googleapis.com/v1/photoSequence
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry | |
---|---|
inputType |
To pole jest wymagane. Forma wejściowa |
Treść żądania
Treść żądania zawiera wystąpienie elementu PhotoSequence
.
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Operation
.
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.
PhotoSequence
Sekwencja zdjęć sferycznych wraz z metadanymi.
Zapis JSON |
---|
{ "id": string, "photos": [ { object ( |
Pola | |
---|---|
id |
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[] |
Tylko dane wyjściowe. Zdjęcia z coraz większą liczbą sygnatur czasowych. |
uploadReference |
Tylko dane wejściowe. Wymagany przy tworzeniu sekwencji zdjęć. Nazwa zasobu, do którego przesyłane są bajty sekwencji zdjęć (w formie filmu). |
captureTimeOverride |
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. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
uploadTime |
Tylko dane wyjściowe. Czas utworzenia tej sekwencji zdjęć w usłudze sklepu uSV. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
rawGpsTimeline[] |
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. Za pomocą parametru gpsSource użytkownik może wskazać, który z nich ma pierwszeństwo, jeśli dane nieprzetworzone GPS są udostępniane zarówno w formacie rawGpsTimeline, jak i w CAMM. |
gpsSource |
Tylko dane wejściowe. Jeśli zarówno plik rawGpsTimeline, jak i model CAMM (Aparat Motion Metadata Track) zawierają pomiary GPS, wskaż, która z nich ma pierwszeństwo. |
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ą. |
processingState |
Tylko dane wyjściowe. Stan przetwarzania tej sekwencji. |
failureReason |
Tylko dane wyjściowe. Jeśli sekwencja ma wartość conversionState = FAILED, będzie zawierać przyczynę niepowodzenia. Jeśli parametr conversionState ma wartość jakąkolwiek inną, to pole nie jest aktywne. |
failureDetails |
Tylko dane wyjściowe. Jeśli ta sekwencja ma ustawiony parametr |
distanceMeters |
Tylko dane wyjściowe. Obliczona odległość sekwencji zdjęć w metrach. |
sequenceBounds |
Tylko dane wyjściowe. Prostokątne pole, w którym znajdują się wszystkie obrazy z tej serii zdjęć. |
viewCount |
Tylko dane wyjściowe. Łączna liczba wyświetleń wszystkich zdjęć opublikowanych w tej sekwencji zdjęć. |
filename |
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 rawGpsTimeline 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. |
Imu
Dane IMU z czujników urządzenia.
Zapis JSON |
---|
{ "accelMpsps": [ { object ( |
Pola | |
---|---|
accelMpsps[] |
Pomiary akcelerometru w metrach/s^2 z coraz większą liczbą sygnatur czasowych z urządzeń. |
gyroRps[] |
Pomiary żyroskopu w radianach/s z coraz większą sygnaturą czasową z urządzeń. |
magUt[] |
Pomiary pola magnetycznego przez magnetometr w mikrotesla (uT) z rosnącymi sygnaturami czasowymi z urządzeń. |
Pomiary 3D
Ogólna próbka pomiaru 3D.
Zapis JSON |
---|
{ "captureTime": string, "x": number, "y": number, "z": number } |
Pola | |
---|---|
captureTime |
Sygnatura czasowa pomiaru IMU. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
x |
Pomiar czujnika na osi x. |
y |
Pomiar czujnika na osi Y. |
z |
Pomiar czujnika na osi Z. |
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. |
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. |
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.
Zapis JSON |
---|
{ // Union field |
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: |
|
insufficientGpsDetails |
Zapoznaj się z informacjami o błędach niezadowalających GpsFailureDetails. |
gpsDataGapDetails |
Zobacz szczegóły GpsDataGapFailureDetails. |
imuDataGapDetails |
Zobacz ImuDataGapFailureDetails. |
notOutdoorsDetails |
Zobacz NotOutdoorsFailureDetails. |
noOverlapGpsDetails |
Zobacz NoOverlapGpsFailureDetails. |
InsufficientGpsFailureDetails
Szczegółowe informacje związane z zasadą ProcessingFailureReason#INSUFFICIENT_GPS.
Zapis JSON |
---|
{ "gpsPointsFound": integer } |
Pola | |
---|---|
gpsPointsFound |
Liczba punktów GPS znalezionych w filmie. |
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.
Zapis JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
Pola | |
---|---|
gapDuration |
Czas trwania przerwy w znalezionych danych GPS. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
gapStartTime |
Czas względny (od początku strumienia wideo), w którym rozpoczęła się przerwa. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
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.
Zapis JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
Pola | |
---|---|
gapDuration |
Czas trwania luki w znalezionych danych IMU. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
gapStartTime |
Czas względny (od początku strumienia wideo), w którym rozpoczęła się przerwa. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
NotOutdoorsFailureDetails
Szczegóły dotyczące atrybutu ProcessingFailureReason#NOT_OUTDOORS. Jeśli znaleziono wiele klatek wewnętrznych, w tym miejscu zostanie zarejestrowana pierwsza klatka.
Zapis JSON |
---|
{ "startTime": string } |
Pola | |
---|---|
startTime |
Czas względny (od początku strumienia wideo), w którym znaleziono klatkę wewnątrz. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
NoOverlapGpsFailureDetails
Szczegółowe informacje związane z zasadą PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.
Zapis JSON |
---|
{ "gpsStartTime": string, "gpsEndTime": string, "videoStartTime": string, "videoEndTime": string } |
Pola | |
---|---|
gpsStartTime |
Godzina pierwszego zarejestrowania punktu GPS. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
gpsEndTime |
Czas ostatniego zapisu punktu GPS. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
videoStartTime |
Czas rozpoczęcia filmu. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
videoEndTime |
Czas zakończenia filmu. Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
LatLngBounds
Prostokąt we współrzędnych geograficznych.
Zapis JSON |
---|
{ "southwest": { object ( |
Pola | |
---|---|
southwest |
Południowo-zachodni róg tych granic. |
northeast |
Północno-wschodni róg tych granic. |
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 |