Package google.streetview.publish.v1

Index

StreetViewPublishService

publie et associe 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 échecs. Ces échecs sont spécifiés dans chaque PhotoResponse.status de BatchDeletePhotosResponse.results. Consultez DeletePhoto pour connaître les échecs spécifiques pouvant survenir 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 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 échecs. Ces échecs sont spécifiés dans chaque PhotoResponse.status de BatchGetPhotosResponse.results. Consultez GetPhoto pour connaître les échecs spécifiques pouvant survenir 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, le lieu associé, les liens, etc. Il n'est pas possible de modifier les pixels des photos.

Notez que si 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 échecs. Ces échecs sont spécifiés dans chaque PhotoResponse.status de BatchUpdatePhotosResponse.results. Consultez UpdatePhoto pour connaître les échecs spécifiques pouvant survenir 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, le champ 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 l'UploadRef renvoyée, CreatePhoto publie la Photo importée sur Street View sur Google Maps.

Actuellement, le seul moyen de définir l'orientation, la hauteur et le roulis 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 "Pose".

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° à partir d'une vidéo ou d'Extensible Device Metadata (XDM, http://www.xdm.org/) à publier dans Street View sur Google Maps.

CreatePhotoSequence renvoie 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 de l'élément 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é en cas d'erreur de traitement.
  • Operation.done = true et Operation.response est poulate, ce qui 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)

Affiche la liste de tous les PhotoSequences qui appartiennent à l'utilisateur, dans l'ordre d'horodatage "CreatePhotoSequence" décroissant.

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)

Affiche la liste de tous les Photos appartenant à 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 de photos. L'URL d'importation du UploadRef renvoyé permet d'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 photo. La méthode utilise l'URL d'importation du UploadRef renvoyé pour importer les octets de Photo.

En plus des exigences concernant les photos décrites sur la page https://support.google.com/maps/answer/7012050?ref_topic=6275604, la photo doit également respecter les exigences 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'un Photo, telles que la pose, l'association à un lieu, les liens, 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

Requête pour supprimer plusieurs Photos.

Champs
photo_ids[]

string

Obligatoire. ID de Photos Les requêtes HTTP GET requièrent 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 éléments Photos.

Champs
status[]

Status

État de l'opération visant à supprimer un seul Photo dans la requête par lot.

BatchGetPhotosRequest

Requête pour 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 contrôle si l'URL de téléchargement des octets de la 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. Indique si une URL de téléchargement des octets de la 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 d'obtention par lot de Photos.

Champs
results[]

PhotoResponse

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

BatchUpdatePhotosRequest

Requête de mise à jour des métadonnées des photos. Impossible de mettre à jour les pixels des photos.

Champs
update_photo_requests[]

UpdatePhotoRequest

Obligatoire. Liste de UpdatePhotoRequests.

BatchUpdatePhotosResponse

Réponse à une mise à jour groupée des métadonnées d'un ou de plusieurs éléments Photos.

Champs
results[]

PhotoResponse

Liste des résultats pour chaque Photo individuel mis à jour, dans le même ordre que celui de 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 parent et une autre photo.

CreatePhotoRequest

Requête pour créer un Photo.

Champs
photo

Photo

Obligatoire. Photo à créer.

CreatePhotoSequenceRequest

Demandez la création d'un PhotoSequence à partir d'une vidéo.

Champs
photo_sequence

PhotoSequence

Obligatoire. PhotoSequence pour créer.
input_type

InputType

Obligatoire. Format de saisie de PhotoSequence.

InputType

Formats 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 pour obtenir un Photo.

Activé par défaut

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

Paramètres :

  • view contrôle si l'URL de téléchargement des octets de la photo est renvoyée.
Champs
photo_id

string

Obligatoire. ID de Photo.
view

PhotoView

Obligatoire. Indique si une URL de téléchargement des octets de la 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 pour obtenir 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

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

Remarque: Actuellement non implémenté.
filter

string

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

Les filtres compatibles sont les suivants: published_status. Pour en savoir plus, consultez https://google.aip.dev/160.

GpsDataGapFailureDetails

Détails concernant ProcessingFailureReason#GPS_DATA_GAP. S'il y a 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 dans les données GPS trouvées.
gap_start_time

Duration

Durée relative (depuis le début du flux vidéo) lorsque l'intervalle a commencé.

Immu

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

Champs
accel_mpsps[]

Measurement3d

L'accéléromètre mesure les mesures en mètres/s^2 avec des codes temporels croissants provenant des appareils.
gyro_rps[]

Measurement3d

Le gyroscope mesure les mesures en radians/s avec des codes temporels croissants provenant des appareils.
mag_ut[]

Measurement3d

Mesures du magnétomètre du champ magnétique en microtesla (uT) avec des codes temporels croissants provenant des appareils.

