Package google.streetview.publish.v1

Index

StreetViewPublishService

Publication et association des photos fournies par les utilisateurs sur Street View

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Supprime une liste de Photos et leurs métadonnées.

Notez que si BatchDeletePhotos échoue, des champs critiques sont manquants ou une erreur d'authentification se produit. Même si BatchDeletePhotos réussit, des photos individuelles du lot peuvent présenter des défaillances. Ces échecs sont spécifiés dans chaque PhotoResponse.status du fichier BatchDeletePhotosResponse.results. Consultez la section DeletePhoto pour connaître les défaillances spécifiques qui peuvent se produire pour chaque photo.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

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

Notez que si la méthode BatchGetPhotos échoue, des champs critiques sont manquants ou une erreur d'authentification se produit. Même si BatchGetPhotos réussit, des photos individuelles du lot peuvent présenter des défaillances. Ces échecs sont spécifiés dans chaque PhotoResponse.status du fichier BatchGetPhotosResponse.results. Consultez la section GetPhoto pour connaître les défaillances spécifiques qui peuvent se produire pour chaque photo.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

Met à jour les métadonnées de Photos, telles que la pose, l'association de lieu, les connexions, etc. La modification des pixels des photos n'est pas acceptée.

Notez que si la méthode BatchUpdatePhotos échoue, des champs critiques sont manquants ou une erreur d'authentification se produit. Même si BatchUpdatePhotos réussit, des photos individuelles du lot peuvent présenter des défaillances. Ces échecs sont spécifiés dans chaque PhotoResponse.status du fichier BatchUpdatePhotosResponse.results. Consultez la section UpdatePhoto pour connaître les défaillances spécifiques qui peuvent se produire pour chaque photo.

Seuls les champs spécifiés dans le champ updateMask sont utilisés. Si updateMask n'est pas présent, la mise à jour s'applique à tous les champs.

Le nombre de messages UpdatePhotoRequest dans une BatchUpdatePhotosRequest ne doit pas dépasser 20.

Remarque: Pour mettre à jour Pose.altitude, Pose.latLngPair doit également être renseigné. À défaut, la requête échouera.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

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.

Actuellement, le seul moyen de définir l'orientation, la hauteur et le lancer de lancer dans CreatePhoto est d'utiliser les métadonnées XMP Photo Sphere dans les octets de la photo. CreatePhoto ignore les champs pose.heading, pose.pitch, pose.roll, pose.altitude et pose.level dans la posture.

Cette méthode renvoie les codes d'erreur suivants:

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

Une fois que le client a terminé d'importer le PhotoSequence avec le UploadRef renvoyé, CreatePhotoSequence extrait une séquence de photos à 360° d'une vidéo ou d'une métadonnée Extensible Device Metadata (XDM, http://www.xdm.org/) pour la publier dans Street View sur Google Maps.

CreatePhotoSequence renvoie un Operation, avec l'ID PhotoSequence défini dans le champ Operation.name.

Cette méthode renvoie les codes d'erreur suivants:

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

Supprime un Photo et ses métadonnées.

Cette méthode renvoie les codes d'erreur suivants:

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

Supprime un PhotoSequence et ses métadonnées.

Cette méthode renvoie les codes d'erreur suivants:

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

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

Cette méthode renvoie les codes d'erreur suivants:

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

Récupère les métadonnées du PhotoSequence spécifié via l'interface Operation.

Cette méthode renvoie les trois types de réponses suivants:

  • Operation.done = "false", si le traitement de PhotoSequence n'est pas encore terminé.
  • Operation.done = "true" et Operation.error est renseigné si une erreur s'est produite lors du traitement.
  • Operation.done = true et Operation.response est pondéré, lequel contient un message PhotoSequence.

Cette méthode renvoie les codes d'erreur suivants:

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

Répertorie tous les PhotoSequences qui appartiennent à l'utilisateur, dans l'ordre décroissant des codes temporels CreatePhotoSequence.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

