Package google.streetview.publish.v1

Índice

StreetViewPublishService

Publica e conecta fotos enviadas por usuários no Street View.

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Exclui uma lista de Photos e os metadados correspondentes.

Se BatchDeletePhotos falhar, significa que campos críticos estão ausentes ou há um erro de autenticação. Mesmo que BatchDeletePhotos seja bem-sucedido, as fotos individuais no lote podem ter falhas. Essas falhas são especificadas em cada PhotoResponse.status em BatchDeletePhotosResponse.results. Consulte DeletePhoto para ver falhas específicas que podem ocorrer por foto.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

Recebe os metadados do lote Photo especificado.

Se BatchGetPhotos falhar, significa que campos críticos estão ausentes ou há um erro de autenticação. Mesmo que BatchGetPhotos seja bem-sucedido, as fotos individuais no lote podem ter falhas. Essas falhas são especificadas em cada PhotoResponse.status em BatchGetPhotosResponse.results. Consulte GetPhoto para ver falhas específicas que podem ocorrer por foto.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

Atualiza os metadados de Photos, como pose, associação de lugar, conexões, etc. Não é possível alterar os pixels das fotos.

Se BatchUpdatePhotos falhar, significa que campos críticos estão ausentes ou há um erro de autenticação. Mesmo que BatchUpdatePhotos seja bem-sucedido, as fotos individuais no lote podem ter falhas. Essas falhas são especificadas em cada PhotoResponse.status em BatchUpdatePhotosResponse.results. Consulte UpdatePhoto para ver falhas específicas que podem ocorrer por foto.

Somente os campos especificados em updateMask são usados. Se updateMask não estiver presente, a atualização vai ser aplicada a todos os campos.

O número de mensagens UpdatePhotoRequest em uma BatchUpdatePhotosRequest não pode exceder 20.

Observação: para atualizar Pose.altitude, também é necessário preencher Pose.latLngPair. Caso contrário, a solicitação falhará.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

Depois que o cliente termina de fazer o upload da foto com o UploadRef retornado, o CreatePhoto publica o Photo enviado no Street View no Google Maps.

Atualmente, a única maneira de definir a direção, o tom e a rolagem no CreatePhoto é por meio dos metadados XMP do Photo Sphere nos bytes da foto. O CreatePhoto ignora os campos pose.heading, pose.pitch, pose.roll, pose.altitude e pose.level em Pose.

Esse método retorna os seguintes códigos de erro:

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

