REST Resource: photo

{
  "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)
}

object (PhotoId)

Obligatoire. Uniquement en sortie. Obligatoire pour la mise à jour d'une photo. Sortie uniquement lors de la création d'une photo. Identifiant de la photo, qui est unique parmi toutes les photos dans Google.

object (UploadRef)

Uniquement en entrée. Obligatoire pour créer une photo. Uniquement en entrée. URL de la ressource dans laquelle les octets des photos sont importés.

string

Uniquement en sortie. URL de téléchargement des octets de la photo. Ce champ n'est défini que lorsque GetPhotoRequest.view est défini sur PhotoView.INCLUDE_DOWNLOAD_URL.

string

Uniquement en sortie. URL de la vignette permettant d'afficher un aperçu de la photo donnée.

string

Uniquement en sortie. Lien de partage de la photo.

object (Pose)

Facultatif. Pose de la photo.

object (Connection)

Facultatif. Liens avec d'autres photos. Une connexion représente le lien entre cette photo et une autre.

string (Timestamp format)

Facultatif. Heure absolue à laquelle la photo a été prise. Lorsque la photo n'a pas de code temporel EXIF, ce paramètre permet de définir un code temporel dans les métadonnées de la photo.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Uniquement en sortie. Heure à laquelle l'image a été importée.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

object (Place)

Facultatif. Lieux auxquels cette photo appartient.

string (int64 format)

Uniquement en sortie. Nombre de vues de la photo.

enum (TransferStatus)

Uniquement en sortie. État du transfert des droits pour cette photo.

enum (MapsPublishStatus)

Uniquement en sortie. État dans Google Maps, que la photo ait été publiée ou refusée.

{
  "id": string
}

string

Identifiant unique d'une photo.

{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}

string

Une référence d'importation doit être unique pour chaque utilisateur. Il se présente sous la forme suivante : "https://Streetpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}".

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

object (LatLng)

Paire de latitude et longitude de la position, comme expliqué ici: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Lorsque vous créez une Photo, si la paire de latitude et de longitude n'est pas fournie, la géolocalisation de l'en-tête exif est utilisée. Une paire latitude/longitude non fournie dans la photo ou dans l'en-tête EXIF entraîne l'échec du processus photo.

number

Altitude de la pose en mètres au-dessus de l'ellipsoïde WGS84. NaN indique une quantité non mesurée.

number

Les paramètres de pose suivants concernent le centre de la photo. Elles correspondent à https://developers.google.com/streetview/spherical-metadata. Direction de la boussole, mesurée au centre de la photo en degrés dans le sens des aiguilles d'une montre à partir du nord. Ces valeurs doivent être comprises entre 1 et 360. NaN indique une quantité non mesurée.

number

Inclinaison, mesurée au centre de la photo en degrés. Cette valeur doit être supérieure ou égale à -90 et inférieure ou égale à 90. Une valeur de -90 signifie de regarder directement vers le bas, et une valeur de 90 de regarder directement vers le haut. NaN indique une quantité non mesurée.

number

Roulis (en degrés). Cette valeur doit être supérieure ou égale à 0 et inférieure à 360. Une valeur de 0 signifie qu'il se situe au niveau de l'horizon. NaN indique une quantité non mesurée.

string (Timestamp format)

Heure de l'enregistrement GPS depuis l'epoch UTC.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

object (Level)

Niveau (étage d'un bâtiment) utilisé pour configurer la navigation verticale.

number

Précision horizontale estimée de cette pose, exprimée en mètres, avec un indice de confiance de 68 % (un écart type). Par exemple, sur Android, cette valeur est disponible à partir de cette méthode: https://developer.android.com/reference/android/location/Location#getAccuracy(). D'autres plateformes utilisent différentes méthodes pour obtenir des estimations de justesse similaires.

{
  "latitude": number,
  "longitude": number
}

number

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].

number

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

{
  "number": number,
  "name": string
}

number

Facultatif. Numéro d'étage, utilisé pour la commande. 0 indique le niveau du sol, 1 indique le premier niveau au-dessus du sol, -1 indique le premier niveau sous le niveau du sol. Les valeurs non entières sont acceptées.

string

Obligatoire. Nom attribué à ce niveau, limité à trois caractères. Réfléchissez à la façon dont les boutons de l'ascenseur seraient libellés à ce niveau s'il y avait un ascenseur.

{
  "target": {
    object (PhotoId)
  }
}

object (PhotoId)

Obligatoire. Destination de la connexion entre la photo associée et une autre photo.

{
  "placeId": string,
  "name": string,
  "languageCode": string
}

string

Identifiant de lieu, tel que décrit sur la page https://developers.google.com/places/place-id.

string

Uniquement en sortie. Nom du lieu, localisé selon le code languageCode.

string

Uniquement en sortie. languageCode avec lequel le nom est localisé. Il doit s'agir du code languageCode spécifié dans la requête, mais il peut s'agir d'une valeur de remplacement.