REST Resource: photo

Ressource : Photo

Photo est utilisé pour stocker les 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 de la photo, unique parmi toutes les photos de 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 lorsque GetPhotoRequest.view est défini sur PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnailUrl

string

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

object (Pose)

Facultatif. Pose de la photo.
connections[]

object (Connection)

Facultatif. Connexions à d'autres photos. Une association 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 ne comporte pas d'horodatage exif, celui-ci est utilisé pour définir un horodatage dans les métadonnées de la photo.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
uploadTime

string (Timestamp format)

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

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
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 sur cette photo.
mapsPublishStatus

enum (MapsPublishStatus)

Uniquement en sortie. État dans Google Maps (photo publiée ou refusée).

PhotoId

Identifiant d'un Photo.

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

string

Identifiant unique d'une photo.

UploadRef

Importer des références 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://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

Pose

Mesure brute de la pose 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 latitude/longitude de la pose, comme expliqué ici : https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Lorsque vous créez un Photo, si la paire latitude/longitude n'est pas fournie, la géolocalisation de l'en-tête exif est utilisée. Si une paire latitude/longitude n'est pas fournie dans la photo ou l'en-tête EXIF, le traitement de la photo échoue.
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. Cap de la boussole, mesuré au centre de la photo en degrés dans le sens des aiguilles d'une montre à partir du nord. La valeur doit être supérieure ou égale à 0 et inférieure à 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 comprise entre -90 et 90. Une valeur de -90 signifie que la caméra est orientée directement vers le bas, et une valeur de 90 signifie qu'elle est orientée directement vers le haut. NaN indique une quantité non mesurée.
roll

number

Inclinaison latérale, mesurée en degrés. La valeur doit être supérieure ou égale à 0 et inférieure à 360. Une valeur de 0 signifie que l'appareil est à l'horizontale. NaN indique une quantité non mesurée.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

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

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
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 en mètres avec une confiance de 68 % (un écart-type). Par exemple, sur Android, cette valeur est disponible à partir de la méthode https://developer.android.com/reference/android/location/Location#getAccuracy(). D'autres plates-formes utilisent différentes méthodes 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, y compris le numéro et le nom correspondant.

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

number

Facultatif. Numéro d'étage utilisé pour le tri. 0 indique le niveau du sol, 1 indique le premier niveau au-dessus du niveau du sol et -1 indique le premier niveau en dessous du 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 pour ce niveau s'il y en avait un.

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 contenant et une autre photo.

Lieu

Placer les métadonnées d'une entité.

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

string

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

string

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

string

Uniquement en sortie. Code de langue dans lequel le nom est localisé. Il doit s'agir du languageCode spécifié dans la requête, mais il peut s'agir d'une langue 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 Le transfert de photos a été initié, mais le destinataire n'a pas encore répondu.
COMPLETED Le transfert de la photo est terminé. Elle a été transférée au destinataire.
REJECTED Le destinataire a refusé le transfert de cette photo.
EXPIRED Le transfert de photos a expiré avant que le destinataire n'effectue une action.
CANCELLED L'expéditeur a annulé le transfert de cette photo.
RECEIVED_VIA_TRANSFER Le destinataire est 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 en mode public sur 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

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