REST Resource: photo

Ressource: Photo

Photo permet de stocker des photos à 360° ainsi que leurs métadonnées.

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 lors de la modification d'une photo. Uniquement en sortie lors de la création d'une photo. Identifiant unique de toutes les photos sur Google.
uploadReference

object (UploadRef)

Uniquement en entrée. Obligatoire lors de la création d'une photo. Uniquement en entrée. URL de la ressource vers laquelle les octets de la photo 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 si GetPhotoRequest.view est défini sur PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnailUrl

string

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

object (Pose)

Facultatif. Photo de la photo.
connections[]

object (Connection)

Facultatif. Connexions à d'autres photos Un lien représente le lien entre cette photo et une autre.
captureTime

string (Timestamp format)

Facultatif. Heure absolue à laquelle la photo a été prise Lorsqu'il n'y a pas d'horodatage exif pour la photo, ce paramètre permet de définir l'horodatage dans les métadonnées de la photo.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. 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 à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
places[]

object (Place)

Facultatif. Lieux auxquels cette photo est associée.
viewCount

string (int64 format)

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

enum (TransferStatus)

Uniquement en sortie. État des droits de transfert sur cette photo.
mapsPublishStatus

enum (MapsPublishStatus)

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

ID de la photo

Identifiant d'une Photo.

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

string

Identifiant unique d'une photo.

Réf. importation

Référence d'importation des 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. Elle se présente sous la forme suivante: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

Posture

Mesure de posture brute 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 latitude/longitude n'est pas fournie, la géolocalisation de l'en-tête exif est utilisée. Une paire latitude/longitude non fournie dans l'en-tête de la photo ou exif entraîne l'échec du processus de photo.
altitude

number

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

number

Les paramètres de position 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. La valeur doit être >=0 et <360. NaN indique une quantité non mesurée.
pitch

number

Inclinaison, mesurée au centre de la photo en degrés. La valeur doit être >= 90 et <= 90. Une valeur de -90 indique une vue directe vers le bas et une valeur de 90 correspond à une recherche directe vers le haut. NaN indique une quantité non mesurée.
roll

number

Roulement, mesuré en degrés. La valeur doit être >= 0 et < 360. La valeur 0 correspond au niveau avec 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 à la nanoseconde et jusqu'à neuf chiffres après la virgule. 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 position en mètres avec un indice de confiance de 68 % (un écart type). Par exemple, sur Android, cette valeur est disponible via la méthode https://developer.android.com/reference/android/location/Location#getAccuracy(). D'autres plates-formes ont des méthodes différentes pour obtenir des estimations de précision similaires.

LatLng

Objet représentant une paire latitude/longitude. Cette valeur 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 du niveau et son nom correspondant.

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

number

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

string

Obligatoire. Nom attribué à ce niveau, limité à 3 caractères. Pensez à la façon dont les boutons d'ascenseur seraient libellés pour ce niveau s'il y avait un ascenseur.

Connexion

Une connexion correspond au 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 parent et une autre.

Lieu

Placez des métadonnées pour une entité.

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

string

Identifiant de lieu, comme décrit dans https://developers.google.com/places/place-id.
name

string

Uniquement en sortie. Nom du lieu, localisé dans le code de langue.
languageCode

string

Uniquement en sortie. Code de langue avec lequel le nom est localisé. Il s'agit du langage de code spécifié dans la requête. Toutefois, il peut s'agir d'un remplacement.

État du transfert

É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 Le transfert de photos a été lancé, mais le destinataire n'a pas encore répondu.
COMPLETED Le transfert de la photo a été effectué et la photo a été transférée au destinataire.
REJECTED Le destinataire a refusé ce transfert de photos.
EXPIRED Le transfert de photos a expiré avant que le destinataire ait effectué une action.
CANCELLED L'expéditeur a annulé le transfert de la photo.
RECEIVED_VIA_TRANSFER Le destinataire est le propriétaire de cette photo en raison d'un transfert de droits.

MapsPublishStatus

État de publication de la photo dans 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 fini d'importer la photo avec les UploadRef renvoyées, CreatePhoto publie les Photo importées dans Street View sur Google Maps.

delete

 Supprime un Photo et ses métadonnées.

get

 Récupère les métadonnées de l'élément 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'une Photo, telles que la position, l'association de lieux, les connexions, etc.