Package google.streetview.publish.v1

Indice

StreetViewPublishService

Pubblica e collega le foto aggiunte dagli utenti su Street View.

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Consente di eliminare un elenco di Photos e i relativi metadati.

Tieni presente che se BatchDeletePhotos non riesce, mancano campi critici o si è verificato un errore di autenticazione. Anche se l'operazione BatchDeletePhotos va a buon fine, è possibile che le singole foto del batch presentino errori. Questi errori sono specificati in ogni PhotoResponse.status in BatchDeletePhotosResponse.results. Consulta DeletePhoto per gli errori specifici che possono verificarsi per ciascuna foto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

Restituisce i metadati del batch Photo specificato.

Tieni presente che se BatchGetPhotos non riesce, mancano campi critici o si è verificato un errore di autenticazione. Anche se l'operazione BatchGetPhotos va a buon fine, è possibile che le singole foto del batch presentino errori. Questi errori sono specificati in ogni PhotoResponse.status in BatchGetPhotosResponse.results. Consulta GetPhoto per gli errori specifici che possono verificarsi per ciascuna foto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

Aggiorna i metadati di Photos, ad esempio posa, associazione del luogo, connessioni e così via. La modifica dei pixel delle foto non è supportata.

Tieni presente che se BatchUpdatePhotos non riesce, mancano campi critici o si è verificato un errore di autenticazione. Anche se l'operazione BatchUpdatePhotos va a buon fine, è possibile che le singole foto del batch presentino errori. Questi errori sono specificati in ogni PhotoResponse.status in BatchUpdatePhotosResponse.results. Consulta UpdatePhoto per gli errori specifici che possono verificarsi per ciascuna foto.

Vengono utilizzati solo i campi specificati nel campo updateMask. Se updateMask non è presente, l'aggiornamento si applica a tutti i campi.

Il numero di messaggi UpdatePhotoRequest in un BatchUpdatePhotosRequest non deve essere maggiore di 20.

Nota: per aggiornare Pose.altitude, è necessario compilare anche Pose.latLngPair. In caso contrario, la richiesta non andrà a buon fine.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

Dopo che il cliente ha terminato di caricare la foto con l'oggetto UploadRef restituito, CreatePhoto pubblica su Street View la Photo caricata su Google Maps.

Al momento, l'unico modo per impostare intestazione, proposta musicale e lancio in CreatePhoto è tramite i metadati XMP di foto sferiche nei byte della foto. CreateFoto ignora i campi pose.heading, pose.pitch, pose.roll, pose.altitude e pose.level in Posa.

Questo metodo restituisce i seguenti codici di errore:

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

Dopo che il cliente ha terminato di caricare l'oggetto PhotoSequence con il valore UploadRef restituito, CreatePhotoSequence estrae una sequenza di foto sferiche da un video o dai metadati estensibili del dispositivo (XDM, http://www.xdm.org/) da pubblicare su Street View su Google Maps.

CreatePhotoSequence restituisce un valore Operation, con l'ID PhotoSequence impostato nel campo Operation.name.

Questo metodo restituisce i seguenti codici di errore:

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

Elimina un elemento Photo e i relativi metadati.

Questo metodo restituisce i seguenti codici di errore:

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

Elimina un elemento PhotoSequence e i relativi metadati.

Questo metodo restituisce i seguenti codici di errore:

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

Restituisce i metadati dell'elemento Photo specificato.

Questo metodo restituisce i seguenti codici di errore:

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

Recupera i metadati dell'elemento PhotoSequence specificato tramite l'interfaccia Operation.

Questo metodo restituisce i seguenti tre tipi di risposte:

  • Operation.done = false, se l'elaborazione di PhotoSequence non è ancora terminata.
  • Operation.done = true e il valore Operation.error è compilato, in caso di errore durante l'elaborazione.
  • Operation.done = true e il valore Operation.response è inserito in un modulo, che contiene un messaggio PhotoSequence.

Questo metodo restituisce i seguenti codici di errore:

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

