REST Resource: photo

Ressource: Photo

L'option "Photo" permet de stocker des photos à 360° avec les métadonnées des photos.

Représentation 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)
}
Champs
photoId

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.
uploadReference

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.
downloadUrl

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.
thumbnailUrl

string

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

object (Pose)

Facultatif. Pose de la photo.
connections[]

object (Connection)

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

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".
uploadTime

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".
places[]

object (Place)

Facultatif. Lieux auxquels cette photo appartient.
viewCount

string (int64 format)

Uniquement en sortie. Nombre de vues de la photo.
transferStatus

enum (TransferStatus)

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

enum (MapsPublishStatus)

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

PhotoId

Identifiant de Photo.

Représentation JSON 
{
  "id": string
}
Champs
id

string

Identifiant unique d'une photo.

UploadRef

Référence d'importation pour les fichiers multimédias.

Représentation 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.
}
Champs
Champ d'union file_source. Obligatoire. file_source ne peut être qu'un des éléments suivants :
uploadUrl

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}".

Pose

Mesure brute des postures pour une entité.

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

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.
altitude

number

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

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.
pitch

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.
roll

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.
gpsRecordTimestampUnixEpoch

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".
level

object (Level)

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

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.

LatLng

Objet représentant une paire latitude/longitude. Elle est exprimée par une paire de doubles représentant les degrés de latitude et de longitude. Sauf indication contraire, cet objet doit être conforme à la norme WGS84. Les valeurs doivent se situer dans les limites normalisées.

Représentation JSON 
{
  "latitude": number,
  "longitude": number
}
Champs
latitude

number

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

number

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

Niveau

Informations sur le niveau contenant le numéro de niveau et le nom correspondant.

Représentation JSON 
{
  "number": number,
  "name": string
}
Champs
number

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.
name

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.

Connexion

Une connexion est le lien entre une photo source et une photo de destination.

Représentation JSON 
{
  "target": {
    object (PhotoId)
  }
}
Champs
target

object (PhotoId)

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

Lieu

Métadonnées de position d'une entité.

Représentation JSON 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
Champs
placeId

string

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

string

Uniquement en sortie. Nom du lieu, localisé selon le code languageCode.
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.

TransferStatus

État du transfert des droits.

Enums
TRANSFER_STATUS_UNKNOWN L'état de ce transfert n'est pas spécifié.
NEVER_TRANSFERRED Cette photo n'a jamais été transférée.
PENDING Ce transfert de photos a été lancé, mais le destinataire n'a pas encore répondu.
COMPLETED La photo a bien été transférée à son destinataire.
REJECTED Le destinataire a refusé le transfert de cette photo.
EXPIRED Le transfert de photos a expiré avant que le destinataire n'ait effectué une action.
CANCELLED L'expéditeur a annulé le transfert de cette photo.
RECEIVED_VIA_TRANSFER Cette photo appartient au destinataire en raison d'un transfert de droits.

MapsPublishStatus

État de publication de la photo sur Google Maps.

Enums
UNSPECIFIED_MAPS_PUBLISH_STATUS L'état de la photo est inconnu.
PUBLISHED La photo est publiée publiquement via Google Maps.
REJECTED_UNKNOWN La photo a été refusée pour une raison inconnue.

Méthodes

create

 Une fois que le client a terminé d'importer la photo avec le UploadRef renvoyé, CreatePhoto publie le Photo importé dans Street View sur Google Maps.

delete

 Supprime un Photo et ses métadonnées.

get

 Récupère les métadonnées du Photo spécifié.

startUpload

 Crée une session d'importation pour commencer à importer des octets de photos.

update

 Met à jour les métadonnées d'un Photo, telles que la pose, l'association de lieu, les connexions, etc.