REST Resource: photo

Recurso: foto

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

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 apenas ao criar uma foto. Identificador da foto, que é exclusivo entre todas as fotos no Google.
uploadReference

object (UploadRef)

Apenas entrada. Obrigatório ao criar uma foto. Apenas 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. Este campo é definido apenas quando GetPhotoRequest.view é definido como PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnailUrl

string

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

string (Timestamp format)

Opcional. Tempo absoluto quando a foto foi capturada. Quando a foto não tem um 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 UTC "Zulu" RFC3339, 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 a imagem foi enviada.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, 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 aos quais a 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 sobre esta foto.
mapsPublishStatus

enum (MapsPublishStatus)

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

ID da foto

Identificador de um Photo.

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

string

Um identificador exclusivo de uma foto.

Fazer upload de referência

Referência de upload de 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 deve 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 pose 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 posição, conforme 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 for fornecido, será usada a geolocalização do cabeçalho exif. Um par de latitude e longitude não fornecido no cabeçalho de foto ou exif faz com que o processo de foto falhe.
altitude

number

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

number

Os seguintes parâmetros de posição pertencem ao centro da foto. 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 deve ser >=0 e <360. NaN indica uma quantidade não medida.
pitch

number

Inclinação, medida em graus no centro da foto. O valor deve ser >=-90 e <= 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

Rolo, medido em graus. O valor precisa ser >= 0 e <360. Um valor de 0 significa o nível com o 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 UTC "Zulu" RFC3339, 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 dessa 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 diferentes métodos 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. A menos que seja especificado de outra forma, esse objeto deve 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 de nível que contêm o número do nível e seu nome correspondente.

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

number

Opcional. Número do andar, usado para fazer o pedido. 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 no nível do solo. Valores não inteiros estão corretos.
name

string

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

Conexão

Uma conexão é o link a partir 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 em questão com outra foto.

Lugar

Coloque metadados de uma entidade.

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

string

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

string

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

string

Apenas saída. O languageCode com o qual o nome está localizado. Precisa 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 desta transferência não foi especificado.
NEVER_TRANSFERRED Esta foto nunca foi transferida.
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 recusou esta transferência de fotos.
EXPIRED A transferência da foto expirou antes de o destinatário realizar uma ação.
CANCELLED O remetente cancelou esta transferência de fotos.
RECEIVED_VIA_TRANSFER O destinatário é o proprietário desta foto devido a uma transferência de direitos.

Status da publicação

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

Enums
UNSPECIFIED_MAPS_PUBLISH_STATUS O status da foto é desconhecido.
PUBLISHED A foto é publicada publicamente no Google Maps.
REJECTED_UNKNOWN A foto foi rejeitada por um motivo desconhecido.

Métodos

create

 Depois que o cliente termina de fazer o upload da foto com o UploadRef retornado, o 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 dos bytes de foto.

update

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