Elenca tutti i PhotoSequences che appartengono all'utente, in ordine decrescente del timestamp CreatePhotoSequence.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

Elenca tutti i Photos che appartengono all'utente.

Nota: le foto create di recente che sono ancora in fase di indicizzazione non vengono restituite nella risposta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

Crea una sessione di caricamento per iniziare a caricare i dati delle sequenze di foto. L'URL di caricamento dell'oggetto UploadRef restituito viene utilizzato per caricare i dati per photoSequence.

Al termine del caricamento, UploadRef viene utilizzato con CreatePhotoSequence per creare la voce dell'oggetto PhotoSequence.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
StartUpload

rpc StartUpload(Empty) returns (UploadRef)

Crea una sessione di caricamento per iniziare a caricare foto byte. Il metodo utilizza l'URL di caricamento dell'oggetto UploadRef restituito per caricare i byte per Photo.

Oltre ai requisiti indicati alla pagina https://support.google.com/maps/answer/7012050?ref_topic=6275604, la foto deve soddisfare anche i seguenti requisiti:

Al termine del caricamento, il metodo utilizza UploadRef con CreatePhoto per creare la voce dell'oggetto Photo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

Aggiorna i metadati di un Photo, ad esempio posa, associazione del luogo, connessioni e così via. La modifica dei pixel di una foto non è supportata.

Vengono utilizzati solo i campi specificati nel campo updateMask. Se updateMask non è presente, l'aggiornamento si applica a tutti i campi.

Questo metodo restituisce i seguenti codici di errore:

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

BatchDeletePhotosRequest

Richiedi l'eliminazione di più elementi Photos.

Campi
photo_ids[]

string

Obbligatorio. ID di Photos. Le richieste HTTP GET richiedono la seguente sintassi per il parametro di query dell'URL: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

Risposta all'eliminazione in gruppo di uno o più Photos.

Campi
status[]

Status

Lo stato dell'operazione per eliminare un singolo Photo nella richiesta batch.

BatchGetPhotosRequest

Richiedi uno o più Photos. Per impostazione predefinita

  • non restituisce l'URL di download per i byte della foto.

Parametri:

  • view consente di stabilire se restituire o meno l'URL di download per i byte della foto.
Campi
photo_ids[]

string

Obbligatorio. ID di Photos. Per le richieste HTTP GET, il parametro di query dell'URL deve essere photoIds=<id1>&photoIds=<id2>&....
view

PhotoView

Obbligatorio. Specifica se un URL di download per i byte della foto deve essere restituito nella risposta della foto.
language_code

string

(Facoltativo) Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se language_code non è specificato, viene utilizzata la preferenza della lingua dell'utente per i servizi Google.

BatchGetPhotosResponse

Risposta al recupero collettivo di Photos.

Campi
results[]

PhotoResponse

Elenco di risultati per ogni singola richiesta di Photo richiesta, nello stesso ordine delle richieste in BatchGetPhotos.

BatchUpdatePhotosRequest

Richiedi l'aggiornamento dei metadati delle foto. L'aggiornamento dei pixel delle foto non è supportato.

Campi
update_photo_requests[]

UpdatePhotoRequest

Obbligatorio. Elenco di UpdatePhotoRequests.

BatchUpdatePhotosResponse

Risposta all'aggiornamento collettivo dei metadati di uno o più Photos.

Campi
results[]

PhotoResponse

Elenco di risultati per ogni singolo Photo aggiornato, nello stesso ordine della richiesta.

Connessione

Una connessione è il collegamento da una foto di origine a una foto di destinazione.

Campi
target

PhotoId

Obbligatorio. La destinazione del collegamento dalla foto che la contiene a un'altra foto.

CreatePhotoRequest

Richiedi la creazione di un Photo.

Campi
photo

Photo

Obbligatorio. Foto da creare.

CreatePhotoSequenceRequest

Richiedi la creazione di un PhotoSequence da un video.

Campi
photo_sequence

PhotoSequence

Obbligatorio. PhotoSequence per creare.
input_type

InputType

Obbligatorio. Il formato di input di PhotoSequence.

