REST Resource: photo

Risorsa: Foto

Foto viene utilizzato per archiviare le foto sferiche insieme ai metadati delle foto.

Rappresentazione 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)
}
Campi
photoId

object (PhotoId)

Obbligatorio. Solo output. Obbligatorio quando viene aggiornata una foto. Solo output durante la creazione di una foto. Identificatore della foto, univoco tra tutte le foto su Google.
uploadReference

object (UploadRef)

Solo input. Obbligatorio durante la creazione di una foto. Solo input. L'URL della risorsa in cui vengono caricati i byte della foto.
downloadUrl

string

Solo output. L'URL di download dei byte della foto. Questo campo viene impostato solo quando GetPhotoRequest.view è impostato su PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnailUrl

string

Solo output. L'URL della miniatura per mostrare un'anteprima della foto specificata.
pose

object (Pose)

Facoltativo. Posa della foto.
connections[]

object (Connection)

Facoltativo. Connessioni ad altre foto. Una connessione rappresenta il collegamento tra questa foto e un'altra.
captureTime

string (Timestamp format)

Facoltativo. Ora assoluta in cui è stata acquisita la foto. Quando la foto non ha un timestamp EXIF, questo viene utilizzato per impostare un timestamp nei metadati della foto.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
uploadTime

string (Timestamp format)

Solo output. L'ora in cui è stata caricata l'immagine.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
places[]

object (Place)

Facoltativo. I luoghi a cui appartiene questa foto.
viewCount

string (int64 format)

Solo output. Numero di visualizzazioni della foto.
transferStatus

enum (TransferStatus)

Solo output. Stato del trasferimento dei diritti su questa foto.
mapsPublishStatus

enum (MapsPublishStatus)

Solo output. Stato in Google Maps, ovvero se la foto è stata pubblicata o rifiutata.

PhotoId

Identificatore per un Photo.

Rappresentazione JSON 
{
  "id": string
}
Campi
id

string

Un identificatore univoco per una foto.

UploadRef

Carica il riferimento per i file multimediali.

Rappresentazione 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.
}
Campi
Campo unione file_source. Obbligatorio. file_source può essere solo uno dei seguenti:
uploadUrl

string

Un riferimento di caricamento deve essere univoco per ogni utente. Segue il formato: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

Posa

Misurazione della postura grezza per un'entità.

Rappresentazione JSON 
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
Campi
latLngPair

object (LatLng)

Coppia di latitudine e longitudine della posa, come spiegato qui: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Quando crei un Photo, se la coppia di latitudine e longitudine non viene fornita, viene utilizzata la geolocalizzazione dall'intestazione EXIF. Una coppia di latitudine e longitudine non fornita nell'intestazione della foto o EXIF causa l'errore di elaborazione della foto.
altitude

number

L'altitudine della posa in metri sopra l'ellissoide WGS84. NaN indica una quantità non misurata.
heading

number

I seguenti parametri di posa si riferiscono al centro della foto. Corrispondono a https://developers.google.com/streetview/spherical-metadata. Orientamento della bussola, misurato al centro della foto in gradi in senso orario da nord. Il valore deve essere maggiore o uguale a 0 e minore di 360. NaN indica una quantità non misurata.
pitch

number

Angolazione, misurata al centro della foto in gradi. Il valore deve essere compreso tra -90 e 90. Un valore di -90 indica che la visuale è diretta verso il basso, mentre un valore di 90 indica che la visuale è diretta verso l'alto. NaN indica una quantità non misurata.
roll

number

Rollio, misurato in gradi. Il valore deve essere maggiore o uguale a 0 e minore di 360. Un valore pari a 0 indica il livello dell'orizzonte. NaN indica una quantità non misurata.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

Ora della registrazione GPS dall'epoca UTC.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
level

object (Level)

Livello (il piano di un edificio) utilizzato per configurare la navigazione verticale.
accuracyMeters

