REST Resource: photo

Recurso: foto

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

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. Gerar resposta apenas ao criar uma foto. O 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 para onde os bytes da foto são enviados.

downloadUrl

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.

thumbnailUrl

string

Apenas saída. O URL de miniatura para mostrar uma visualização da foto em questão.

pose

object (Pose)

Opcional. Posição da foto.

connections[]

object (Connection)

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

captureTime

string (Timestamp format)

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.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

uploadTime

string (Timestamp format)

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

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

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, se esta foto foi publicada ou rejeitada.

PhotoId

Identificador de uma Photo.

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

string

Identificador exclusivo de uma foto.

UploadRef

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

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

Posição

Medição da pose bruta de 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 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

number

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

heading

number

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

number

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

number

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.

gpsRecordTimestampUnixEpoch

string (Timestamp format)

Hora do registro GPS desde a época UTC.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

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 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.

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. Salvo indicação em contrário, esse objeto precisa estar em conformidade com 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 do nível e o nome correspondente.

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

number

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.

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 a contém com outra foto.

Lugar

Metadados de lugar 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 local, localizado no languageCode.

languageCode

string

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

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.

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.

Métodos

create

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.

delete

Exclui um Photo e os metadados dele.

get

Recebe os metadados do Photo especificado.

startUpload

Cria uma sessão de upload para iniciar o upload de bytes de fotos.

update

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