InputType

Forme di input di PhotoSequence.

Enum
INPUT_TYPE_UNSPECIFIED Non specificato. Il server restituirà google.rpc.Code.INVALID_ARGUMENT.
VIDEO Video a 360°.
XDM Extensible Device Metadata, http://www.xdm.org

DeletePhotoRequest

Richiedi l'eliminazione di un Photo.

Campi
photo_id

string

Obbligatorio. ID di Photo.

DeletePhotoSequenceRequest

Richiedi l'eliminazione di un PhotoSequence.

Campi
sequence_id

string

Obbligatorio. ID di PhotoSequence.

GetPhotoRequest

Richiedi un Photo.

Per impostazione predefinita

  • non restituisce l'URL di download per i byte della foto.

Parametri:

  • view consente di stabilire se restituire o meno l'URL di download per i byte della foto.
Campi
photo_id

string

Obbligatorio. ID di Photo.
view

PhotoView

Obbligatorio. Specifica se nella risposta Photo deve essere restituito un URL di download per i byte della foto.
language_code

string

Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se language_code non è specificato, viene utilizzata la preferenza della lingua dell'utente per i servizi Google.

GetPhotoSequenceRequest

Richiedi un PhotoSequence.

Per impostazione predefinita

Parametri:

  • view consente di stabilire se restituire l'URL di download per PhotoSequence.
Campi
sequence_id

string

Obbligatorio. ID della sequenza di foto.
view
(deprecated)

PhotoView

Specifica se un URL di download per la sequenza di foto deve essere restituito in download_url delle singole foto nella risposta PhotoSequence.

Nota: attualmente non implementata.
filter

string

(Facoltativo) L'espressione di filtro. Ad esempio: published_status=PUBLISHED.

I filtri supportati sono: published_status. Per ulteriori informazioni, visita la pagina https://google.aip.dev/160.

GpsDataGapFailureDetails

Dettagli relativi a ProcessingFailureReason#GPS_DATA_GAP. Se sono presenti più lacune nei dati GPS, qui viene riportata solo quella con la durata maggiore.

Campi
gap_duration

Duration

La durata della lacuna nei dati GPS trovati.
gap_start_time

Duration