Depois que o cliente termina de fazer o upload do PhotoSequence com o UploadRef retornado, o CreatePhotoSequence extrai uma sequência de fotos em 360° de um vídeo ou Extensible Device Metadata (XDM, http://www.xdm.org/) para publicar no Street View no Google Maps.

CreatePhotoSequence retorna um Operation, com o ID PhotoSequence definido no campo Operation.name.

Esse método retorna os seguintes códigos de erro:

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

Exclui um Photo e os metadados dele.

Esse método retorna os seguintes códigos de erro:

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

Exclui um PhotoSequence e os metadados dele.

Esse método retorna os seguintes códigos de erro:

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

Recebe os metadados do Photo especificado.

Esse método retorna os seguintes códigos de erro:

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

Recebe os metadados do PhotoSequence especificado por meio da interface Operation.

Esse método retorna os três tipos de resposta a seguir:

  • Operation.done = falso, se o processamento de PhotoSequence ainda não tiver sido concluído.
  • Operation.done = verdadeiro e Operation.error será preenchido, se houver um erro no processamento.
  • Operation.done = verdadeiro e Operation.response é somado, o que contém uma mensagem PhotoSequence.

Esse método retorna os seguintes códigos de erro:

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

Lista todos os PhotoSequences que pertencem ao usuário, em ordem decrescente de carimbo de data/hora CreatePhotoSequence.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

Lista todos os Photos que pertencem ao usuário.

Observação: fotos criadas recentemente que ainda estão sendo indexadas não são retornadas na resposta.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

Cria uma sessão de upload para iniciar o upload de dados da sequência de fotos. O URL de upload do UploadRef retornado é usado para fazer upload dos dados do photoSequence.

Depois que o upload for concluído, o UploadRef é usado com CreatePhotoSequence para criar a entrada do objeto PhotoSequence.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
StartUpload

rpc StartUpload(Empty) returns (UploadRef)

Cria uma sessão de upload para iniciar o upload de bytes da foto. O método usa o URL de upload do UploadRef retornado para fazer upload dos bytes do Photo.

Além dos requisitos para fotos em https://support.google.com/maps/answer/7012050?ref_topic=6275604, a foto precisa atender a estes requisitos:

Depois que o upload for concluído, o método usará UploadRef com CreatePhoto para criar a entrada do objeto Photo.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

Atualiza os metadados de uma Photo, como pose, associação de lugar, conexões etc. Não é possível alterar os pixels de uma foto.

Somente os campos especificados em updateMask são usados. Se updateMask não estiver presente, a atualização vai ser aplicada a todos os campos.

Esse método retorna os seguintes códigos de erro:

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

BatchDeletePhotosRequest

Solicitação para excluir vários Photos.

Campos
photo_ids[]

string

Obrigatório. IDs de Photos. As solicitações HTTP GET exigem a seguinte sintaxe para o parâmetro de consulta do URL: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

Resposta para exclusão em lote de um ou mais Photos.

Campos
status[]

Status

O status da operação para excluir um único Photo na solicitação em lote.

BatchGetPhotosRequest

Solicitação para receber um ou mais Photos. Por padrão,

  • não retorna o URL de download dos bytes da foto.

Parâmetros:

  • view controla se o URL de download dos bytes da foto é retornado.
Campos
photo_ids[]

string

Obrigatório. IDs de Photos. Para solicitações HTTP GET, o parâmetro de consulta do URL precisa ser photoIds=<id1>&photoIds=<id2>&....
view

PhotoView

Obrigatório. Especifica se um URL de download para os bytes da foto deve ser retornado na resposta de Foto.
language_code

string

Opcional. O código de idioma BCP-47, como "en-US" ou "sr-Latn". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se o language_code não for especificado, será usada a preferência de idioma do usuário para os Serviços do Google.

BatchGetPhotosResponse

Resposta para recebimento em lote de Photos.

Campos
results[]

PhotoResponse

Lista de resultados de cada Photo individual, na mesma ordem das solicitações em BatchGetPhotos.

BatchUpdatePhotosRequest

Solicitação para atualizar os metadados das fotos. Não é possível atualizar os pixels das fotos.

Campos
update_photo_requests[]

UpdatePhotoRequest

Obrigatório. Lista de UpdatePhotoRequests.

BatchUpdatePhotosResponse

Resposta para atualização em lote de metadados de um ou mais Photos.

Campos
results[]

PhotoResponse

Lista de resultados de cada Photo individual atualizada, na mesma ordem da solicitação.

Conexão

Uma conexão é o link entre uma foto de origem e uma foto de destino.

Campos
target

PhotoId

Obrigatório. O destino da conexão da foto que a contém para outra foto.

CreatePhotoRequest

Solicitação para criar um Photo.

Campos
photo

Photo

Obrigatório. Foto a ser criada.

CreatePhotoSequenceRequest

Solicitação para criar um PhotoSequence usando um vídeo.

Campos
photo_sequence

PhotoSequence

Obrigatório. PhotoSequence para criar.
input_type

InputType

Obrigatório. O formulário de entrada de PhotoSequence.

InputType

Formas de entrada de PhotoSequence.

Enums
INPUT_TYPE_UNSPECIFIED Não especificado. O servidor retornará google.rpc.Code.INVALID_ARGUMENT.
VIDEO Vídeo em 360°.
XDM Extensible Device Metadata, http://www.xdm.org (em inglês)

DeletePhotoRequest

Solicitação para excluir um Photo.

Campos
photo_id

string

Obrigatório. ID do Photo.

DeletePhotoSequenceRequest

Solicitação para excluir um PhotoSequence.

Campos
sequence_id

string

Obrigatório. ID do PhotoSequence.

GetPhotoRequest

Solicitação para receber um Photo.

Por padrão,

  • não retorna o URL de download dos bytes da foto.

Parâmetros:

  • view controla se o URL de download dos bytes da foto é retornado.
Campos
photo_id

string

Obrigatório. ID do Photo.
view

PhotoView

Obrigatório. Especifica se um URL de download para os bytes da foto precisa ser retornado na resposta Photo.
language_code

string

O código de idioma BCP-47, como "en-US" ou "sr-Latn". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se o language_code não for especificado, será usada a preferência de idioma do usuário para os Serviços do Google.

GetPhotoSequenceRequest

Solicitação para receber um PhotoSequence.

Por padrão,

Parâmetros:

  • view controla se o URL de download para o PhotoSequence é retornado.
Campos
sequence_id

string

Obrigatório. ID da sequência de fotos.
view
(deprecated)

PhotoView

Especifica se um URL de download para a sequência de fotos precisa ser retornado em download_url de fotos individuais na resposta PhotoSequence.

Observação: atualmente não implementado.
filter

string

Opcional. A expressão do filtro. Por exemplo, published_status=PUBLISHED.

Os filtros aceitos são: published_status. Acesse https://google.aip.dev/160 (link em inglês) para mais informações.

GpsDataGapFailureDetails

Detalhes relacionados ao ProcessingFailureReason#GPS_DATA_GAP. Se houver várias lacunas de dados de GPS, somente a que tiver a maior duração será informada aqui.

Campos
gap_duration

Duration

A duração da lacuna nos dados de GPS encontrada.
gap_start_time

Duration

Tempo relativo (desde o início do stream de vídeo) em que a lacuna começou.

Imu

Dados de IMU dos sensores do dispositivo.

Campos
accel_mpsps[]

Measurement3d

As medições do acelerômetro, em metros/s^2, com marcações de tempo crescentes dos dispositivos.
gyro_rps[]

Measurement3d

As medições do giroscópio em radianos/s, com marcações de tempo crescentes dos dispositivos.
mag_ut[]

Measurement3d

As medições do magnetômetro do campo magnético em microtesla (uT) com carimbos de data/hora crescentes dos dispositivos.

Medição 3d

Uma amostra genérica de medição de 3D.

Campos
capture_time

Timestamp

O carimbo de data/hora da medição da IMU.
x

float

A medida do sensor no eixo x.
y

float

A medida do sensor no eixo Y.
z

float

A medida do sensor no eixo z.

ImuDataGapFailureDetails

Detalhes relacionados ao ProcessingFailureReason#IMU_DATA_GAP. Se houver várias lacunas de dados da IMU, apenas a que tiver a maior duração será informada aqui.

Campos
gap_duration

Duration

A duração do intervalo encontrado nos dados da IMU.
gap_start_time

Duration

Tempo relativo (desde o início do stream de vídeo) em que a lacuna começou.

InsufficientGpsFailureDetails

Detalhes relacionados a ProcessingFailureReason#INSUFFICIENT_GPS.

Campos
gps_points_found

int32

O número de pontos de GPS que foram encontrados no vídeo.

LatLngBounds

Um retângulo em coordenadas geográficas.

Campos
southwest

LatLng

O canto sudoeste desses limites.
northeast

LatLng

O canto nordeste desses limites.

Nível

Informações do nível que contêm o número e o nome correspondente.

Campos
number

double

Opcional. Número do andar, usado para fazer pedidos. 0 indica o nível do solo, 1 indica o primeiro nível acima do solo e -1 indica o primeiro nível abaixo do nível do solo. Valores não inteiros são permitidos.
name

string

Obrigatório. Um nome atribuído a esse nível, restrito a três caracteres. Considere como os botões de elevador seriam rotulados para este nível se houvesse um elevador.

ListPhotoSequencesRequest

Solicitação para listar todas as sequências de fotos que pertencem ao usuário que enviou a solicitação.

Parâmetros:

  • pageSize determina o número máximo de sequências de fotos a serem retornadas.
  • pageToken é o valor do token da próxima página retornado de uma solicitação ListPhotoSequences anterior, se houver.
Campos
page_size

int32

Opcional. O número máximo de sequências de fotos a serem retornadas. pageSize não pode ser negativo. Se pageSize for zero ou não for fornecido, o tamanho de página padrão 100 será usado. O número de sequências de fotos retornadas na resposta poderá ser menor que pageSize se o número de correspondências for menor que pageSize. No momento, isso não foi implementado, mas está em andamento.
page_token

string

Opcional. O valor nextPageToken retornado de uma solicitação ListPhotoSequences anterior, se houver.
filter

string

Opcional. A expressão do filtro. Por exemplo, imagery_type=SPHERICAL.

Os filtros com suporte são: imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, `max_capture_time_seconds. Acesse https://google.aip.dev/160 (link em inglês) para mais informações. As consultas de nome de arquivo devem ser enviadas como uma frase para aceitar várias palavras e caracteres especiais, adicionando aspas de escape. Por exemplo: nome_do_arquivo_consulta="exemplo de uma frase.mp4"

ListPhotoSequencesResponse

Resposta para listar todas as sequências de fotos que pertencem a um usuário.

Campos
photo_sequences[]

Operation

Lista de sequências de fotos pela interface Operation.

O número máximo de itens retornados se baseia no campo pageSize na solicitação.

Cada item na lista pode ter três estados possíveis,

  • Operation.done = falso, se o processamento de PhotoSequence ainda não tiver sido concluído.
  • Operation.done = verdadeiro e Operation.error será preenchido, se houver um erro no processamento.
  • Operation.done = verdadeiro e Operation.response contém uma mensagem PhotoSequence. Em cada sequência, apenas Id é preenchido.
next_page_token

string

Token para recuperar a próxima página de resultados ou vazia se não houver mais resultados na lista.

ListPhotosRequest

Peça para listar todas as fotos que pertencem ao usuário que enviou a solicitação.

Por padrão,

  • não retorna o URL de download dos bytes da foto.

Parâmetros:

  • view controla se o URL de download dos bytes da foto é retornado.
  • pageSize determina o número máximo de fotos a serem retornadas.
  • pageToken é o valor do token da próxima página retornado de uma solicitação ListPhotos anterior, se houver.
  • filter permite a filtragem por um determinado parâmetro. "placeId" é o único parâmetro aceito no momento.
Campos
view

PhotoView

Obrigatório. Especifica se um URL de download para os bytes de fotos vai ser retornado na resposta do app Fotos.
page_size

int32

Opcional. O número máximo de fotos a serem retornadas. pageSize não pode ser negativo. Se pageSize for zero ou não for fornecido, o tamanho de página padrão 100 será usado. O número de fotos retornadas na resposta pode ser menor que pageSize se o número de fotos que pertencem ao usuário for menor que pageSize.
page_token

string

Opcional. O valor nextPageToken retornado de uma solicitação ListPhotos anterior, se houver.
filter

string

Opcional. A expressão do filtro. Por exemplo, placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw.

Os filtros com suporte são: placeId, min_latitude, max_latitude, min_longitude e max_longitude. Acesse https://google.aip.dev/160 (link em inglês) para mais informações.
language_code

string

Opcional. O código de idioma BCP-47, como "en-US" ou "sr-Latn". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se o language_code não for especificado, será usada a preferência de idioma do usuário para os Serviços do Google.

ListPhotosResponse

Resposta para listar todas as fotos que pertencem a um usuário.

Campos
photos[]

Photo

Lista de fotos. O campo pageSize na solicitação determina o número de itens retornados.
next_page_token

string

Token para recuperar a próxima página de resultados ou vazia se não houver mais resultados na lista.

NoOverlapGpsFailureDetails

Detalhes relacionados ao PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.

Campos
gps_start_time

Timestamp

Hora do primeiro ponto GPS registrado.
gps_end_time

Timestamp

Hora do último ponto GPS registrado.
video_start_time

Timestamp

Horário de início do vídeo.
video_end_time

Timestamp

Horário de término do vídeo.

NotOutdoorsFailureDetails

Detalhes relacionados a ProcessingFailureReason#NOT_OUTDOORS. Se forem encontrados vários frames internos, o primeiro frame será registrado aqui.

Campos
start_time

Duration

Tempo relativo (do início do stream de vídeo) em que um frame interno foi encontrado.

Foto

O Photo é usado para armazenar fotos em 360° com os metadados delas.

Campos
photo_id

PhotoId

Obrigatório. Apenas saída. Obrigatório ao atualizar uma foto. Saída apenas ao criar uma foto. O identificador da foto, que é exclusivo entre todas as fotos no Google.
upload_reference

UploadRef

Apenas entrada. Obrigatório ao criar uma foto. Apenas entrada. O URL do recurso em que o upload dos bytes da foto é feito.
download_url

string

Apenas saída. O URL de download para os bytes da foto. Este campo é definido apenas quando GetPhotoRequest.view é definido como PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnail_url

string

Apenas saída. É o URL da miniatura para mostrar uma visualização da foto especificada.
pose

Pose

Opcional. Posição da foto.
connections[]

Connection

Opcional. Conexões com outras fotos. Uma conexão representa o link desta foto para outra foto.
capture_time

Timestamp

Opcional. Hora absoluta em que a foto foi capturada. Quando a foto não tem o carimbo de data/hora exif, ele é usado para definir essa marcação nos metadados da foto.
upload_time

Timestamp

Apenas saída. Hora em que a imagem foi enviada.
places[]

Place

Opcional. Lugares a que esta foto pertence.
view_count

int64

Apenas saída. Número de visualizações da foto.
transfer_status

TransferStatus

Apenas saída. Status da transferência de direitos sobre esta foto.
maps_publish_status

MapsPublishStatus

Apenas saída. Status no Google Maps, se a foto foi publicada ou rejeitada.

MapsPublishStatus

Status de publicação da foto no Google Maps.

Enums
UNSPECIFIED_MAPS_PUBLISH_STATUS O status da foto é desconhecido.
PUBLISHED A foto é publicada para o público pelo Google Maps.
REJECTED_UNKNOWN A foto foi rejeitada por um motivo desconhecido.

TransferStatus

Status da transferência de direitos.

Enums
TRANSFER_STATUS_UNKNOWN O status dessa transferência não foi especificado.
NEVER_TRANSFERRED Esta foto nunca foi transferida para uma transferência.
PENDING Esta transferência de fotos foi iniciada, mas o destinatário ainda não respondeu.
COMPLETED A transferência da foto foi concluída, e esta foto foi transferida para o destinatário.
REJECTED O destinatário rejeitou esta transferência de foto.
EXPIRED A transferência de fotos expirou antes de o destinatário realizar qualquer ação.
CANCELLED O remetente cancelou esta transferência de fotos.
RECEIVED_VIA_TRANSFER O destinatário é o proprietário da foto devido a uma transferência de direitos.

PhotoId

Identificador de um Photo.

Campos
id

string

Um identificador exclusivo de uma foto.

PhotoResponse

Payload de resposta para um único Photo em operações em lote, incluindo BatchGetPhotos e BatchUpdatePhotos.

Campos
status

Status

Status da operação para receber ou atualizar uma única foto na solicitação em lote.
photo

Photo

O recurso Photo, se a solicitação for bem-sucedida.

PhotoSequence

Uma sequência de fotos em 360° com metadados.

Campos
id

string

Apenas saída. Identificador exclusivo da sequência de fotos. Ele também funciona como um ID de operação de longa duração se o upload for realizado de maneira assíncrona.
photos[]

Photo

Apenas saída. Fotos com marcações de tempo cada vez maiores.
upload_reference

UploadRef

Apenas entrada. Obrigatório ao criar uma sequência de fotos. O nome do recurso em que os bytes da sequência de fotos (na forma de vídeo) são enviados.
capture_time_override

Timestamp

Opcional. Horário absoluto em que a sequência de fotos começa a ser capturada. Se a sequência de fotos for um vídeo, esse será o horário de início do vídeo. Se esse campo for preenchido na entrada, ele vai substituir o tempo de captura no arquivo de vídeo ou XDM.
upload_time

Timestamp

Apenas saída. A hora em que esta sequência de fotos foi criada no serviço uSV Store.
raw_gps_timeline[]

Pose

Apenas entrada. Medições de GPS brutas com carimbos de data/hora crescentes do dispositivo que não são sincronizadas com cada foto. Essas medidas brutas serão usadas para inferir a pose de cada frame. Obrigatório quando o InputType for VIDEO e as medições brutas de GPS não estiverem na faixa de metadados de movimento da câmera (CAMM, na sigla em inglês). O usuário pode indicar qual tem precedência usando gps_source se as medições de GPS brutas forem fornecidas em cru_gps_timeline e Camera Motion Metadata Track (CAMM).
gps_source

GpsSource

Apenas entrada. Se bruto_gps_timeline e a faixa de metadados de movimento da câmera (CAMM) tiverem medições de GPS, indique qual tem prioridade.
imu

Imu

Apenas entrada. Dados da IMU de três eixos para a coleta. Se esses dados forem muito grandes para serem incluídos na solicitação, eles deverão ser colocados na faixa do CAMM do vídeo. Esses dados sempre têm precedência sobre os dados do CAMM equivalentes, se existirem.
processing_state

ProcessingState

Apenas saída. O estado de processamento dessa sequência.
failure_reason

ProcessingFailureReason

Apenas saída. Se a sequência tiver process_state = FAILED, provoque o motivo da falha. Se Processing_state for outro valor, esse campo não será definido.
failure_details

ProcessingFailureDetails

Apenas saída. Se a sequência tiver failure_reason definido, ela poderá conter detalhes adicionais sobre a falha.
distance_meters

double

Apenas saída. A distância calculada da sequência de fotos em metros.
sequence_bounds

LatLngBounds

Apenas saída. Uma caixa retangular que encapsula todas as imagens desta sequência de fotos.
view_count

int64

Apenas saída. O número total de visualizações que todas as imagens publicadas nesta PhotoSequence receberam.
filename

string

Apenas saída. É o nome de arquivo do upload. Não inclui o caminho do diretório. Disponível somente se a sequência tiver sido enviada em uma plataforma que forneça o nome do arquivo.

GpsSource

Principal fonte de medições de GPS.

Enums
PHOTO_SEQUENCE O GPS no bruto_gps_timeline tem precedência, se existir.
CAMERA_MOTION_METADATA_TRACK O GPS na faixa de metadados de movimento da câmera (CAMM, na sigla em inglês) tem precedência, se existir.

PhotoView

Especifica qual visualização do Photo incluir na resposta.

Enums
BASIC As respostas do servidor não incluem o URL de download dos bytes da foto. O valor padrão.
INCLUDE_DOWNLOAD_URL As respostas do servidor incluem o URL de download dos bytes da foto.

Lugar

Inserir metadados de uma entidade.

Campos
place_id

string

O identificador de local, conforme descrito em https://developers.google.com/places/place-id.
name

string

Apenas saída. O nome do local, localizado em language_code.
language_code

string

Apenas saída. O language_code com o qual o nome é localizado. Precisa ser o language_code especificado na solicitação, mas pode ser um substituto.

Posição

Medição de pose bruta de uma entidade.

Campos
lat_lng_pair

LatLng

Par de latitude e longitude da pose, como explicado aqui: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng Ao criar uma Photo, se o par de latitude e longitude não é fornecido, a geolocalização do cabeçalho exif é usada. Um par de latitude e longitude não fornecido no cabeçalho Photo ou Exif faz com que o processo da foto falhe.
altitude

double

Altitude da pose em metros acima do elipsoide WGS84. NaN indica uma quantidade não medida.
heading

double

Os seguintes parâmetros de poses pertencem ao centro da foto. Elas correspondem a https://developers.google.com/streetview/spherical-metadata. Direção da bússola, medida no centro da foto, em graus, no sentido horário a partir do Norte. O valor precisa ser >=0 e <360. NaN indica uma quantidade não medida.
pitch

double

Inclinação, medida em graus no centro da foto. O valor precisa ser maior ou igual a 90 e menor ou igual a 90. Um valor de -90 significa olhar diretamente para baixo, enquanto um valor de 90 significa olhar diretamente para cima. NaN indica uma quantidade não medida.
roll

double

Giro, medido em graus. O valor precisa ser maior que 0 e menor que 360. Um valor de 0 significa nivelamento com o horizonte. NaN indica uma quantidade não medida.
gps_record_timestamp_unix_epoch

Timestamp

Hora do registro GPS desde a época UTC.
level

Level

Nível (o andar de um edifício) usado para configurar a navegação vertical.
accuracy_meters

float

É a precisão horizontal estimada dessa pose em metros com 68% de confiança (um desvio padrão). Por exemplo, no Android, esse valor está disponível por este método: https://developer.android.com/reference/android/location/Location#getAccuracy(). Outras plataformas têm métodos diferentes para receber estimativas de precisão semelhantes.

ProcessingFailureDetails

Detalhes adicionais para acompanhar o enum ProcessingFailureReason. Espera-se que essa mensagem seja sempre usada em conjunto com ProcessingFailureReason e o valor oneof definido nesta mensagem corresponda a FailureReason.

Campos
Campo de união details. Somente um conjunto de detalhes será definido e precisa corresponder ao tipo enumerado correspondente em ProcessingFailureReason. details pode ser apenas de um dos tipos a seguir:
insufficient_gps_details

InsufficientGpsFailureDetails

Consulte InsufficientGpsFailureDetails.
gps_data_gap_details

GpsDataGapFailureDetails

Consulte GpsDataGapFailureDetails.
imu_data_gap_details

ImuDataGapFailureDetails

Consulte ImuDataGapFailureDetails.
not_outdoors_details

NotOutdoorsFailureDetails

Consulte NotOutdoorsFailureDetails.
no_overlap_gps_details

NoOverlapGpsFailureDetails

Consulte NoOverlayGpsFailureDetails.

ProcessingFailureReason

Os possíveis motivos da falha no processamento de PhotoSequence.

Enums
PROCESSING_FAILURE_REASON_UNSPECIFIED O motivo da falha não foi especificado. Esse é o valor padrão.
LOW_RESOLUTION A resolução do frame do vídeo é muito pequena.
DUPLICATE Este vídeo já foi enviado.
INSUFFICIENT_GPS Pontos de GPS insuficientes.
NO_OVERLAP_GPS Não há sobreposição entre o período da trilha do GPS e o período do vídeo.
INVALID_GPS O GPS é inválido (por exemplo, todos os pontos do GPS estão em (0,0))
FAILED_TO_REFINE_POSITIONS Não foi possível localizar a sequência das fotos no mundo com precisão.
TAKEDOWN A sequência foi removida por violação da política.
CORRUPT_VIDEO O arquivo de vídeo estava corrompido ou não pôde ser decodificado.
INTERNAL Ocorreu uma falha permanente no sistema subjacente.
INVALID_VIDEO_FORMAT O formato de vídeo é inválido ou incompatível.
INVALID_VIDEO_DIMENSIONS Proporção de imagem inválida encontrada.
INVALID_CAPTURE_TIME A hora da captura é inválida. As marcações de tempo estavam no futuro.
GPS_DATA_GAP Os dados de GPS contêm um intervalo maior que 5 segundos de duração.
JUMPY_GPS Os dados de GPS são muito irregulares para serem processados.
INVALID_IMU Os dados de IMU (acelerômetro, giroscópio etc.) não são válidos. Talvez estejam faltando campos obrigatórios (x, y, z ou hora), eles não estejam formatados corretamente ou qualquer outro problema que impeça nossos sistemas de analisá-los.
INSUFFICIENT_IMU Há poucos pontos de IMU.
INSUFFICIENT_OVERLAP_TIME_SERIES Sobreposição insuficiente no período entre os dados de GPS, IMU e outras séries temporais.
IMU_DATA_GAP Os dados da IMU (acelerômetro, giroscópio etc.) contêm lacunas maiores que 0, 1 segundo de duração.
UNSUPPORTED_CAMERA A câmera não é compatível.
NOT_OUTDOORS Alguns frames estavam em ambientes fechados, o que não é permitido.
INSUFFICIENT_VIDEO_FRAMES Não há frames de vídeo suficientes.
INSUFFICIENT_MOVEMENT Não há dados móveis suficientes.

ProcessingState

O estado de processamento da sequência. Os estados se movem da seguinte maneira:

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

A sequência pode passar de qualquer estado para FAILED. Além disso, uma sequência processada pode ser reprocessada a qualquer momento.

Enums
PROCESSING_STATE_UNSPECIFIED O estado não foi especificado, esse é o valor padrão.
PENDING O processamento da sequência ainda não foi iniciado.
PROCESSING A sequência está em processamento.
PROCESSED O processamento da sequência foi concluído, incluindo o refinamento da posição.
FAILED Falha no processamento da sequência. Consulte o FailureReason para ver mais detalhes.

UpdatePhotoRequest

Solicitação para atualizar os metadados de um Photo. Não é possível atualizar os pixels de uma foto.

Campos
photo

Photo

Obrigatório. Objeto Photo que contém os novos metadados.
update_mask

FieldMask

Obrigatório. Máscara que identifica campos nos metadados da foto a serem atualizados. Se não estiverem presentes, os metadados Photo antigos serão totalmente substituídos pelos novos Photo na solicitação. A atualização falhará se campos inválidos forem especificados. Vários campos podem ser especificados em uma lista delimitada por vírgulas.

Os seguintes campos são válidos:

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

Observação: quando updateMask tiver campos repetidos, todo o conjunto de valores repetidos será substituído pelo novo conteúdo. Por exemplo, se updateMask contiver connections e UpdatePhotoRequest.photo.connections estiver vazio, todas as conexões serão removidas.

UploadRef

Fazer upload de referência para arquivos de mídia.

Campos
Campo de união file_source. Obrigatório. file_source pode ser apenas de um dos tipos a seguir:
upload_url

string

Uma referência de upload precisa ser única para cada usuário. Ele segue este formulário: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"