Liste tous les Photos qui appartiennent à l'utilisateur.

Remarque: Les photos créées récemment qui sont toujours en cours d'indexation ne sont pas renvoyées dans la réponse.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

Crée une session d'importation pour commencer à importer des données de séquence photo. L'URL d'importation du UploadRef renvoyé est utilisée pour importer les données pour photoSequence.

Une fois l'importation terminée, UploadRef est utilisé avec CreatePhotoSequence pour créer l'entrée d'objet PhotoSequence.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
StartUpload

rpc StartUpload(Empty) returns (UploadRef)

Crée une session d'importation pour commencer à importer des octets de photos. La méthode utilise l'URL d'importation du UploadRef renvoyé pour importer les octets du Photo.

En plus des exigences concernant les photos indiquées sur la page https://support.google.com/maps/answer/7012050?ref_topic=6275604, les photos doivent respecter les conditions suivantes:

Une fois l'importation terminée, la méthode utilise UploadRef avec CreatePhoto pour créer l'entrée d'objet Photo.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

Met à jour les métadonnées d'une Photo, telles que la pose, l'association de lieu, les connexions, etc. Il n'est pas possible de modifier les pixels d'une photo.

Seuls les champs spécifiés dans le champ updateMask sont utilisés. Si updateMask n'est pas présent, la mise à jour s'applique à tous les champs.

Cette méthode renvoie les codes d'erreur suivants:

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/streetviewpublish

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

BatchDeletePhotosRequest

Demande de suppression de plusieurs Photos.

Champs
photo_ids[]

string

Obligatoire. ID de Photos. Les requêtes HTTP GET nécessitent la syntaxe suivante pour le paramètre de requête d'URL: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

Réponse à la suppression groupée d'un ou de plusieurs Photos.

Champs
status[]

Status

État de l'opération de suppression d'un seul élément Photo dans la requête par lot.

BatchGetPhotosRequest

Demandez à obtenir un ou plusieurs Photos. Activé par défaut

  • ne renvoie pas l'URL de téléchargement des octets de la photo.

Paramètres :

  • view détermine si l'URL de téléchargement des octets de photo est renvoyée.
Champs
photo_ids[]

string

Obligatoire. ID de Photos. Pour les requêtes HTTP GET, le paramètre de requête d'URL doit être photoIds=<id1>&photoIds=<id2>&....
view

PhotoView

Obligatoire. Spécifie si une URL de téléchargement des octets de photo doit être renvoyée dans la réponse Photo.
language_code

string

Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Si language_code n'est pas spécifié, la préférence linguistique de l'utilisateur pour les services Google est utilisée.

BatchGetPhotosResponse

Réponse à la requête "get" par lot de Photos.

Champs
results[]

PhotoResponse

Liste des résultats pour chaque Photo individuel demandé, dans le même ordre que les requêtes dans BatchGetPhotos.

BatchUpdatePhotosRequest

Requête de mise à jour des métadonnées des photos. La mise à jour des pixels des photos n'est pas prise en charge.

Champs
update_photo_requests[]

UpdatePhotoRequest

Obligatoire. Liste de UpdatePhotoRequests.

BatchUpdatePhotosResponse

Réponse à la mise à jour par lot des métadonnées d'un ou de plusieurs Photos.

Champs
results[]

PhotoResponse

Liste des résultats pour chaque Photo mis à jour, dans le même ordre que la requête.

Connexion

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

Champs
target

PhotoId

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

CreatePhotoRequest

Requête de création d'un Photo.

Champs
photo

Photo

Obligatoire. Photo à créer.

CreatePhotoSequenceRequest

Demande de création d'un PhotoSequence à partir d'une vidéo.

Champs
photo_sequence

PhotoSequence

Obligatoire. PhotoSequence à créer.
input_type

InputType

Obligatoire. Forme d'entrée de PhotoSequence.

InputType