number

La precisione orizzontale stimata di questa posa in metri con un'affidabilità del 68% (una deviazione standard). Ad esempio, su Android questo valore è disponibile da questo metodo: https://developer.android.com/reference/android/location/Location#getAccuracy(). Altre piattaforme hanno metodi diversi per ottenere stime di precisione simili.

LatLng

Un oggetto che rappresenta una coppia di coordinate di latitudine e longitudine. Questo valore è espresso come una coppia di numeri double per rappresentare i gradi di latitudine e longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono rientrare negli intervalli normalizzati.

Rappresentazione JSON 
{
  "latitude": number,
  "longitude": number
}
Campi
latitude

number

La latitudine in gradi. Deve essere compresa nell'intervallo [-90,0, +90,0].
longitude

number

La longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0].

Livello

Informazioni sul livello, tra cui il numero del livello e il nome corrispondente.

Rappresentazione JSON 
{
  "number": number,
  "name": string
}
Campi
number

number

Facoltativo. Numero del piano, utilizzato per l'ordinamento. 0 indica il livello del suolo, 1 indica il primo livello sopra il livello del suolo, -1 indica il primo livello sotto il livello del suolo. I valori non interi sono accettabili.
name

string

Obbligatorio. Un nome assegnato a questo livello, limitato a 3 caratteri. Considera come verrebbero etichettati i pulsanti dell'ascensore per questo livello se fosse presente un ascensore.

Connessione

Una connessione è il collegamento da una foto di origine a una foto di destinazione.

Rappresentazione JSON 
{
  "target": {
    object (PhotoId)
  }
}
Campi
target

object (PhotoId)

Obbligatorio. La destinazione della connessione dalla foto contenente a un'altra foto.

Luogo

Posiziona i metadati per un'entità.

Rappresentazione JSON 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
Campi
placeId

string

Identificatore del luogo, come descritto all'indirizzo https://developers.google.com/places/place-id.
name

string

Solo output. Il nome del luogo, localizzato in base a languageCode.
languageCode

string

Solo output. Il codice lingua con cui è localizzato il nome. Deve essere il codice lingua specificato nella richiesta, ma potrebbe essere un fallback.

TransferStatus

Stato del trasferimento dei diritti.

Enum
TRANSFER_STATUS_UNKNOWN Lo stato di questo trasferimento non è specificato.
NEVER_TRANSFERRED Questa foto non è mai stata inclusa in un trasferimento.
PENDING Questo trasferimento di foto è stato avviato, ma il destinatario non ha ancora risposto.
COMPLETED Il trasferimento della foto è stato completato e la foto è stata trasferita al destinatario.
REJECTED Il destinatario ha rifiutato questo trasferimento di foto.
EXPIRED Il trasferimento di foto è scaduto prima che il destinatario eseguisse qualsiasi azione.
CANCELLED Il mittente ha annullato il trasferimento di questa foto.
RECEIVED_VIA_TRANSFER Il destinatario è proprietario di questa foto a seguito di un trasferimento dei diritti.

MapsPublishStatus

Stato di pubblicazione della foto in Google Maps.

Enum
UNSPECIFIED_MAPS_PUBLISH_STATUS Lo stato della foto è sconosciuto.
PUBLISHED La foto viene pubblicata pubblicamente tramite Google Maps.
REJECTED_UNKNOWN La foto è stata rifiutata per un motivo sconosciuto.

Metodi

create

 Dopo che il cliente ha terminato il caricamento della foto con il UploadRef restituito, CreatePhoto pubblica il Photo caricato su Street View su Google Maps.

delete

 Elimina un Photo e i relativi metadati.

get

 Recupera i metadati del Photo specificato.

startUpload

 Crea una sessione di caricamento per iniziare a caricare i byte delle foto.

update

 Aggiorna i metadati di un Photo, ad esempio posa, associazione di luoghi, connessioni e così via.