REST Resource: photo

Risorsa: foto

La foto viene utilizzata 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 aggiorni una foto. Vengono generati solo quando si crea una foto. Identificatore della foto, univoco tra tutte le foto su Google.

uploadReference

object (UploadRef)

Solo input. Obbligatorio quando crei 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 è impostato solo quando il criterio GetPhotoRequest.view è impostato su PhotoView.INCLUDE_DOWNLOAD_URL.

thumbnailUrl

string

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

pose

object (Pose)

(Facoltativo) Posa della foto.

connections[]

object (Connection)

(Facoltativo) Collegamenti con altre foto. Una connessione rappresenta il collegamento di questa foto a un'altra foto.

captureTime

string (Timestamp format)

(Facoltativo) Tempo assoluto in cui è stata scattata la foto. Se la foto non ha un timestamp EXIF, questo viene utilizzato per impostare un timestamp nei metadati della foto.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in 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. L'ora in cui l'immagine è stata caricata.

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

places[]

object (Place)

(Facoltativo) 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, indica se questa foto è stata pubblicata o rifiutata.

PhotoId

Identificatore per Photo.

Rappresentazione JSON
{
  "id": string
}
Campi
id

string

Un identificatore univoco di una foto.

UploadRef

Riferimento per il caricamento dei 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 al caricamento deve essere univoco per ogni utente. Segue il formato: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

Posa

Misurazione della posa non elaborata di 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 un Photo, se non viene fornita la coppia latitudine e longitudine, viene utilizzata la geolocalizzazione dell'intestazione exif. Se la coppia latitudine e longitudine non è specificata nella foto o nell'intestazione EXIF, la procedura relativa alle foto non viene completata correttamente.

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. Direzione della bussola, misurata 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

Tono, misurato in gradi al centro della foto. Il valore deve essere >=-90 e <= 90. -90 significa guardare direttamente verso il basso, mentre 90 significa guardare direttamente dall'alto. NaN indica una quantità non misurata.

roll

number

Rotazione, misurata in gradi. Il valore deve essere maggiore o uguale a 0 e minore di 360. Il valore 0 indica lo stesso livello dell'orizzonte. NaN indica una quantità non misurata.

gpsRecordTimestampUnixEpoch

string (Timestamp format)

Ora del record GPS dall'epoca UTC.

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

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 con 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 è espresso come coppia di doppi per rappresentare i gradi di latitudine e i gradi di 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. Deve essere compreso nell'intervallo [-90,0, +90,0].

longitude

number

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

Livello

Informazioni sul livello contenenti il numero e il nome corrispondente.

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

number

(Facoltativo) Numero di 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. È possibile utilizzare valori non interi.

name

string

Obbligatorio. Un nome assegnato a questo livello, limitato a 3 caratteri. Considera come verrebbero etichettati i pulsanti dell'ascensore se ci fosse 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 del collegamento dalla foto che la contiene a un'altra foto.

Luogo

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

languageCode

string

Solo output. Il languageCode con cui è localizzato il nome. Dovrebbe essere il languageCode 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 trasferita.
PENDING Il trasferimento di foto è stato avviato, ma il destinatario non ha ancora risposto.
COMPLETED Il trasferimento delle foto è stato completato e questa foto è stata trasferita al destinatario.
REJECTED Il destinatario ha rifiutato il trasferimento di questa foto.
EXPIRED Il trasferimento delle foto è scaduto prima che il destinatario intraprendesse qualsiasi azione.
CANCELLED Il mittente ha annullato il trasferimento di questa foto.
RECEIVED_VIA_TRANSFER Il destinatario possiede questa foto a causa 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 di caricare la foto con l'oggetto UploadRef restituito, CreatePhoto pubblica su Street View la Photo caricata su Google Maps.

delete

Elimina un elemento Photo e i relativi metadati.

get

Restituisce i metadati dell'elemento Photo specificato.

startUpload

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

update

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