REST Resource: photo

Recurso: Photo

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

Representação JSON 
{
  "photoId": {
    object (PhotoId)
  },
  "uploadReference": {
    object (UploadRef)
  },
  "downloadUrl": string,
  "thumbnailUrl": string,
  "shareLink": string,
  "pose": {
    object (Pose)
  },
  "connections": [
    {
      object (Connection)
    }
  ],
  "captureTime": string,
  "uploadTime": string,
  "places": [
    {
      object (Place)
    }
  ],
  "viewCount": string,
  "transferStatus": enum (TransferStatus),
  "mapsPublishStatus": enum (MapsPublishStatus)
}
Campos
photoId

object (PhotoId)

Obrigatório. Apenas saída. Obrigatório ao atualizar uma foto. Saída somente ao criar uma foto. Identificador da foto, que é exclusivo entre todas as fotos no Google.
uploadReference

object (UploadRef)

Somente entrada. Obrigatório ao criar uma foto. Somente entrada. O URL do recurso em que os bytes da foto são enviados.
downloadUrl

string

Apenas saída. O URL de download dos bytes da foto. Esse campo só é definido quando GetPhotoRequest.view está definido como PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnailUrl

string

Apenas saída. O URL da miniatura para mostrar uma prévia da foto.
pose

object (Pose)

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

object (Connection)

Opcional. Conexões com outras fotos. Uma conexão representa o link de uma foto para outra.
captureTime

string (Timestamp format)

Opcional. Tempo absoluto em que a foto foi capturada. Quando a foto não tem um carimbo de data/hora exif, ele é usado para definir um carimbo de data/hora nos metadados da foto.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
uploadTime

string (Timestamp format)

Apenas saída. O horário em que a imagem foi enviada.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
places[]

object (Place)

Opcional. Lugares a que esta foto pertence.
viewCount

string (int64 format)

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

enum (TransferStatus)

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

enum (MapsPublishStatus)

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

PhotoId

Identificador de um Photo.

Representação JSON 
{
  "id": string
}
Campos
id

string

Um identificador exclusivo de uma foto.

UploadRef

Upload de referência para arquivos de mídia.

Representação JSON 
{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}
Campos
Campo de união file_source. Obrigatório. file_source pode ser apenas de um dos tipos a seguir:
uploadUrl

string

Uma referência de upload precisa ser exclusiva para cada usuário. Ele segue o formato: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

Pose

Medição bruta de postura para uma entidade.

Representação JSON 
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
Campos
latLngPair

object (LatLng)

Par de latitude e longitude da postura, 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 EXIF causa falha no processo da foto.
altitude

number

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

number

Os parâmetros de postura a seguir se referem 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

number

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

number

Rotação, medida em graus. O valor precisa ser maior ou igual a 0 e menor que 360. Um valor de 0 significa nivelado com o horizonte. NaN indica uma quantidade não medida.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

Horário do registro do GPS desde a época UTC.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
level

object (Level)

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

number

A precisão horizontal estimada dessa postura 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 obter estimativas de acurácia semelhantes.

LatLng

Um objeto que representa um par de latitude/longitude. Ele é expresso como um par de valores duplos para representar graus de latitude e longitude. A menos que especificado de outra forma, esse objeto precisa seguir o padrão WGS84. Os valores precisam estar dentro de intervalos normalizados.

Representação JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].
longitude

number

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

Nível

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

Representação JSON 
{
  "number": number,
  "name": string
}
Campos
number

number

Opcional. Número do andar, usado para ordenação. 0 indica o nível do solo, 1 indica o primeiro nível acima do nível do solo e -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, limitado a três caracteres. Considere como os botões do elevador seriam rotulados para esse nível se houvesse um elevador.

Conexão

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

Representação JSON 
{
  "target": {
    object (PhotoId)
  }
}
Campos
target

object (PhotoId)

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

Lugar

Coloca metadados para uma entidade.

Representação JSON 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
Campos
placeId

string

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

string

Apenas saída. O nome do lugar, localizado para o languageCode.
languageCode

string

Apenas saída. O languageCode com que o nome é localizado. Esse deve ser o languageCode especificado na solicitação, mas pode ser um substituto.

TransferStatus

Status da transferência de direitos.

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

MapsPublishStatus

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

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

Métodos

create

 Depois que o cliente terminar de fazer upload da foto com o UploadRef retornado, o CreatePhoto vai publicar o Photo enviado no Street View do Google Maps.

delete

 Exclui um Photo e os metadados dele.

get

 Recebe os metadados do Photo especificado.

startUpload

 Cria uma sessão de upload para começar a fazer upload de bytes de fotos.

update

 Atualiza os metadados de um Photo, como postura, associação de lugar, conexões etc.