Method: photoSequence.create

İstemci, döndürülen UploadRef içeren PhotoSequence öğesini yüklemeyi bitirdikten sonra photoSequence.create, Google Haritalar'da Street View'da yayınlanmak üzere bir videodan veya Genişletilebilir Cihaz Meta Verilerinden (XDM, http://www.xdm.org/) bir dizi 360° fotoğraf çıkarır.

photoSequence.create, Operation.name alanında PhotoSequence kimliği ayarlanmış bir Operation döndürür.

Bu yöntem aşağıdaki hata kodlarını döndürür:

HTTP isteği

POST https://streetviewpublish.googleapis.com/v1/photoSequence

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
inputType

enum (InputType)

Zorunlu. PhotoSequence giriş biçimi.

İstek içeriği

İstek metni, PhotoSequence öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, yeni oluşturulmuş bir Operation örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

PhotoSequence

Meta verilerle birlikte bir dizi 360° fotoğraf.

JSON gösterimi
{
  "id": string,
  "photos": [
    {
      object (Photo)
    }
  ],
  "uploadReference": {
    object (UploadRef)
  },
  "captureTimeOverride": string,
  "uploadTime": string,
  "rawGpsTimeline": [
    {
      object (Pose)
    }
  ],
  "gpsSource": enum (GpsSource),
  "imu": {
    object (Imu)
  },
  "processingState": enum (ProcessingState),
  "failureReason": enum (ProcessingFailureReason),
  "failureDetails": {
    object (ProcessingFailureDetails)
  },
  "distanceMeters": number,
  "sequenceBounds": {
    object (LatLngBounds)
  },
  "viewCount": string,
  "filename": string
}
Alanlar
id

string

Yalnızca çıkış. Fotoğraf dizisi için benzersiz tanımlayıcı. Bu aynı zamanda, yükleme eş zamansız olarak gerçekleştirilirse uzun çalışan bir işlem kimliği olarak da işlev görür.

photos[]

object (Photo)

Yalnızca çıkış. Zaman damgaları artan fotoğraflar.

uploadReference

object (UploadRef)

Yalnızca giriş. Fotoğraf dizisi oluştururken gereklidir. Fotoğraf dizisindeki baytların (video biçimindeki) yüklendiği kaynağın adı.

captureTimeOverride

string (Timestamp format)

İsteğe bağlı. Fotoğraf dizisinin çekilmeye başladığı mutlak süre. Fotoğraf dizisi video ise bu, videonun başlangıç zamanıdır. Bu alan girişte doldurulursa video veya XDM dosyasındaki yakalama süresini geçersiz kılar.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

uploadTime

string (Timestamp format)

Yalnızca çıkış. Bu fotoğraf dizisinin uSV Store hizmetinde oluşturulma zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

rawGpsTimeline[]

object (Pose)

Yalnızca giriş. Cihazdan alınan ve her fotoğrafla senkronize edilmeyen zaman damgalarının arttığı ham GPS ölçümleri. Bu ham ölçümler, her bir karenin duruşunu belirlemek için kullanılır. Giriş Türü VIDEO olduğu ve ham GPS ölçümlerinin Kamera Hareketi Meta Veri İzi (CAMM) olmadığı durumlarda giriş için gereklidir. Ham GPS ölçümleri hem HamGpsTimeline hem de Camera Motion Metadata Track (CAMM) ile sağlanıyorsa, gpsSource'u kullanarak hangisinin öncelikli olduğunu belirtebilir.

gpsSource

enum (GpsSource)

Yalnızca giriş. HemRAWGpsTimeline hem de Camera Motion Metadata Track (CAMM) GPS ölçümleri içeriyorsa hangisinin öncelikli olduğunu belirtin.

imu

object (Imu)

Yalnızca giriş. Koleksiyon için üç eksenli IMU verileri. Bu veri, isteğe eklenemeyecek kadar büyükse videonun CAMM parçasına yerleştirilmelidir. Bu veriler, eşdeğer CAMM verilerine (mevcutsa) göre her zaman önceliklidir.

processingState

enum (ProcessingState)

Yalnızca çıkış. Bu adım sırasının işleme durumu.

failureReason

enum (ProcessingFailureReason)

Yalnızca çıkış. Bu dizide transactionState = BAŞARISIZ varsa bu dizi başarısız olmasının nedenini içerir. transactionState başka bir değerse bu alan ayarlanmaz.

failureDetails

object (ProcessingFailureDetails)

Yalnızca çıkış. Bu dizide failureReason ayarlanmışsa hatayla ilgili ek ayrıntılar bulunabilir.

distanceMeters

number

Yalnızca çıkış. Fotoğraf dizisinin metre cinsinden hesaplanan mesafesi.

sequenceBounds

object (LatLngBounds)

Yalnızca çıkış. Bu fotoğraf dizisindeki her resmi kapsayan dikdörtgen bir kutu.

viewCount

string (int64 format)

Yalnızca çıkış. Bu Fotoğraf Dizisi'nde yayınlanan tüm görüntülerin aldığı toplam görüntüleme sayısı.

filename

string

Yalnızca çıkış. Yüklemenin dosya adı. Dizin yolunu içermez. Yalnızca sıra, dosya adını sağlayan bir platformda yüklenmişse kullanılabilir.

GpsSource

GPS ölçümlerinin birincil kaynağı.

Sıralamalar
PHOTO_SEQUENCE RAWGpsTimeline içindeki GPS, mevcutsa önceliklidir.
CAMERA_MOTION_METADATA_TRACK Kamera Hareketi Meta Veri İzleme (CAMM) özelliğinde GPS, mevcutsa önceliklidir.

Imu

Cihaz sensörlerinden gelen IMU verileri.

JSON gösterimi
{
  "accelMpsps": [
    {
      object (Measurement3d)
    }
  ],
  "gyroRps": [
    {
      object (Measurement3d)
    }
  ],
  "magUt": [
    {
      object (Measurement3d)
    }
  ]
}
Alanlar
accelMpsps[]

object (Measurement3d)

Cihazlardan artan zaman damgalarıyla birlikte metre/sn^2 cinsinden ivme ölçer ölçümleri.

gyroRps[]

object (Measurement3d)

Cihazlardan artan zaman damgalarıyla birlikte radyan/sn cinsinden jiroskop ölçümleri.

magUt[]

object (Measurement3d)

Cihazlardan artan zaman damgalarıyla birlikte mikrotesla (uT) cinsinden manyetik alanın manyetometre ölçümleri.

Ölçüm3d

Genel 3D ölçüm örneği.

JSON gösterimi
{
  "captureTime": string,
  "x": number,
  "y": number,
  "z": number
}
Alanlar
captureTime

string (Timestamp format)

IMU ölçümünün zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

x

number

X eksenindeki sensör ölçümü.

y

number

Y eksenindeki sensör ölçümü.

z

number

Z eksenindeki sensör ölçümü.

ProcessingState

Dizinin işleme durumu. Eyaletlerin durumu şu şekildedir:

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

Sıra, herhangi bir durumdan BAŞARISIZ durumuna taşınabilir. Ayrıca, işlenen bir dizi herhangi bir zamanda yeniden işlenebilir.

Sıralamalar
PROCESSING_STATE_UNSPECIFIED Eyalet belirtilmemiş. Bu, varsayılan değerdir.
PENDING Sıra henüz işlenmeye başlamadı.
PROCESSING Sıra şu anda işleniyor.
PROCESSED Sıra, ayrıntılandırma konumu da dahil olmak üzere işlenmesi tamamlandı.
FAILED Sıra işlenemedi. Daha fazla ayrıntı için Hata Nedeni'ne bakın.

ProcessingFailureReason

Bu PhotoSequence öğesinin işleyememesinin olası nedenleri.

Sıralamalar
PROCESSING_FAILURE_REASON_UNSPECIFIED Başarısız olma nedeni belirtilmedi. Bu, varsayılan değerdir.
LOW_RESOLUTION Video karesinin çözünürlüğü çok düşük.
DUPLICATE Bu video daha önce yüklendi.
INSUFFICIENT_GPS GPS noktası sayısı çok az.
NO_OVERLAP_GPS GPS parkurunun zaman aralığı ile videonun zaman aralığı arasında çakışma yok.
INVALID_GPS GPS geçersiz (ör. tüm GPS noktaları (0,0) konumunda)
FAILED_TO_REFINE_POSITIONS Fotoğrafların dizisi dünyada doğru bir şekilde konumlandırılamadı.
TAKEDOWN Dizi, politikayla ilgili nedenlerle yayından kaldırıldı.
CORRUPT_VIDEO Video dosyası bozuktu veya kodu çözülemedi.
INTERNAL Temel sistemde kalıcı bir hata oluştu.
INVALID_VIDEO_FORMAT Video biçimi geçersiz veya desteklenmiyor.
INVALID_VIDEO_DIMENSIONS Geçersiz resim en boy oranı bulundu.
INVALID_CAPTURE_TIME Yakalama zamanı geçersiz. Zaman damgaları gelecek bir tarihte.
GPS_DATA_GAP GPS verilerinde 5 saniyeden uzun bir boşluk var.
JUMPY_GPS GPS verileri işlenemeyecek kadar düzensiz.
INVALID_IMU IMU (İvme Ölçer, Jiroskop vb.) verileri geçerli değil. Gerekli alanlar (x, y, z veya zaman) eksik olabilir, doğru şekilde biçimlendirilmemiş olabilir veya sistemlerimizin bu alanı ayrıştırmasını engelleyen başka bir sorun olabilir.
INSUFFICIENT_IMU Çok az IMU puanı var.
INSUFFICIENT_OVERLAP_TIME_SERIES GPS, IMU ve diğer zaman serisi verileri arasındaki zaman aralığında yetersiz örtüşme.
IMU_DATA_GAP IMU (İvme ölçer, Jiroskop vb.) verilerinde 0, 1 saniyeden uzun boşluklar bulunuyor.
UNSUPPORTED_CAMERA Kamera desteklenmiyor.
NOT_OUTDOORS Bazı kareler iç mekanda olduğu için desteklenmiyor.
INSUFFICIENT_VIDEO_FRAMES Yeterli video karesi yok.
INSUFFICIENT_MOVEMENT Yeterli hareketli veri yok.

ProcessingFailureDetails

ProcessFailureNedeni sıralamasına eşlik edecek ek ayrıntılar. Bu mesajın her zaman İşlemeFailureREASON ile birlikte kullanılması beklenir ve bu mesajda ayarlanan bir değer, FailureWhy ile eşleşmelidir.

JSON gösterimi
{

  // Union field details can be only one of the following:
  "insufficientGpsDetails": {
    object (InsufficientGpsFailureDetails)
  },
  "gpsDataGapDetails": {
    object (GpsDataGapFailureDetails)
  },
  "imuDataGapDetails": {
    object (ImuDataGapFailureDetails)
  },
  "notOutdoorsDetails": {
    object (NotOutdoorsFailureDetails)
  },
  "noOverlapGpsDetails": {
    object (NoOverlapGpsFailureDetails)
  }
  // End of list of possible types for union field details.
}
Alanlar
Birleştirme alanı details. Yalnızca bir ayrıntı grubu ayarlanır ve ProcessingFailure sayede ilgili sıralamayla eşleşmelidir. details şunlardan yalnızca biri olabilir:
insufficientGpsDetails

object (InsufficientGpsFailureDetails)

Yetersiz GpsFailureDetails sayfasına göz atın.

gpsDataGapDetails

object (GpsDataGapFailureDetails)

Bkz. GpsDataGapFailureDetails.

imuDataGapDetails

object (ImuDataGapFailureDetails)

Bkz. ImuDataGapFailureDetails.

notOutdoorsDetails

object (NotOutdoorsFailureDetails)

NotOutdoorsFailureDetails sayfasına göz atın.

noOverlapGpsDetails

object (NoOverlapGpsFailureDetails)

NoOverlapGpsFailureDetails konusuna bakın.

InsufficientGpsFailureDetails

İşlemeFailureREASON#INSUFFICIENT_GPS ile ilgili ayrıntılar.

JSON gösterimi
{
  "gpsPointsFound": integer
}
Alanlar
gpsPointsFound

integer

Videoda bulunan GPS noktalarının sayısı.

GpsDataGapFailureDetails

İşlemeFailureREASON#GPS_DATA_GAP ile ilgili ayrıntılar. Birden fazla GPS veri boşluğu varsa, burada yalnızca en uzun süreye sahip olan boşluk raporlanır.

JSON gösterimi
{
  "gapDuration": string,
  "gapStartTime": string
}
Alanlar
gapDuration

string (Duration format)

Bulunan GPS verilerindeki boşluğun süresi.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

gapStartTime

string (Duration format)

Boşluğun başladığı göreli zaman (video akışının başlangıcından itibaren).

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

ImuDataGapFailureDetails

İşlemeFailureCondition#IMU_DATA_GAP ile ilgili ayrıntılar. Birden fazla IMU veri boşluğu varsa burada yalnızca en uzun süreye sahip olan boşluk raporlanır.

JSON gösterimi
{
  "gapDuration": string,
  "gapStartTime": string
}
Alanlar
gapDuration

string (Duration format)

Bulunan IMU verilerindeki boşluğun süresi.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

gapStartTime

string (Duration format)

Boşluğun başladığı göreli zaman (video akışının başlangıcından itibaren).

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

NotOutdoorsFailureDetails

ProcessFailureREASON#NOT_OUTDOORS ile ilgili ayrıntılar. Birden fazla iç mekan karesi bulunursa ilk kare buraya kaydedilir.

JSON gösterimi
{
  "startTime": string
}
Alanlar
startTime

string (Duration format)

Bir iç mekan karesinin bulunduğu göreli süre (video akışının başlangıcından itibaren).

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

NoOverlapGpsFailureDetails

PhotoSequenceProcessingFailure reason#NO_OVERLAP_GPS ile ilgili ayrıntılar.

JSON gösterimi
{
  "gpsStartTime": string,
  "gpsEndTime": string,
  "videoStartTime": string,
  "videoEndTime": string
}
Alanlar
gpsStartTime

string (Timestamp format)

Kaydedilen ilk GPS noktasının zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

gpsEndTime

string (Timestamp format)

Son kaydedilen GPS noktasının saati.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

videoStartTime

string (Timestamp format)

Videonun başlangıç zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

videoEndTime

string (Timestamp format)

Videonun bitiş zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

LatLngBounds

Coğrafi koordinatlardaki dikdörtgen.

JSON gösterimi
{
  "southwest": {
    object (LatLng)
  },
  "northeast": {
    object (LatLng)
  }
}
Alanlar
southwest

object (LatLng)

Bu sınırların güneybatı köşesi.

northeast

object (LatLng)

Bu sınırların kuzeydoğu köşesi.

InputType

PhotoSequence giriş biçimleri.

Sıralamalar
INPUT_TYPE_UNSPECIFIED Belirtilmedi. Sunucu, google.rpc.Code.INVALID_ARGUMENT sonucunu döndürecek.
VIDEO 360 Derece Video.
XDM Genişletilebilir Cihaz Meta Verileri, http://www.xdm.org