Mesure3j

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

Champs
capture_time

Timestamp

Horodatage de la mesure de la IMU.
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 de la centrale inertielle, seul celui dont la durée est la plus longue est signalé ici.

Champs
gap_duration

Duration

Durée de l'écart dans les données IMU trouvées.
gap_start_time

Duration

Durée relative (depuis le début du flux vidéo) lorsque l'intervalle a commencé.

InsufficientGpsFailureDetails

Informations concernant ProcessingFailureReason#INSUFFICIENT_GPS.

Champs
gps_points_found

int32

Le nombre de points GPS trouvés dans la vidéo.

LatLngBounds

Rectangle avec des 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 du niveau et son 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 et -1 indique le premier étage au-dessus 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 d'ascenseur seraient étiquetés pour ce niveau s'il y avait un ascenseur.

ListPhotoSequencesRequest

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

Paramètres :

  • pageSize détermine le nombre maximal de séquences photo à afficher.
  • pageToken est la valeur du 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. La valeur pageSize ne doit pas être négative. Si pageSize est égal à zéro ou n'est pas indiqué, 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.
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 compatibles 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. Pour en savoir plus, consultez https://google.aip.dev/160. Les requêtes de nom de fichier doivent être envoyées sous forme d'expression afin d'accepter plusieurs mots et caractères spéciaux en ajoutant des guillemets échappés. Exemple: username_query="exemple d'expression.mp4"

ListPhotoSequencesResponse

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

Champs
photo_sequences[]

Operation

Liste de 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é en cas d'erreur de 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

Demande de liste de 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 contrôle si l'URL de téléchargement des octets de la photo est renvoyée.
  • pageSize détermine le nombre maximal de photos à renvoyer.
  • pageToken est la valeur du 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 le moment.
Champs
view

PhotoView

Obligatoire. Indique si une URL de téléchargement des octets des photos doit être renvoyée dans la réponse Photos.
page_size

int32

Facultatif. Nombre maximal de photos à renvoyer. La valeur pageSize ne doit pas être négative. Si pageSize est égal à zéro ou n'est pas indiqué, 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 compatibles sont les suivants: placeId, min_latitude, max_latitude, min_longitude et max_longitude. Pour en savoir plus, consultez https://google.aip.dev/160.
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'éléments 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 intérieures ont été détectées, la première est enregistrée ici.

Champs
start_time

Duration

Durée relative (à partir du début du flux vidéo) pendant laquelle une image intérieure a été détectée.

Photo

La photo est utilisée pour stocker des photos à 360° avec leurs métadonnées.

Champs
photo_id

PhotoId

Obligatoire. Uniquement en sortie. Obligatoire pour la mise à jour d'une photo. Ne s'affiche que lors de la création d'une photo. Identifiant de la photo, qui est unique parmi toutes les photos sur Google.
upload_reference

UploadRef

Uniquement en entrée. Obligatoire pour la création d'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. Position de la photo.
connections[]

Connection

Facultatif. Liens avec d'autres photos. Une connexion représente le lien de cette photo vers une autre photo.
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, indiquant si cette photo a été publiée ou refusée.

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.

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 fait l'objet d'un transfert.
PENDING Le transfert de cette photo a été lancé, mais le destinataire n'a pas encore répondu.
COMPLETED Le transfert de la photo est terminé, et cette 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 n'ait effectué aucune action.
CANCELLED L'expéditeur a annulé ce transfert de photo.
RECEIVED_VIA_TRANSFER Le destinataire est le propriétaire de cette photo en raison d'un transfert de droits.

PhotoId

Identifiant d'un 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 groupée.
photo

Photo

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

PhotoSequence

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

Champs
id

string

Uniquement en sortie. Identifiant unique de la séquence photo. Cet ID 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 avec des codes temporels de plus en plus longs.
upload_reference

UploadRef

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

Timestamp

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

Timestamp

Uniquement en sortie. Date et heure de création de cette séquence de photos dans le service uSV Store.
raw_gps_timeline[]

Pose

Uniquement en entrée. Mesures GPS brutes avec des codes temporels croissants de l'appareil qui ne sont pas synchronisés avec chaque photo. Ces mesures brutes seront utilisées pour déduire la pose de chaque image. Requis en entrée lorsque le type d'entrée est VIDEO et que les mesures GPS brutes ne sont pas dans la piste de métadonnées de mouvement de la caméra (CAMM). L'utilisateur peut indiquer celle qui est prioritaire à l'aide de gps_source si les mesures GPS brutes sont fournies à la fois dans le champ "raw_gps_timeline" et dans le champ CAMM (rail de métadonnées des mouvements de la caméra).
gps_source

GpsSource

