- Recurso: Foto
- PhotoId
- UploadRef
- Posição
- LatLng
- Nível
- Conexão
- Lugar
- TransferStatus (em inglês)
- MapsPublishStatus.
- Métodos
Recurso: foto
A foto é usada para armazenar fotos em 360° com metadados de fotos.
Representação JSON |
---|
{ "photoId": { object ( |
Campos | |
---|---|
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 |
Apenas entrada. Obrigatório ao criar uma foto. Apenas entrada. O URL do recurso em que os bytes da foto são enviados. |
downloadUrl |
Apenas saída. O URL de download dos bytes da foto. Este campo é definido apenas quando |
thumbnailUrl |
Apenas saída. O URL em miniatura para mostrar uma visualização da foto especificada. |
shareLink |
Apenas saída. O link de compartilhamento da foto. |
pose |
Opcional. Posição da foto. |
connections[] |
Opcional. Conexões com outras fotos. Uma conexão representa o link desta foto para outra foto. |
captureTime |
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: |
uploadTime |
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: |
places[] |
Opcional. Lugares aos quais a foto pertence. |
viewCount |
Apenas saída. Contagem de visualizações da foto. |
transferStatus |
Apenas saída. Status da transferência de direitos sobre esta foto. |
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 |
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 |
Campos | |
---|---|
Campo de união file_source . Obrigatório. file_source pode ser apenas de um dos tipos a seguir: |
|
uploadUrl |
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 ( |
Campos | |
---|---|
latLngPair |
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 |
altitude |
Altitude da pose em metros acima do elipsoide WGS84. NaN indica uma quantidade não medida. |
heading |
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 |
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 |
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 |
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: |
level |
Nível (o andar de um edifício) usado para configurar a navegação vertical. |
accuracyMeters |
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 |
A latitude em graus. Precisa estar no intervalo [-90,0, +90,0]. |
longitude |
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 |
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 |
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 ( |
Campos | |
---|---|
target |
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 |
Identificador de local, conforme descrito em https://developers.google.com/places/place-id. |
name |
Apenas saída. O nome do lugar, localizado para languageCode. |
languageCode |
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 |
|
---|---|
|
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. |
|
Exclui um Photo e os metadados dele. |
|
Recebe os metadados do Photo especificado. |
|
Cria uma sessão de upload para iniciar o upload dos bytes de foto. |
|
Atualiza os metadados de um Photo , como pose, associação de lugar, conexões etc. |