- Requête HTTP
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- PhotoSequence
- GpsSource
- Imu
- Mesure3d
- ProcessingState
- ProcessingFailureReason
- ProcessingFailureDetails
- InsufficientGpsFailureDetails
- GpsDataGapFailureDetails
- ImuDataGapFailureDetails
- NotOutdoorsFailureDetails
- NoOverlapGpsFailureDetails
- LatLngBounds
- InputType
- Essayer
Une fois que le client a terminé d'importer le PhotoSequence
avec le UploadRef
renvoyé, photoSequence.create
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.
photoSequence.create
renvoie Operation
, avec l'ID PhotoSequence
défini dans le champ Operation.name
.
Cette méthode renvoie les codes d'erreur suivants:
google.rpc.Code.INVALID_ARGUMENT
si le format de la requête est incorrect.google.rpc.Code.NOT_FOUND
si la référence de l'importation n'existe pas.
Requête HTTP
POST https://streetviewpublish.googleapis.com/v1/photoSequence
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de requête
Paramètres | |
---|---|
inputType |
Obligatoire. Format de saisie de |
Corps de la requête
Le corps de la requête contient une instance PhotoSequence
.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation
.
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.
PhotoSequence
Séquence de photos à 360° accompagnée de métadonnées
Représentation JSON |
---|
{ "id": string, "photos": [ { object ( |
Champs | |
---|---|
id |
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[] |
Uniquement en sortie. Photos avec des codes temporels de plus en plus longs. |
uploadReference |
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). |
captureTimeOverride |
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. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
uploadTime |
Uniquement en sortie. Date et heure de création de cette séquence de photos dans le service uSV Store. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
rawGpsTimeline[] |
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 laquelle est prioritaire à l'aide de gpsSource si les mesures GPS brutes sont fournies à la fois dans le flux brutGpsTimeline et dans la piste de métadonnées de mouvement de la caméra (CAMM, Camera Motion Metadata Track). |
gpsSource |
Uniquement en entrée. Si le champ "rawGpsTimeline" et le module CAMM (Camera Motion Metadata Track) contiennent des mesures GPS, indiquez lequel est prioritaire. |
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. |
processingState |
Uniquement en sortie. État de traitement de cette séquence. |
failureReason |
Uniquement en sortie. Si le paramètre ProcessingState est défini sur FAILED pour cette séquence, la raison pour laquelle elle a échoué s'affiche. Si "processingState" correspond à une autre valeur, ce champ n'est pas défini. |
failureDetails |
Uniquement en sortie. Si |
distanceMeters |
Uniquement en sortie. Distance calculée de la séquence photo en mètres. |
sequenceBounds |
Uniquement en sortie. Boîte rectangulaire qui encapsule chaque image de cette séquence photo. |
viewCount |
Uniquement en sortie. Nombre total de vues pour toutes les images publiées de cette PhotoSequence. |
filename |
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 brutGpsTimeline 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. |
Immu
Données de la centrale inertielle provenant des capteurs de l'appareil.
Représentation JSON |
---|
{ "accelMpsps": [ { object ( |
Champs | |
---|---|
accelMpsps[] |
L'accéléromètre mesure les mesures en mètres/s^2 avec des codes temporels croissants provenant des appareils. |
gyroRps[] |
Le gyroscope mesure les mesures en radians/s avec des codes temporels croissants provenant des appareils. |
magUt[] |
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.
Représentation JSON |
---|
{ "captureTime": string, "x": number, "y": number, "z": number } |
Champs | |
---|---|
captureTime |
Horodatage de la mesure de la IMU. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
x |
Mesure du capteur sur l'axe X. |
y |
Mesure du capteur sur l'axe Y. |
z |
Mesure du capteur sur l'axe Z. |
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. |
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. |
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.
Représentation JSON |
---|
{ // Union field |
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 : |
|
insufficientGpsDetails |
Consultez MissingGpsFailureDetails. |
gpsDataGapDetails |
Consultez GpsDataGapFailureDetails. |
imuDataGapDetails |
Consultez ImuDataGapFailureDetails. |
notOutdoorsDetails |
Consultez NotOutdoorsFailureDetails. |
noOverlapGpsDetails |
Consultez NoOverlapGpsFailureDetails. |
InsufficientGpsFailureDetails
Informations concernant ProcessingFailureReason#INSUFFICIENT_GPS.
Représentation JSON |
---|
{ "gpsPointsFound": integer } |
Champs | |
---|---|
gpsPointsFound |
Le nombre de points GPS trouvés dans la vidéo. |
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.
Représentation JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
Champs | |
---|---|
gapDuration |
Durée de l'écart dans les données GPS trouvées. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
gapStartTime |
Durée relative (depuis le début du flux vidéo) lorsque l'intervalle a commencé. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
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.
Représentation JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
Champs | |
---|---|
gapDuration |
Durée de l'écart dans les données IMU trouvées. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
gapStartTime |
Durée relative (depuis le début du flux vidéo) lorsque l'intervalle a commencé. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
NotOutdoorsFailureDetails
Détails concernant ProcessingFailureReason#NOT_OUTDOORS. Si plusieurs images intérieures ont été détectées, la première est enregistrée ici.
Représentation JSON |
---|
{ "startTime": string } |
Champs | |
---|---|
startTime |
Durée relative (à partir du début du flux vidéo) pendant laquelle une image intérieure a été détectée. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
NoOverlapGpsFailureDetails
Détails concernant "PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.
Représentation JSON |
---|
{ "gpsStartTime": string, "gpsEndTime": string, "videoStartTime": string, "videoEndTime": string } |
Champs | |
---|---|
gpsStartTime |
Heure du premier point GPS enregistré. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
gpsEndTime |
Heure du dernier point GPS enregistré. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
videoStartTime |
Heure de début de la vidéo. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
videoEndTime |
Heure de fin de la vidéo. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
LatLngBounds
Rectangle avec des coordonnées géographiques.
Représentation JSON |
---|
{ "southwest": { object ( |
Champs | |
---|---|
southwest |
L'angle sud-ouest de ces limites. |
northeast |
L'angle nord-est de ces limites. |
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 |