Uniquement en entrée. Si le champ "raw_gps_timeline" et le fichier CAMM (Camera Motion Metadata Track) contiennent des mesures GPS, indiquez laquelle est prioritaire.
imu

Imu

Uniquement en entrée. Données IMU à 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 ont toujours priorité 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 le paramètre "processing_state" est défini sur "FAILED" pour cette séquence, vous trouverez la raison pour laquelle l'opération a échoué. Si "processing_state" est défini sur une autre valeur, 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 affichées.
distance_meters

double

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

LatLngBounds

Uniquement en sortie. Boîte rectangulaire qui encapsule chaque image de cette séquence photo.
view_count

int64

Uniquement en sortie. Nombre total de vues pour toutes les images publiées de cette PhotoSequence.
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 fournissant le nom de fichier.

GpsSource

Source principale des mesures GPS.

Enums
PHOTO_SEQUENCE Le GPS dans "raw_gps_timeline" est prioritaire s'il existe.
CAMERA_MOTION_METADATA_TRACK Le GPS dans la piste de métadonnées de mouvement de la caméra (CAMM) est prioritaire s'il existe.

PhotoView

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

Enums
BASIC Les réponses du serveur n'incluent pas l'URL de téléchargement des octets des photos. 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 lieu pour 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 language_code.
language_code

string

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

Pose

Mesure brute de la posture pour une entité.

Champs
lat_lng_pair

LatLng

Paire latitude et longitude de la pose, comme expliqué ici: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Lors de la création d'une Photo, si la paire latitude et longitude n'est pas fournie, la géolocalisation de l'en-tête EXIF est utilisée. Si la paire latitude/longitude n'est pas fournie dans l'en-tête photo ou EXIF, le processus photo échoue.
altitude

double

Altitude de la posture, 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. 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 comprise entre 0 et 360. NaN indique une quantité non mesurée.
pitch

double

Hauteur, mesurée au centre de la photo en degrés. La valeur doit être comprise entre 90 et 90 et >= -90. Une valeur de -90 signifie regarder directement vers le bas, et une valeur de 90 signifie regarder directement vers le haut. NaN indique une quantité non mesurée.
roll

double

Roulis, mesuré en degrés. La valeur doit être comprise entre 0 et 360. Une valeur de 0 correspond 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 posture en mètres avec un indice de 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.

ProcessingFailureDetails

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

Champs
Champ d'union details. Un seul ensemble d'informations 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 MissingGpsFailureDetails.
gps_data_gap_details

GpsDataGapFailureDetails

Consultez GpsDataGapFailureDetails.
imu_data_gap_details

ImuDataGapFailureDetails

Consultez ImuDataGapFailureDetails.
not_outdoors_details

NotOutdoorsFailureDetails

Consultez NotOutdoorsFailureDetails.
no_overlap_gps_details

NoOverlapGpsFailureDetails

Consultez NoOverlapGpsFailureDetails.

ProcessingFailureReason

Raisons possibles pour lesquelles le traitement de ce PhotoSequence a échoué.

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 du cadre de la vidéo est trop faible.
DUPLICATE Cette vidéo a déjà été mise en ligne.
INSUFFICIENT_GPS Le nombre de points GPS est insuffisant.
NO_OVERLAP_GPS Il n'y a pas de chevauchement entre la période de la piste GPS et celle de la vidéo.
INVALID_GPS Le GPS n'est pas valide (tous les points GPS sont par exemple à (0,0))
FAILED_TO_REFINE_POSITIONS Impossible de localiser précisément la séquence de photos au niveau mondial.
TAKEDOWN La séquence a été supprimée pour non-respect du règlement.
CORRUPT_VIDEO Le fichier vidéo était 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 correspondent à des dates situées dans le futur.
GPS_DATA_GAP Les données GPS contiennent un blanc de plus de cinq 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 peut s'agir de champs obligatoires manquants (x, y, z ou time), d'un format incorrect ou d'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 dans la période entre les données GPS, centrales inertielles et autres séries temporelles.
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 La caméra n'est pas compatible.
NOT_OUTDOORS Certaines images ont été tournées en intérieur, ce qui n'est pas accepté.
INSUFFICIENT_VIDEO_FRAMES Nombre d'images vidéo insuffisant.
INSUFFICIENT_MOVEMENT Pas assez de données en mouvement.

ProcessingState

État de traitement de la séquence. Les états sont déplacés 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 peut être traitée à nouveau à 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. Voir FailureReason pour plus de détails.

UpdatePhotoRequest

Requête de mise à jour des métadonnées d'un Photo. Impossible de mettre à jour les pixels d'une photo.

Champs
photo

Photo

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

FieldMask

Obligatoire. Masque qui identifie les champs à mettre à jour dans les métadonnées de la photo. Si elles sont absentes, 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

Importer une référence 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

La référence de mise en ligne 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}".