REST Resource: photo

Risorsa: foto

La foto viene utilizzata per archiviare le foto sferiche e i 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. Valore obbligatorio quando viene aggiornata una foto. Vengono restituiti solo durante la creazione di una foto. L'identificatore della foto, che è univoco tra tutte le foto in Google.
uploadReference

object (UploadRef)

Solo input. Obbligatorio quando si crea una foto. Solo input. L'URL della risorsa in cui vengono caricati i byte di foto.
downloadUrl

string

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

string

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

object (Pose)

Campo facoltativo. Posa della foto.
connections[]

object (Connection)

Campo facoltativo. Connessioni ad altre foto. Una connessione rappresenta il link da questa foto a un'altra.
captureTime

string (Timestamp format)

Campo facoltativo. Tempo assoluto in cui è stata acquisita la foto. Quando la foto non ha un timestamp Exif, viene utilizzata per impostare un timestamp nei metadati della foto.

Un timestamp nel formato "Zulu" UTC RFC3339, con una risoluzione di nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
uploadTime

string (Timestamp format)

Solo output. Ora in cui è stata caricata l'immagine.

Un timestamp nel formato "Zulu" UTC RFC3339, con una risoluzione di nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
places[]

object (Place)

Campo facoltativo. Luoghi a cui appartiene questa foto.
viewCount

string (int64 format)

Solo output. Numero di visualizzazioni della foto.
transferStatus

enum (TransferStatus)

Solo output. Lo stato del trasferimento dei diritti su questa foto.
mapsPublishStatus

enum (MapsPublishStatus)

Solo output. Stato di Google Maps, che indica se la foto è stata pubblicata o rifiutata.

ID foto

Identificatore per un Photo.

Rappresentazione JSON 
{
  "id": string
}
Campi
id

string

Un identificatore univoco di una foto.

Rif caricamento

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 ciascun utente. Il formato è il seguente: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

Posa

Misurazione della posa non elaborata 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)

La coppia di latitudine e longitudine della posa, come spiegato qui: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng Quando crei una Photo, se la coppia di latitudine e longitudine non è fornita, viene utilizzata la geolocalizzazione dall'intestazione exif. Una coppia di latitudine e longitudine non fornita nella foto o nell'intestazione Exif impedisce il corretto processo di elaborazione della foto.
altitude

number

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. Intestazione della bussola, misurata al centro della foto in gradi in senso orario rispetto al nord. Il valore deve essere maggiore o uguale a 0 e minore di 360. NaN indica una quantità non misurata.
pitch

number

Presentazione, misurata al centro della foto in gradi. Il valore deve essere >=-90 e <= 90. Un valore di -90 significa guardare verso il basso, mentre un valore di 90 significa guardare in alto direttamente. NaN indica una quantità non misurata.
roll

number

Rotolo, misurato in gradi. Il valore deve essere >= 0 e <360. Il valore 0 indica il livello con l'orizzonte. NaN indica una quantità non misurata.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

L'ora del record GPS a partire dal periodo UTC.

Un timestamp nel formato "Zulu" UTC RFC3339, con una risoluzione di nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
level

object (Level)

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

number

La precisione orizzontale stimata di questa posizione in metri con una certezza 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 accuratezza simili.

LatLng

Un oggetto che rappresenta una coppia latitudine/longitudine. Questo valore è dato da una coppia di doppi per rappresentare i gradi di latitudine e longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono essere compresi negli intervalli normalizzati.

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

number

La latitudine in gradi. Il valore deve essere compreso tra -90,0, +90,0].
longitude

number

La longitudine in gradi. Il valore deve essere compreso tra -180,0 e +180,0.

Livello

Informazioni sul livello contenenti il numero del livello e il nome corrispondente.

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

number

Campo facoltativo. Numero del piano, utilizzato per gli ordini. 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 validi.
name

string

Obbligatorio. Un nome assegnato a questo livello, limitato a 3 caratteri. Valuta come vengono etichettati i pulsanti dell'ascensore per questo livello in caso di ascensore.

Connessione

Una connessione è il link tra una foto di origine e una foto di destinazione.

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

object (PhotoId)

Obbligatorio. La destinazione del collegamento dalla foto che lo contiene a un'altra foto.

Luogo

Posizionare i metadati per un'entità.

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

string

Identificatore luogo, come descritto in https://developers.google.com/places/place-id.
name

string

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

string

Solo output. Il languageCode con cui viene localizzato il nome. Deve essere il languageCode specificato nella richiesta, ma potrebbe essere un elemento di riserva.

Stato trasferimento

Stato del trasferimento dei diritti.

Enum
TRANSFER_STATUS_UNKNOWN Lo stato di questo trasferimento non è specificato.
NEVER_TRANSFERRED Questa foto non è mai stata trasferita.
PENDING Il trasferimento della 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 della foto è scaduto prima che il destinatario intraprendesse un'azione.
CANCELLED Il mittente ha annullato questo trasferimento di foto.
RECEIVED_VIA_TRANSFER Il destinatario è proprietario di questa foto a causa di un trasferimento di diritti.

Stato pubblicazione Maps

Stato di pubblicazione della foto in Google Maps.

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

Metodi

create

 Una volta che il cliente ha terminato di caricare la foto con l'oggetto UploadRef restituito, CreatePhoto pubblica l'elemento Photo caricato su Street View su Google Maps.

delete

 Elimina un Photo e i relativi metadati.

get

 Visualizza i metadati dell'elemento Photo specificato.

startUpload

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

update

 Aggiorna i metadati di un Photo, ad esempio la posizione, l'associazione del luogo, le connessioni e così via