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, os campos críticos vão estar ausentes ou haverá 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 conferir 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, os campos críticos vão estar ausentes ou haverá 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 conferir 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 lugares, conexões etc. Não é possível alterar os pixels das fotos.

Se BatchUpdatePhotos falhar, os campos críticos vão estar ausentes ou haverá 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 conferir 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 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, Pose.latLngPair também precisa ser preenchido. 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 upload da foto com a UploadRef retornada, CreatePhoto publica a Photo enviada no Street View no Google Maps.

Atualmente, a única maneira de definir a direção, a inclinação e a rolagem no CreatePhoto é pelos metadados XMP de Photo Spheres nos bytes das fotos. O CreatePhoto ignora os campos pose.heading, pose.pitch, pose.roll, pose.altitude e pose.level na postura.

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 upload do PhotoSequence com o UploadRef retornado, CreatePhotoSequence extrai uma sequência de fotos em 360° de um vídeo ou metadados de dispositivo extensível (XDM, http://www.xdm.org/) para serem publicados no Street View no Google Maps.

CreatePhotoSequence retorna um Operation, com o ID de 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 é calculado, contendo 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 estiverem sendo indexadas não serã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 dos dados de sequência de fotos. O URL de upload do UploadRef retornado é usado para fazer upload dos dados da photoSequence.

Depois que o upload for concluído, o UploadRef será usado com CreatePhotoSequence para criar a entrada de 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 de fotos. O método usa o URL de upload da UploadRef retornada para fazer upload dos bytes da Photo.

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

Depois que o upload for concluído, o método vai 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 lugares, conexões etc. Não é possível alterar os pixels de uma foto.

Somente os campos especificados no campo updateMask são usados. Se updateMask não estiver presente, a atualização 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 do Photos. As solicitações HTTP GET exigem a seguinte sintaxe para o parâmetro de consulta do URL: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

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

Campos
status[]

Status

O status da operação de exclusão de 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 para os bytes de foto.

Parâmetros:

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

string

Obrigatório. IDs do 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 de foto deve ser retornado na resposta de Photo.
language_code

string

Opcional. O código de idioma BCP-47, como "pt-BR" ou "en-US". 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 ao recebimento em lote de Photos.

Campos
results[]

PhotoResponse

Lista de resultados para cada solicitação de 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 à atualização em lote de metadados de um ou mais Photos.

Campos
results[]

PhotoResponse

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

Conexão

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

Campos
target

PhotoId

Obrigatório. O destino da conexão da foto que a contém com 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. A forma de entrada de PhotoSequence.

InputType

Formas de entrada de PhotoSequence.

Enums
INPUT_TYPE_UNSPECIFIED Não especificado. O servidor vai 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 para os bytes de foto.

Parâmetros:

  • O 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 de foto precisa ser retornado na resposta Photo.
language_code

string

O código de idioma BCP-47, como "pt-BR" ou "en-US". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se 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:

  • O view controla se o URL de download do 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 no 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 compatíveis são: published_status. Consulte https://google.aip.dev/160 para mais informações.

GpsDataGapFailureDetails

Detalhes relacionados a 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 encontrada nos dados de GPS.
gap_start_time

Duration

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

Imu

Dados de IMU dos sensores do dispositivo.

Campos
accel_mpsps[]

Measurement3d

O acelerômetro mede 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 marcações de tempo crescentes nos dispositivos.

Medição 3d

Uma amostra de medição genérica em 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 a ProcessingFailureReason#IMU_DATA_GAP. Se houver várias lacunas de dados de IMU, somente aquela com a maior duração será informada aqui.

Campos
gap_duration

Duration

A duração da lacuna nos dados de IMU que foi encontrada.
gap_start_time

Duration

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

InsufficientGpsFailureDetails

Detalhes relacionados a ProcessingFailureReason#INSUFFICIENT_GPS.

Campos
gps_points_found

int32

O número de pontos de GPS 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 do nível e o nome correspondente.

Campos
number

double

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

string

Obrigatório. Um nome atribuído a este nível, com limite de três caracteres. Considere como os botões de elevador seriam rotulados para esse 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 de 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, esse recurso 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 aceitos são: imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, "max_capture_time_seconds". Consulte https://google.aip.dev/160 para mais informações. As consultas de nome de arquivo devem ser enviadas como uma frase para dar suporte a várias palavras e caracteres especiais adicionando aspas de escape. Por exemplo: filename_query="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 é baseado no campo pageSize da solicitação.

Cada item da 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

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

Por padrão

  • não retorna o URL de download para os bytes de foto.

Parâmetros:

  • view controla se o URL de download dos bytes de 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 filtrar 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 será retornado na resposta de 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 de 100 será usado. O número de fotos retornadas na resposta poderá 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 compatíveis são: placeId, min_latitude, max_latitude, min_longitude, max_longitude. Consulte https://google.aip.dev/160 para mais informações.
language_code

string

Opcional. O código de idioma BCP-47, como "pt-BR" ou "en-US". Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se 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 a PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.

Campos
gps_start_time

Timestamp

Hora do primeiro ponto do GPS gravado.
gps_end_time

Timestamp

Hora do último ponto do GPS gravado.
video_start_time

Timestamp

Hora de início do vídeo.
video_end_time

Timestamp

Hora de término do vídeo.

NotOutdoorsFailureDetails

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

Campos
start_time

Duration

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

Foto

A foto é usada para armazenar fotos em 360° com os metadados correspondentes.

Campos
photo_id

PhotoId

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

UploadRef

Somente entrada. Obrigatório ao criar uma foto. Somente entrada. O URL do recurso para onde os bytes da foto são enviados.
download_url

string

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

string

Apenas saída. O URL de miniatura para mostrar uma visualização da foto em questão.
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.
capture_time

Timestamp

Opcional. Horário absoluto em que a foto foi tirada. Quando a foto não tem carimbo de data/hora Exif, isso é usado para definir um carimbo de data/hora nos metadados da foto.
upload_time

Timestamp

Apenas saída. Hora em que o upload da imagem foi feito.
places[]

Place

Opcional. Lugares a que esta foto pertence.
view_count

int64

Apenas saída. Contagem de visualizações da foto.
transfer_status

TransferStatus

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

MapsPublishStatus

Apenas saída. Status no Google Maps, se esta 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 por meio do 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 esteve em uma transferência.
PENDING A transferência da foto foi iniciada, mas o destinatário ainda não respondeu.
COMPLETED A transferência da foto foi concluída. A foto foi transferida para o destinatário.
REJECTED O destinatário recusou esta transferência de foto.
EXPIRED A transferência da foto expirou antes de o destinatário realizar qualquer ação.
CANCELLED O remetente cancelou esta transferência de foto.
RECEIVED_VIA_TRANSFER O destinatário é o proprietário desta foto devido a uma transferência de direitos.

PhotoId

Identificador de uma Photo.

Campos
id

string

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

O 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 foi 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 forma assíncrona.
photos[]

Photo

Apenas saída. Fotos com marcações de tempo crescentes.
upload_reference

UploadRef

Somente 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 momento de início do vídeo. Se esse campo for preenchido na entrada, ele substituirá o horário da 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

Somente entrada. Medidas de GPS brutas com marcações de tempo crescentes do dispositivo que não são sincronizadas com cada foto. Essas medidas brutas serão usadas para inferir a posição de cada frame. Obrigatório na entrada quando InputType é VIDEO e as medições brutas de GPS não estão na faixa de metadados de movimento da câmera (CAMM). O usuário pode indicar qual tem precedência usando gps_source se medições brutas de GPS forem fornecidas tanto emraw_gps_timeline quanto em Camera Motion Metadata Track (CAMM).
gps_source

GpsSource

Somente entrada. Seraw_gps_timeline e a Camera Motion Metadata Track (CAMM) tiverem medições de GPS, indique qual tem precedência.
imu

Imu

Somente entrada. Dados de IMU de três eixos para a coleção. 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 equivalentes do CAMM, se houver.
processing_state

ProcessingState

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

ProcessingFailureReason

Apenas saída. Se a sequência process_state = FAILED, ela vai conter o motivo da falha. Se o process_state for qualquer outro valor, este campo não será definido.
failure_details

ProcessingFailureDetails

Apenas saída. Se essa sequência tiver failure_reason definido, isso poderá conter mais detalhes 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 nessa 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 do arquivo de upload. Não inclui o caminho do diretório. Disponível apenas se o upload da sequência foi feito em uma plataforma que fornece o nome do arquivo.

GpsSource

Fonte principal de medições de GPS.

Enums
PHOTO_SEQUENCE O GPS no campo "raw_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 houver.

PhotoView

Especifica qual visualização do Photo vai ser incluída na resposta.

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

Lugar

Metadados de lugar para uma entidade.

Campos
place_id

string

Identificador de lugar, conforme descrito em https://developers.google.com/places/place-id.
name

string

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

string

Apenas saída. O language_code com o qual o nome está localizado. Ele deve ser o language_code especificado na solicitação, mas pode ser um substituto.

Posição

Medição da pose bruta de uma entidade.

Campos
lat_lng_pair

LatLng

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

double

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

double

Os seguintes parâmetros de pose estão relacionados ao centro da foto. Eles correspondem a https://developers.google.com/streetview/spherical-metadata. Orientação da bússola, medida no centro da foto, em graus, no sentido horário a partir do Norte. O valor precisa ser maior que 0 e menor que 360. NaN indica uma quantidade não medida.
pitch

double

Inclinação, medida no centro da foto, em graus. O valor precisa ser >=-90 e <= 90. O valor -90 significa olhar diretamente para baixo e o valor 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 nível ao 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 desta posição em metros com 68% de confiança (um desvio padrão). Por exemplo, no Android, esse valor está disponível neste método: https://developer.android.com/reference/android/location/Location#getAccuracy(). Outras plataformas têm métodos diferentes para conseguir estimativas de precisão semelhantes.

ProcessingFailureDetails

Detalhes adicionais para acompanhar o tipo enumerado ProcessingFailureReason. Espera-se sempre que essa mensagem seja usada em conjunto com ProcessingFailureReason, e o valor oneof definido nesta mensagem deve corresponder ao FailureReason.

Campos
Campo de união details. Somente um conjunto de detalhes vai 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 NoSobreposiçãoGpsFailureDetails.

ProcessingFailureReason

Possíveis motivos para a 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 de vídeo é muito pequena.
DUPLICATE Este vídeo já foi enviado anteriormente.
INSUFFICIENT_GPS Há poucos pontos de GPS.
NO_OVERLAP_GPS Não há sobreposição entre o período da trilha de 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 A sequência de fotos não pôde ser localizada com precisão.
TAKEDOWN A sequência foi removida por motivos relacionados à 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 Foi encontrada uma proporção de imagem inválida.
INVALID_CAPTURE_TIME A hora de captura é inválida. As marcações de tempo eram do futuro.
GPS_DATA_GAP Os dados de GPS apresentam um intervalo maior que 5 segundos de duração.
JUMPY_GPS Os dados de GPS estão muito erráticos para serem processados.
INVALID_IMU Os dados de IMU (acelerômetro, giroscópio etc.) não são válidos. Talvez eles não tenham campos obrigatórios (x, y, z ou horário), não estejam formatados corretamente ou qualquer outro problema que impeça a análise pelos nossos sistemas.
INSUFFICIENT_IMU Poucos pontos de IMU.
INSUFFICIENT_OVERLAP_TIME_SERIES Sobreposição insuficiente no período de tempo entre o GPS, a IMU e outros dados de série temporal.
IMU_DATA_GAP Os dados de IMU (acelerômetro, giroscópio etc.) contêm lacunas maiores que 0, 1 segundo.
UNSUPPORTED_CAMERA A câmera não é compatível.
NOT_OUTDOORS Alguns frames estavam em ambientes fechados, o que não é compatível.
INSUFFICIENT_VIDEO_FRAMES Não há frames de vídeo suficientes.
INSUFFICIENT_MOVEMENT Não há dados em movimento suficientes.

ProcessingState

O estado de processamento da sequência. Os estados são movidos da seguinte forma:

     +-------------------------+
     |                         |
 +---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, é 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 ao processar a sequência. Consulte FailureReason para 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. Caso não estejam presentes, os metadados Photo antigos serão completamente substituídos pelos novos metadados 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

Referência de upload 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

A referência de upload deve ser exclusiva para cada usuário. Segue o formato: "https://StreetViewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"