Tempo relativo (dall'inizio dello stream video) in cui è iniziato il divario.

Imu

Dati IMU provenienti dai sensori del dispositivo.

Campi
accel_mpsps[]

Measurement3d

L'accelerometro effettua le misurazioni in metri/sec^2 con timestamp crescenti dai dispositivi.
gyro_rps[]

Measurement3d

Il giroscopio esegue le misurazioni in radianti al secondo con timestamp crescenti dai dispositivi.
mag_ut[]

Measurement3d

Il magnetometro misura il campo magnetico in microtesla (uT) con timestamp crescenti provenienti dai dispositivi.

Misurazione3d

Un campione di misurazione 3D generico.

Campi
capture_time

Timestamp

Il timestamp della misurazione IMU.
x

float

La misurazione del sensore sull'asse x.
y

float

La misurazione del sensore sull'asse y.
z

float

La misurazione del sensore sull'asse z.

ImuDataGapFailureDetails

Dettagli relativi a ProcessingFailureReason#IMU_DATA_GAP. Se sono presenti più lacune nei dati dell'IMU, viene riportata solo quella con la durata maggiore.

Campi
gap_duration

Duration

La durata del gap nei dati IMU rilevati.
gap_start_time

Duration

Tempo relativo (dall'inizio dello stream video) in cui è iniziato il divario.

InsufficientGpsFailureDetails

Dettagli relativi a ProcessingFailureReason#INSUFFICIENT_GPS.

Campi
gps_points_found

int32

Il numero di punti GPS trovati nel video.

LatLngBounds

Un rettangolo con coordinate geografiche.

Campi
southwest

LatLng

L'angolo a sud-ovest di questi confini.
northeast

LatLng

L'angolo a nord-est di questi confini.

Livello

Informazioni sul livello contenenti il numero e il nome corrispondente.

Campi
number

double

(Facoltativo) Numero di piano, utilizzato per gli ordini. 0 indica il livello del suolo, 1 indica il primo livello sopra il livello del suolo, -1 indica il primo livello sotto il livello del suolo. È possibile utilizzare valori non interi.
name

string

Obbligatorio. Un nome assegnato a questo livello, limitato a 3 caratteri. Considera come verrebbero etichettati i pulsanti dell'ascensore se ci fosse un ascensore.

ListPhotoSequencesRequest

Richiesta di elencare tutte le sequenze di foto appartenenti all'utente che invia la richiesta.

Parametri:

  • pageSize determina il numero massimo di sequenze di foto da restituire.
  • pageToken è il valore del token di pagina successivo restituito da una precedente richiesta ListPhotoSequences, se presente.
Campi
page_size

int32

(Facoltativo) Il numero massimo di sequenze di foto da restituire. pageSize non deve essere un numero negativo. Se pageSize è zero o non viene fornito, viene utilizzata la dimensione pagina predefinita, pari a 100. Il numero di sequenze di foto restituite nella risposta può essere inferiore a pageSize se il numero di corrispondenze è inferiore a pageSize. Questa funzionalità non è attualmente implementata, ma è in corso.
page_token

string

(Facoltativo) Il valore nextPageToken restituito da una richiesta ListPhotoSequences precedente, se presente.
filter

string

(Facoltativo) L'espressione di filtro. Ad esempio: imagery_type=SPHERICAL.

I filtri supportati sono: imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, `max_capture_time_seconds. Per ulteriori informazioni, visita la pagina https://google.aip.dev/160. Le query dei nomi file devono essere inviate come frase per supportare più parole e caratteri speciali mediante l'aggiunta di virgolette di escape. Esempio: filename_query="esempio di una frase.mp4"

ListPhotoSequencesResponse

Risposta per elencare tutte le sequenze di foto appartenenti a un utente.

Campi
photo_sequences[]

Operation

Elenco di sequenze foto tramite l'interfaccia Operation.

Il numero massimo di articoli restituiti si basa sul campo pageSize della richiesta.

Ogni elemento dell'elenco può avere tre stati possibili:

  • Operation.done = false, se l'elaborazione di PhotoSequence non è ancora terminata.
  • Operation.done = true e il valore Operation.error è compilato, in caso di errore durante l'elaborazione.
  • Operation.done = true e Operation.response contiene un messaggio PhotoSequence. In ogni sequenza viene compilato solo Id.
next_page_token

string

Token per recuperare la pagina successiva dei risultati o vuoto se non ci sono altri risultati nell'elenco.

ListPhotosRequest

Richiedi di elencare tutte le foto appartenenti all'utente che invia la richiesta.

Per impostazione predefinita

  • non restituisce l'URL di download per i byte della foto.

Parametri:

  • view consente di stabilire se restituire o meno l'URL di download per i byte della foto.
  • pageSize determina il numero massimo di foto da restituire.
  • pageToken è il valore del token di pagina successivo restituito da una precedente richiesta ListPhotos, se presente.
  • filter consente di applicare un filtro in base a un determinato parametro. "placeId" è l'unico parametro attualmente supportato.
Campi
view

PhotoView

Obbligatorio. Specifica se un URL di download per i byte delle foto deve essere restituito nella risposta di Foto.
page_size

int32

(Facoltativo) Il numero massimo di foto da restituire. pageSize non deve essere un numero negativo. Se pageSize è zero o non viene fornito, viene utilizzata la dimensione pagina predefinita, pari a 100. Il numero di foto restituite nella risposta può essere inferiore a pageSize se il numero di foto che appartengono all'utente è inferiore a pageSize.
page_token

string

(Facoltativo) Il valore nextPageToken restituito da una richiesta ListPhotos precedente, se presente.
filter

string

(Facoltativo) L'espressione di filtro. Ad esempio: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw.

I filtri supportati sono: placeId, min_latitude, max_latitude, min_longitude e max_longitude. Per ulteriori informazioni, visita la pagina https://google.aip.dev/160.
language_code

string

(Facoltativo) Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se language_code non è specificato, viene utilizzata la preferenza della lingua dell'utente per i servizi Google.

ListPhotosResponse

Risposta per elencare tutte le foto appartenenti a un utente.

Campi
photos[]

Photo

Elenco di foto. Il campo pageSize della richiesta determina il numero di elementi restituiti.
next_page_token

string

Token per recuperare la pagina successiva dei risultati o vuoto se non ci sono altri risultati nell'elenco.

NoOverlapGpsFailureDetails

Dettagli relativi a PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.

Campi
gps_start_time

Timestamp

Ora del primo punto GPS registrato.
gps_end_time

Timestamp

Ora dell'ultimo punto GPS registrato.
video_start_time

Timestamp

Ora di inizio del video.
video_end_time

Timestamp

Ora di fine del video.

NotOutdoorsFailureDetails

Dettagli relativi a ProcessingFailureReason#NOT_OUTDOORS. Se sono stati trovati più frame interni, qui viene registrato il primo frame.

Campi
start_time

Duration

Tempo relativo (dall'inizio del video stream) in cui è stato rilevato un fotogramma interno.

Foto

La foto viene utilizzata per archiviare le foto sferiche insieme ai metadati delle foto.

Campi
photo_id

PhotoId

Obbligatorio. Solo output. Obbligatorio quando aggiorni una foto. Vengono generati solo quando si crea una foto. Identificatore della foto, univoco tra tutte le foto su Google.
upload_reference

UploadRef

Solo input. Obbligatorio quando crei una foto. Solo input. L'URL della risorsa in cui vengono caricati i byte della foto.
download_url

string

Solo output. L'URL di download dei byte della foto. Questo campo è impostato solo quando il criterio GetPhotoRequest.view è impostato su PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnail_url

string

Solo output. L'URL della miniatura per mostrare un'anteprima della foto in questione.
pose

Pose

(Facoltativo) Posa della foto.
connections[]

Connection

(Facoltativo) Collegamenti con altre foto. Una connessione rappresenta il collegamento di questa foto a un'altra foto.
capture_time

Timestamp

(Facoltativo) Tempo assoluto in cui è stata scattata la foto. Se la foto non ha un timestamp EXIF, questo viene utilizzato per impostare un timestamp nei metadati della foto.
upload_time

Timestamp

Solo output. L'ora in cui l'immagine è stata caricata.
places[]

Place

(Facoltativo) Luoghi a cui appartiene questa foto.
view_count

int64

Solo output. Numero di visualizzazioni della foto.
transfer_status

TransferStatus

Solo output. Stato del trasferimento dei diritti su questa foto.
maps_publish_status

MapsPublishStatus

Solo output. Stato in Google Maps, indica se questa foto è stata pubblicata o rifiutata.

MapsPublishStatus

Stato di pubblicazione della foto in Google Maps.

Enum
UNSPECIFIED_MAPS_PUBLISH_STATUS Lo stato della foto è sconosciuto.
PUBLISHED La foto viene pubblicata pubblicamente tramite Google Maps.
REJECTED_UNKNOWN La foto è stata rifiutata per un motivo sconosciuto.

TransferStatus

Stato del trasferimento dei diritti.

Enum
TRANSFER_STATUS_UNKNOWN Lo stato di questo trasferimento non è specificato.
NEVER_TRANSFERRED Questa foto non è mai stata trasferita.
PENDING Il trasferimento di foto è stato avviato, ma il destinatario non ha ancora risposto.
COMPLETED Il trasferimento delle foto è stato completato e questa foto è stata trasferita al destinatario.
REJECTED Il destinatario ha rifiutato il trasferimento di questa foto.
EXPIRED Il trasferimento delle foto è scaduto prima che il destinatario intraprendesse qualsiasi azione.
CANCELLED Il mittente ha annullato il trasferimento di questa foto.
RECEIVED_VIA_TRANSFER Il destinatario possiede questa foto a causa di un trasferimento dei diritti.

PhotoId

Identificatore per Photo.

Campi
id

string

Un identificatore univoco di una foto.

PhotoResponse

Payload della risposta per un singolo Photo in operazioni batch, tra cui BatchGetPhotos e BatchUpdatePhotos.

Campi
status

Status

Lo stato dell'operazione per recuperare o aggiornare una singola foto nella richiesta batch.
photo

Photo

La risorsa Photo, se la richiesta è andata a buon fine.

PhotoSequence

Una sequenza di foto sferiche con metadati.

Campi
id

string

Solo output. Identificatore univoco per la sequenza di foto. Inoltre, funge da ID operazione a lunga esecuzione se il caricamento viene eseguito in modo asincrono.
photos[]

Photo

Solo output. Foto con timestamp crescenti.
upload_reference

UploadRef

Solo input. Obbligatorio quando crei una sequenza di foto. Il nome della risorsa in cui vengono caricati i byte della sequenza di foto (sotto forma di video).
capture_time_override

Timestamp

(Facoltativo) Tempo assoluto in cui inizia l'acquisizione della sequenza di foto. Se la sequenza di foto è un video, si tratta del momento in cui inizia il video. Se questo campo viene compilato in input, sostituisce il momento di acquisizione nel video o nel file XDM.
upload_time

Timestamp

Solo output. L'ora in cui questa sequenza di foto è stata creata nel servizio di negozio uSV.
raw_gps_timeline[]

Pose

Solo input. Misurazioni GPS non elaborate con timestamp crescenti del dispositivo che non sono sincronizzate con l'ora di ogni foto. Queste misurazioni non elaborate verranno utilizzate per dedurre la posa di ogni fotogramma. Obbligatorio nell'input quando il valore di InputType è VIDEO e le misurazioni GPS non elaborate non sono nella traccia CAMM (Motion Metadata Track) della fotocamera. L'utente può indicare quale ha la precedenza utilizzando gps_source se le misurazioni GPS non elaborate vengono fornite sia in raw_gps_timeline che in CAMM (Videocamera Motion Metadata Track).
gps_source

GpsSource

Solo input. Se sia raw_gps_timeline che CAMM (camera Motion Metadata Track) contengono misurazioni GPS, indica quale ha la precedenza.
imu

Imu

Solo input. Dati IMU a tre assi per la raccolta. Se questi dati sono troppo grandi per essere inseriti nella richiesta, devono essere inseriti nella traccia CAMM del video. Questi dati hanno sempre la precedenza sui dati CAMM equivalenti, se presenti.
processing_state

ProcessingState

Solo output. Lo stato di elaborazione di questa sequenza.
failure_reason

ProcessingFailureReason

Solo output. Se la sequenza ha Processing_state = FAILED, conterrà il motivo per cui l'operazione non è riuscita. Se il valore Processing_state è qualsiasi altro, questo campo non verrà impostato.
failure_details

ProcessingFailureDetails

Solo output. Se per questa sequenza è impostato failure_reason, potrebbe contenere ulteriori dettagli sull'errore.
distance_meters

double

Solo output. La distanza calcolata in metri della sequenza di foto.
sequence_bounds

LatLngBounds

Solo output. Una scatola rettangolare che incapsula ogni immagine in questa sequenza di foto.
view_count

int64

Solo output. Il numero totale di visualizzazioni ricevute da tutte le immagini pubblicate in questa PhotoSequence.
filename

string

Solo output. Il nome file del caricamento. Non include il percorso della directory. Disponibile solo se la sequenza è stata caricata su una piattaforma che fornisce il nome file.

GpsSource

Fonte principale delle misurazioni GPS.

Enum
PHOTO_SEQUENCE Se esistente, il GPS in raw_gps_timeline ha la precedenza.
CAMERA_MOTION_METADATA_TRACK Il GPS nella traccia CAMM (Motion Metadata Track) della videocamera ha la precedenza, se esistente.

PhotoView

Specifica quale visualizzazione dell'elemento Photo includere nella risposta.

Enum
BASIC Le risposte del server non includono l'URL di download dei byte della foto. Il valore predefinito.
INCLUDE_DOWNLOAD_URL Le risposte del server includono l'URL di download dei byte della foto.

Luogo

Inserisci i metadati per un'entità.

Campi
place_id

string

Identificatore del luogo, come descritto all'indirizzo https://developers.google.com/places/place-id.
name

string

Solo output. Il nome del luogo, localizzato nel language_code.
language_code

string

Solo output. Il codice language_code con cui è localizzato il nome. Dovrebbe essere il language_code specificato nella richiesta, ma potrebbe essere un fallback.

Posa

Misurazione della posa non elaborata di un'entità.

Campi
lat_lng_pair

LatLng

La coppia di latitudine e longitudine della posa, come spiegato qui: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng Quando crei un Photo, se non viene fornita la coppia latitudine e longitudine, viene utilizzata la geolocalizzazione dell'intestazione exif. Se la coppia latitudine e longitudine non è specificata nella foto o nell'intestazione EXIF, la procedura relativa alle foto non viene completata correttamente.
altitude

double

Altitudine della posa in metri sopra l'ellissoide WGS84. NaN indica una quantità non misurata.
heading

double

I seguenti parametri di posa si riferiscono al centro della foto. corrispondono a https://developers.google.com/streetview/spherical-metadata. Direzione della bussola, misurata al centro della foto in gradi in senso orario da nord. Il valore deve essere maggiore o uguale a 0 e minore di 360. NaN indica una quantità non misurata.
pitch

double

Tono, misurato in gradi al centro della foto. Il valore deve essere >=-90 e <= 90. -90 significa guardare direttamente verso il basso, mentre 90 significa guardare direttamente dall'alto. NaN indica una quantità non misurata.
roll

double

Rotazione, misurata in gradi. Il valore deve essere maggiore o uguale a 0 e minore di 360. Il valore 0 indica lo stesso livello dell'orizzonte. NaN indica una quantità non misurata.
gps_record_timestamp_unix_epoch

Timestamp

Ora del record GPS dall'epoca UTC.
level

Level

Livello (il piano di un edificio) utilizzato per configurare la navigazione verticale.
accuracy_meters

float

La precisione orizzontale stimata di questa posa in metri con un'affidabilità del 68% (una deviazione standard). Ad esempio, su Android questo valore è disponibile con questo metodo: https://developer.android.com/reference/android/location/Location#getAccuracy(). Altre piattaforme hanno metodi diversi per ottenere stime di accuratezza simili.

ProcessingFailureDetails

Ulteriori dettagli da accompagnare all'enum ProcessingFailureReason. Si prevede che questo messaggio venga sempre utilizzato insieme a ProcessingFailureReason e il valore oneof impostato in questo messaggio deve corrispondere a FailureReason.

Campi
Campo unione details. Verrà impostato un solo set di dettagli che deve corrispondere all'enum corrispondente in ProcessingFailureReason. details può essere solo uno dei seguenti:
insufficient_gps_details

InsufficientGpsFailureDetails

Consulta InsufficientGpsFailureDetails.
gps_data_gap_details

GpsDataGapFailureDetails

Vedi GpsDataGapFailureDetails.
imu_data_gap_details

ImuDataGapFailureDetails

Vedi ImuDataGapFailureDetails.
not_outdoors_details

NotOutdoorsFailureDetails

Vedi NotOutdoorsFailureDetails.
no_overlap_gps_details

NoOverlapGpsFailureDetails

Visualizza Nessuna sovrapposizioneGpsFailureDetails.

ProcessingFailureReason

I possibili motivi per cui l'elaborazione di questo PhotoSequence non è riuscita.

Enum
PROCESSING_FAILURE_REASON_UNSPECIFIED Il motivo dell'errore non è specificato. Questo è il valore predefinito.
LOW_RESOLUTION La risoluzione del fotogramma del video è troppo ridotta.
DUPLICATE Questo video è già stato caricato.
INSUFFICIENT_GPS Numero insufficiente di punti GPS.
NO_OVERLAP_GPS Nessuna sovrapposizione tra l'intervallo di tempo della traccia GPS e l'intervallo di tempo del video.
INVALID_GPS GPS non valido (ad esempio, tutti i punti GPS sono su (0,0))
FAILED_TO_REFINE_POSITIONS Non è stato possibile individuare con precisione la sequenza di foto nel mondo.
TAKEDOWN La sequenza è stata rimossa per motivi legati alle norme.
CORRUPT_VIDEO Il file video era danneggiato o non può essere decodificato.
INTERNAL Si è verificato un errore permanente nel sistema sottostante.
INVALID_VIDEO_FORMAT Il formato del video non è valido o non è supportato.
INVALID_VIDEO_DIMENSIONS Rilevate proporzioni dell'immagine non valide.
INVALID_CAPTURE_TIME Data/ora di acquisizione non valida. I timestamp risalgono al futuro.
GPS_DATA_GAP I dati GPS contengono un intervallo di tempo superiore a 5 secondi.
JUMPY_GPS I dati GPS sono troppo irregolari per essere elaborati.
INVALID_IMU I dati IMU (Accelerometro, Giroscopio e così via) non sono validi. Potrebbero non essere presenti campi obbligatori (x, y, z o ora), potrebbero non essere formattati correttamente o presentare altri problemi che impediscono ai nostri sistemi di analizzarli.
INSUFFICIENT_IMU Numero insufficiente di punti IMU.
INSUFFICIENT_OVERLAP_TIME_SERIES Sovrapposizione insufficiente nell'intervallo di tempo tra GPS, IMU e altri dati di serie temporali.
IMU_DATA_GAP I dati IMU (Accelerometro, Giroscopio e così via) contengono lacune di durata superiore a 0, 1 secondi.
UNSUPPORTED_CAMERA La videocamera non è supportata.
NOT_OUTDOORS Alcuni frame si trovavano all'interno, anche se non è supportato.
INSUFFICIENT_VIDEO_FRAMES Frame video insufficienti.
INSUFFICIENT_MOVEMENT Dati sullo spostamento insufficienti.

ProcessingState

Lo stato di elaborazione della sequenza. Gli stati si spostano come segue:

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

La sequenza può passare a FAILED da qualsiasi stato. Inoltre, una sequenza elaborata può essere rielaborata in qualsiasi momento.

Enum
PROCESSING_STATE_UNSPECIFIED Lo stato non è specificato, questo è il valore predefinito.
PENDING L'elaborazione della sequenza non è ancora stata avviata.
PROCESSING La sequenza è attualmente in fase di elaborazione.
PROCESSED L'elaborazione della sequenza è stata completata, incluso il perfezionamento della posizione.
FAILED Elaborazione della sequenza non riuscita. Consulta FailureReason per ulteriori dettagli.

UpdatePhotoRequest

Richiedi l'aggiornamento dei metadati di un Photo. L'aggiornamento dei pixel di una foto non è supportato.

Campi
photo

Photo

Obbligatorio. Oggetto Photo contenente i nuovi metadati.
update_mask

FieldMask

Obbligatorio. Maschera che identifica i campi sui metadati della foto da aggiornare. Se non presenti, i vecchi metadati Photo vengono completamente sostituiti con i nuovi metadati Photo in questa richiesta. Se vengono specificati campi non validi, l'aggiornamento non va a buon fine. È possibile specificare più campi in un elenco delimitato da virgole.

I seguenti campi sono validi:

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

Nota: quando updateMask contiene campi ripetuti, l'intero insieme di valori ripetuti viene sostituito con i nuovi contenuti. Ad esempio, se updateMask contiene connections e UpdatePhotoRequest.photo.connections è vuoto, tutte le connessioni vengono rimosse.

UploadRef

Riferimento per il caricamento dei file multimediali.

Campi
Campo unione file_source. Obbligatorio. file_source può essere solo uno dei seguenti:
upload_url

string

Un riferimento al caricamento deve essere univoco per ogni utente. Segue il formato: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"