Formulaires de saisie de PhotoSequence.

Enums
INPUT_TYPE_UNSPECIFIED Non spécifié. Le serveur renvoie google.rpc.Code.INVALID_ARGUMENT.
VIDEO Vidéo à 360°.
XDM Extensible Device Metadata, http://www.xdm.org

DeletePhotoRequest

Requête de suppression d'un Photo.

Champs
photo_id

string

Obligatoire. ID de Photo.

DeletePhotoSequenceRequest

Requête de suppression d'un PhotoSequence.

Champs
sequence_id

string

Obligatoire. ID de PhotoSequence.

GetPhotoRequest

Requête d'obtention d'un Photo.

Activé par défaut

  • ne renvoie pas l'URL de téléchargement des octets de la photo.

Paramètres :

  • view détermine si l'URL de téléchargement des octets de photo est renvoyée.
Champs
photo_id

string

Obligatoire. ID de Photo.
view

PhotoView

Obligatoire. Spécifie si une URL de téléchargement des octets de photo doit être renvoyée dans la réponse Photo.
language_code

string

Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Si language_code n'est pas spécifié, la préférence linguistique de l'utilisateur pour les services Google est utilisée.

GetPhotoSequenceRequest

Requête d'obtention d'un PhotoSequence.

Activé par défaut

Paramètres :

  • view contrôle si l'URL de téléchargement pour PhotoSequence est renvoyée.
Champs
sequence_id

string

Obligatoire. Identifiant de la séquence photo.
view
(deprecated)

PhotoView

Spécifie si une URL de téléchargement de la séquence photo doit être renvoyée dans l'élément download_url des photos individuelles de la réponse PhotoSequence.

Remarque: Non mis en œuvre pour le moment.
filter

string

Facultatif. Expression du filtre. Exemple : published_status=PUBLISHED.

Les filtres compatibles sont les suivants: published_status. Consultez la page https://google.aip.dev/160 pour en savoir plus.

GpsDataGapFailureDetails

Détails liés à ProcessingFailureReason#GPS_DATA_GAP. S'il existe plusieurs écarts de données GPS, seul celui dont la durée est la plus longue est indiqué ici.

Champs
gap_duration

Duration

Durée de l'écart détecté dans les données GPS.
gap_start_time

Duration

Durée relative (à partir du début du flux vidéo) à laquelle le blanc a commencé.

Imu

les données de la centrale inertielle provenant des capteurs de l'appareil.

Champs
accel_mpsps[]

Measurement3d

Les mesures de l'accéléromètre sont exprimées en mètres/s^2, et les codes temporels proviennent des appareils.
gyro_rps[]

Measurement3d

Les mesures du gyroscope sont exprimées en radians/s avec des codes temporels croissants provenant des appareils.
mag_ut[]

Measurement3d

Les mesures du magnétomètre du champ magnétique en microteslas (uT) avec des horodatages croissants provenant des appareils.

Mesure3 j

Échantillon de mesure 3D générique.

Champs
capture_time

Timestamp

Code temporel de la mesure de la centrale inertielle.
x

float

Mesure du capteur sur l'axe X.
y

float

Mesure du capteur sur l'axe Y.
z

float

Mesure du capteur sur l'axe Z.

ImuDataGapFailureDetails

Détails concernant ProcessingFailureReason#IMU_DATA_GAP. S'il existe plusieurs écarts de données concernant la centrale inertielle, seul celui dont la durée est la plus longue est indiqué ici.

Champs
gap_duration

Duration

Durée de l'écart dans les données de la centrale inertielle détectée.
gap_start_time

Duration

Durée relative (à partir du début du flux vidéo) à laquelle le blanc a commencé.

InsufficientGpsFailureDetails

Détails relatifs à ProcessingFailureReason#INSUFFICIENT_GPS.

Champs
gps_points_found

int32

Nombre de points GPS trouvés dans la vidéo.

LatLngBounds

Rectangle en coordonnées géographiques

Champs
southwest

LatLng

L'angle sud-ouest de ces limites.
northeast

LatLng

L'angle nord-est de ces limites.

Niveau

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

Champs
number

double

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.

ListPhotoSequencesRequest

Requête permettant de lister toutes les séquences photo appartenant à l'utilisateur qui envoie la demande.

Paramètres :

  • pageSize détermine le nombre maximal de séquences photo à renvoyer.
  • pageToken est la valeur de jeton de page suivante renvoyée par une requête ListPhotoSequences précédente, le cas échéant.
Champs
page_size

int32

Facultatif. Nombre maximal de séquences photo à renvoyer. pageSize ne doit pas être une valeur négative. Si pageSize est égal à zéro ou n'est pas fourni, la taille de page par défaut (100) est utilisée. Le nombre de séquences photo renvoyées dans la réponse peut être inférieur à pageSize si le nombre de correspondances est inférieur à pageSize. Cette fonctionnalité n'est pas encore implémentée, mais elle est en cours de traitement.
page_token

string

Facultatif. La valeur nextPageToken renvoyée par une requête ListPhotoSequences précédente, le cas échéant.
filter

string

Facultatif. Expression du filtre. Exemple : imagery_type=SPHERICAL.

Les filtres pris en charge sont les suivants: imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, `max_capture_time_seconds. Consultez la page https://google.aip.dev/160 pour en savoir plus. Les requêtes de nom de fichier doivent être envoyées sous forme d'expression afin de pouvoir accepter plusieurs mots et caractères spéciaux en ajoutant des guillemets échappés. Ex. : nomdufichier_query="exemple d'une phrase.mp4"

ListPhotoSequencesResponse

Réponse pour lister toutes les séquences photo appartenant à un utilisateur.

Champs
photo_sequences[]

Operation

Liste des séquences photo via l'interface Operation.

Le nombre maximal d'éléments renvoyés est basé sur le champ pageSize de la requête.

Chaque élément de la liste peut avoir trois états possibles,

  • Operation.done = "false", si le traitement de PhotoSequence n'est pas encore terminé.
  • Operation.done = "true" et Operation.error est renseigné si une erreur s'est produite lors du traitement.
  • Operation.done = "true" et Operation.response contient un message PhotoSequence. Dans chaque séquence, seul Id est renseigné.
next_page_token

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

ListPhotosRequest

Requête permettant de lister toutes les photos appartenant à l'utilisateur qui envoie la demande.

Activé par défaut

  • ne renvoie pas l'URL de téléchargement des octets de la photo.

Paramètres :

  • view détermine si l'URL de téléchargement des octets de photo est renvoyée.
  • pageSize détermine le nombre maximal de photos à renvoyer.
  • pageToken est la valeur de jeton de page suivante renvoyée par une requête ListPhotos précédente, le cas échéant.
  • filter permet de filtrer en fonction d'un paramètre donné. "placeId" est le seul paramètre accepté pour l'instant.
Champs
view

PhotoView

Obligatoire. Spécifie si une URL de téléchargement pour les octets de photos doit être renvoyée dans la réponse Photos.
page_size

int32

Facultatif. Nombre maximal de photos à renvoyer. pageSize ne doit pas être une valeur négative. Si pageSize est égal à zéro ou n'est pas fourni, la taille de page par défaut (100) est utilisée. Le nombre de photos renvoyées dans la réponse peut être inférieur à pageSize si le nombre de photos appartenant à l'utilisateur est inférieur à pageSize.
page_token

string

Facultatif. La valeur nextPageToken renvoyée par une requête ListPhotos précédente, le cas échéant.
filter

string

Facultatif. Expression du filtre. Exemple : placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw.

Les filtres acceptés sont les suivants: placeId, min_latitude, max_latitude, min_longitude et max_longitude. Consultez la page https://google.aip.dev/160 pour en savoir plus.
language_code

string

Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Si language_code n'est pas spécifié, la préférence linguistique de l'utilisateur pour les services Google est utilisée.

ListPhotosResponse

Réponse pour lister toutes les photos appartenant à un utilisateur.

Champs
photos[]

Photo

Liste de photos. Le champ pageSize de la requête détermine le nombre d'articles renvoyés.
next_page_token

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

NoOverlapGpsFailureDetails

Détails concernant PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.

Champs
gps_start_time

Timestamp

Heure du premier point GPS enregistré.
gps_end_time

Timestamp

Heure du dernier point GPS enregistré.
video_start_time

Timestamp

Heure de début de la vidéo.
video_end_time

Timestamp

Heure de fin de la vidéo.

NotOutdoorsFailureDetails

Détails concernant ProcessingFailureReason#NOT_OUTDOORS. Si plusieurs images prises à l'intérieur sont détectées, la première image est enregistrée ici.

Champs
start_time

Duration

Durée relative (à partir du début du flux vidéo) à partir du moment où un cadre intérieur a été détecté.

Photo

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

Champs
photo_id

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

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

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

string

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

Pose

Facultatif. Pose de la photo.
connections[]

Connection

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

Timestamp

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

Timestamp

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

Place

Facultatif. Lieux auxquels cette photo appartient.
view_count

int64

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

TransferStatus

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

MapsPublishStatus

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

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.

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.

PhotoId

Identifiant de Photo.

Champs
id

string

Identifiant unique d'une photo.

PhotoResponse

Charge utile de réponse pour un seul Photo dans les opérations par lot, y compris BatchGetPhotos et BatchUpdatePhotos.

Champs
status

Status

État de l'opération permettant d'obtenir ou de mettre à jour une seule photo dans la requête par lot.
photo

Photo

La ressource Photo, si la requête a abouti.

PhotoSequence

Séquence de photos à 360° accompagnées de métadonnées.

Champs
id

string

Uniquement en sortie. Identifiant unique de la séquence photo. Il sert également d'ID d'opération de longue durée si l'importation est effectuée de manière asynchrone.
photos[]

Photo

Uniquement en sortie. Photos dont le code temporel augmente.
upload_reference

UploadRef

Uniquement en entrée. Obligatoire lors de la création d'une séquence photo. Nom de la ressource dans laquelle les octets de la séquence photo (sous forme de vidéo) sont importés.
capture_time_override

Timestamp

Facultatif. Heure absolue à laquelle la séquence photo commence à être capturée. Si la séquence photo est une vidéo, il s'agit de l'heure de début de la vidéo. Si ce champ est renseigné, il remplace l'heure de capture dans la vidéo ou le fichier XDM.
upload_time

Timestamp

Uniquement en sortie. Heure à laquelle cette séquence photo a été créée dans le service uSV Store.
raw_gps_timeline[]

Pose

Uniquement en entrée. Mesures GPS brutes avec des horodatages croissants provenant de l'appareil et qui ne sont pas synchronisés avec chaque photo. Ces mesures brutes seront utilisées pour déduire la pose de chaque image. Obligatoire en entrée lorsque le type d'entrée est VIDEO et que les mesures GPS brutes ne sont pas incluses dans la piste de métadonnées de mouvement de la caméra (CAMM). L'utilisateur peut indiquer celle qui prévaut à l'aide de gps_source si des mesures GPS brutes sont fournies à la fois dans le flux brut_gps_timeline et dans la piste CAMM (Camera Motion Metadata Track).
gps_source

GpsSource

Uniquement en entrée. Si les valeurs brutes_gps_timeline et CAMM (Camera Motion Metadata Track) contiennent des mesures GPS, indiquez celle qui prévaut.
imu

Imu

Uniquement en entrée. Données IMU sur trois axes pour la collecte. Si ces données sont trop volumineuses pour être incluses dans la demande, elles doivent être incluses dans la piste CAMM de la vidéo. Ces données prévalent toujours sur les données CAMM équivalentes, le cas échéant.
processing_state

ProcessingState

Uniquement en sortie. État de traitement de cette séquence.
failure_reason

ProcessingFailureReason

Uniquement en sortie. Si l'état de traitement de cette séquence est défini sur "ÉCHEC", vous trouverez la raison de l'échec. Si la valeur "processing_state" est différente, ce champ n'est pas défini.
failure_details

ProcessingFailureDetails

Uniquement en sortie. Si failure_reason est défini pour cette séquence, des informations supplémentaires sur l'échec peuvent être incluses.
distance_meters

double

Uniquement en sortie. Distance calculée de la séquence photographique, en mètres.
sequence_bounds

LatLngBounds

Uniquement en sortie. Cadre rectangulaire qui encapsule toutes les images de cette séquence photo.
view_count

int64

Uniquement en sortie. Nombre total de vues enregistrées par toutes les images publiées dans cette séquence photo.
filename

string

Uniquement en sortie. Nom de fichier de l'importation. N'inclut pas le chemin d'accès au répertoire. Disponible uniquement si la séquence a été importée sur une plate-forme qui fournit le nom de fichier.

GpsSource

Source principale des mesures GPS.

Enums
PHOTO_SEQUENCE Dans le champ "raw_gps_timeline", le GPS est prioritaire, s'il existe.
CAMERA_MOTION_METADATA_TRACK Le GPS de la piste CAMM (Motion Metadata Track) de la caméra est prioritaire, le cas échéant.

PhotoView

Spécifie la vue du Photo à inclure dans la réponse.

Enums
BASIC Les réponses du serveur n'incluent pas l'URL de téléchargement des octets de la photo. Valeur par défaut.
INCLUDE_DOWNLOAD_URL Les réponses du serveur incluent l'URL de téléchargement des octets de la photo.

Lieu

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

Champs
place_id

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é dans le paramètre language_code.
language_code

string

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

Pose

Mesure brute des postures pour une entité.

Champs
lat_lng_pair

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

double

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

double

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

double

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

double

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

Timestamp

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

Level

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

float

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.

ProcessingFailureDetails

Informations supplémentaires à fournir avec l'énumération "ProcessingFailureReason". Ce message doit toujours être utilisé avec ProcessingFailureReason, et la valeur oneof définie dans ce message doit correspondre à FailureReason.

Champs
Champ d'union details. Un seul ensemble de détails sera défini et doit correspondre à l'énumération correspondante dans ProcessingFailureReason. details ne peut être qu'un des éléments suivants :
insufficient_gps_details

InsufficientGpsFailureDetails

Consultez InsufficientGpsFailureDetails.
gps_data_gap_details

GpsDataGapFailureDetails

Consultez GpsDataGapFailureDetails.
imu_data_gap_details

ImuDataGapFailureDetails

Voir ImuDataGapFailureDetails.
not_outdoors_details

NotOutdoorsFailureDetails

Consultez NotOutdoorsFailureDetails.
no_overlap_gps_details

NoOverlapGpsFailureDetails

Voir NoOverlapGpsFailureDetails.

ProcessingFailureReason

Causes possibles de l'échec du traitement de cet PhotoSequence.

Enums
PROCESSING_FAILURE_REASON_UNSPECIFIED Le motif de l'échec n'est pas spécifié, il s'agit de la valeur par défaut.
LOW_RESOLUTION La résolution de l'image vidéo est trop faible.
DUPLICATE Cette vidéo a déjà été mise en ligne.
INSUFFICIENT_GPS Points GPS insuffisants.
NO_OVERLAP_GPS Aucun chevauchement entre la période du tracé GPS et celle de la vidéo.
INVALID_GPS Le GPS est incorrect (par exemple, tous les points GPS sont à (0,0)).
FAILED_TO_REFINE_POSITIONS Impossible de localiser précisément la série de photos dans le monde.
TAKEDOWN La séquence a été supprimée pour des raisons de non-respect des règles.
CORRUPT_VIDEO Le fichier vidéo est corrompu ou n'a pas pu être décodé.
INTERNAL Une défaillance permanente du système sous-jacent s'est produite.
INVALID_VIDEO_FORMAT Le format de la vidéo n'est pas valide ou n'est pas accepté.
INVALID_VIDEO_DIMENSIONS Format d'image non valide détecté.
INVALID_CAPTURE_TIME Heure de capture non valide. Les codes temporels étaient dans le futur.
GPS_DATA_GAP Les données GPS contiennent un intervalle de plus de 5 secondes.
JUMPY_GPS Les données GPS sont trop irrégulières pour être traitées.
INVALID_IMU Les données de la centrale inertielle (accéléromètre, gyroscope, etc.) ne sont pas valides. Il est possible qu'il manque des champs obligatoires (x, y, z ou heure), qu'il ne soit pas formaté correctement ou qu'il existe un autre problème empêchant nos systèmes de les analyser.
INSUFFICIENT_IMU Trop peu de points IMU.
INSUFFICIENT_OVERLAP_TIME_SERIES Chevauchement insuffisant entre les données GPS, IMU et d'autres séries temporelles sur la période.
IMU_DATA_GAP Les données de la centrale inertielle (accéléromètre, gyroscope, etc.) contiennent des blancs de plus de 0,1 seconde.
UNSUPPORTED_CAMERA L'appareil photo n'est pas compatible.
NOT_OUTDOORS Certains cadres étaient en intérieur, ce qui n'est pas pris en charge.
INSUFFICIENT_VIDEO_FRAMES Nombre d'images vidéo insuffisant.
INSUFFICIENT_MOVEMENT Pas assez de données de déplacement.

ProcessingState

État de traitement de la séquence. Les états se déplacent comme suit:

     +-------------------------+
     |                         |
 +---v---+  +----------+  +----+----+
 |PENDING+-->PROCESSING+-->PROCESSED|
 +---+---+  +----+-----+  +----+----+
     |           |             |
     |        +--v---+         |
     +-------->FAILED<---------+
              +------+

La séquence peut passer à l'état "FAILED" depuis n'importe quel état. En outre, une séquence traitée peut être de nouveau traitée à tout moment.

Enums
PROCESSING_STATE_UNSPECIFIED L'état n'est pas spécifié, il s'agit de la valeur par défaut.
PENDING Le traitement de la séquence n'a pas encore commencé.
PROCESSING La séquence est en cours de traitement.
PROCESSED Le traitement de la séquence (y compris l'affinement de la position) est terminé.
FAILED Échec du traitement de la séquence. Pour en savoir plus, reportez-vous à FailureReason.

UpdatePhotoRequest

Requête de mise à jour des métadonnées d'un Photo. La mise à jour des pixels d'une photo n'est pas prise en charge.

Champs
photo

Photo

Obligatoire. Objet Photo contenant les nouvelles métadonnées.
update_mask

FieldMask

Obligatoire. Masque qui identifie les champs des métadonnées de photo à mettre à jour. Si elles ne sont pas présentes, les anciennes métadonnées Photo sont entièrement remplacées par les nouvelles métadonnées Photo dans cette requête. La mise à jour échoue si des champs non valides sont spécifiés. Vous pouvez spécifier plusieurs champs dans une liste d'éléments séparés par une virgule.

Les champs suivants sont valides:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

Remarque: Lorsque updateMask contient des champs répétés, l'ensemble des valeurs répétées est remplacé par le nouveau contenu. Par exemple, si updateMask contient connections et que UpdatePhotoRequest.photo.connections est vide, toutes les connexions sont supprimées.

UploadRef

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

Champs
Champ d'union file_source. Obligatoire. file_source ne peut être qu'un des éléments suivants :
upload_url

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/{upload_reference}".