Method: photoSequence.create

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

photoSequence.create, PhotoSequence kimliği Operation.name alanında 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 öğesinin 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şturulan 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'a Genel Bakış başlıklı makaleye bakın.

PhotoSequence

Meta verilerle birlikte 360° fotoğraflar dizisi.

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 dizisinin benzersiz tanımlayıcısı. Yükleme eşzamansız olarak gerçekleştirilirse bu, uzun süreli bir işlem kimliği olarak da işlev görür.
photos[]

object (Photo)

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

object (UploadRef)

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

string (Timestamp format)

İsteğe bağlı. Fotoğraf dizisinin çekilmeye başlandığı mutlak süredir. Fotoğraf dizisi bir video ise bu, videonun başlangıç zamanıdır. Girişte bu alan doldurulursa video veya XDM dosyasındaki çekim zamanını geçersiz kılar.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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ı.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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 zaman senkronize edilmeyen ham GPS ölçümleri. Bu işlenmemiş ölçümler, her karenin pozunu belirlemek için kullanılır. InputType VIDEO olduğunda ve ham GPS ölçümleri Camera Motion Metadata Track'te (CAMM) olmadığında girişte gereklidir. Hem ham GPS zamanı çizelgesinde hem de Camera Motion Meta Veri Track'te (CAMM) ham GPS ölçümleri sağlanıyorsa kullanıcı, gpsSource'u kullanarak hangisinin öncelikli olduğunu belirtebilir.
gpsSource

enum (GpsSource)

Yalnızca giriş. Hem HamGpsTimeline 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 veriler isteğe eklenemeyecek kadar büyükse videonun CAMM kanalına eklenmesi gerekir. Bu veriler, varsa eşdeğer CAMM verilerine göre her zaman önceliklidir.
processingState

enum (ProcessingState)

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

enum (ProcessingFailureReason)

Yalnızca çıkış. Bu dizide transactionState = BAŞARISIZ ise bu sayı, başarısızlığın nedenini içerir. transactionState için başka bir değer varsa bu alan ayarlanmaz.
failureDetails

object (ProcessingFailureDetails)

Yalnızca çıkış. Bu adım sırasında failureReason ayarlanmışsa bu bölüm, hatayla ilgili ek ayrıntıları içerebilir.
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 Serisi'nde yayınlanan tüm resimlerin toplam görüntülenme sayısı.
filename

string

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

GpsSource

GPS ölçümlerinin birincil kaynağı.

Sıralamalar
PHOTO_SEQUENCE RawGpsTimeline'daki GPS, varsa önceliklidir.
CAMERA_MOTION_METADATA_TRACK Camera Motion Metadata Track'te (CAMM) GPS varsa, varsa önceliklidir.

Imu Dili

Cihaz sensörlerinden alınan IMU verileri.

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

object (Measurement3d)

Cihazlardan gelen zaman damgalarında artışla birlikte metre/sn^2 cinsinden ivme ölçer ölçümleri.
gyroRps[]

object (Measurement3d)

Cihazlardan gelen zaman damgalarında artış ile birlikte radyan/sn cinsinden jiroskop ölçümleri.
magUt[]

object (Measurement3d)

Cihazlardan gelen zaman damgalarının artmasıyla mikrotesla (uT) cinsinden manyetometre ölçümleri.

Ölçüm3g

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

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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. Eyaletler aşağıdaki gibi hareket eder:

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

Dizi, herhangi bir durumdan BAŞARISIZ OLDU. Ayrıca, işlenen bir dizi herhangi bir zamanda yeniden işlenebilir.

Sıralamalar
PROCESSING_STATE_UNSPECIFIED Durum belirtilmemiş. Bu, varsayılan değerdir.
PENDING Dizi henüz işlenmeye başlamadı.
PROCESSING Dizi şu anda işleniyor.
PROCESSED Konumun daraltılması dahil olmak üzere dizinin işlenmesi tamamlandı.
FAILED Sıra işlenemedi. Daha ayrıntılı bilgi için Hata Nedenine bakın.

ProcessingFailureReason

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

Sıralamalar
PROCESSING_FAILURE_REASON_UNSPECIFIED Hata 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 çerçevesi ile videonun zaman aralığı arasında çakışma olmamalıdır.
INVALID_GPS GPS geçersiz (ör. tüm GPS noktaları (0,0))
FAILED_TO_REFINE_POSITIONS Fotoğraf dizisi dünyada doğru bir şekilde konumlandırılamadı.
TAKEDOWN Sıra, politikayla ilgili nedenlerle 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 Geçersiz yakalama zamanı. Zaman damgaları geleceğe aitti.
GPS_DATA_GAP GPS verilerinde 5 saniyeden uzun bir boşluk var.
JUMPY_GPS GPS verileri işlenemeyecek kadar düzenli.
INVALID_IMU IMU (İvme ölçer, Jiroskop vb.) verileri geçerli değil. Bunlarda gerekli alanlar (x, y, z veya zaman) eksik olabilir, doğru biçimlendirilmemiş olabilir veya sistemlerimizin verileri ayrıştırmasını engelleyen başka sorunlar 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 var.
UNSUPPORTED_CAMERA Kamera desteklenmiyor.
NOT_OUTDOORS Bazı kareler içeride olduğu için desteklenmiyor.
INSUFFICIENT_VIDEO_FRAMES Yeterli video karesi yok.
INSUFFICIENT_MOVEMENT Yeterli hareketli veri yok.

ProcessingFailureDetails

İşlemeFailureNedeni sıralamasıyla birlikte yer alacak ek ayrıntılar. Bu iletinin her zaman İşlemeFailureNedeni ile birlikte kullanılması beklenir ve bu mesajda ayarlanan bir değeri, FailureNedeni 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
details alanı. Yalnızca bir ayrıntı grubu ayarlanır ve İşlemeFailureNedenindeki ilgili enum ile eşleşmelidir. details şunlardan yalnızca biri olabilir:
insufficientGpsDetails

object (InsufficientGpsFailureDetails)

YetersizGpsFailureDetails bölümüne bakın.
gpsDataGapDetails

object (GpsDataGapFailureDetails)

Bkz. GpsDataGapFailureDetails.
imuDataGapDetails

object (ImuDataGapFailureDetails)

ImuDataGapFailureDetails konusuna bakın.
notOutdoorsDetails

object (NotOutdoorsFailureDetails)

NotOutdoorsFailureDetails konusuna bakın.
noOverlapGpsDetails

object (NoOverlapGpsFailureDetails)

NoOverlapGpsFailureDetails konusuna bakın.

InsufficientGpsFailureDetails

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

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

integer

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

GpsDataGapFailureDetails

İşlemeFailureNedeni#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 rapor edilir.

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ğı içeren ve "s" ile biten saniye cinsinden bir 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ğı içeren ve "s" ile biten saniye cinsinden bir süre. Örnek: "3.5s".

ImuDataGapFailureDetails

İşlemeFailureNedeni#IMU_DATA_GAP ile ilgili ayrıntılar. Birden fazla IMU veri boşluğu varsa burada yalnızca en uzun süreli veri boşluğu 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ğı içeren ve "s" ile biten saniye cinsinden bir 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ğı içeren ve "s" ile biten saniye cinsinden bir süre. Örnek: "3.5s".

NotOutdoorsFailureDetails

İşlemeFailureNedeni#NOT_OUTDOORS ile ilgili ayrıntılar. Birden fazla iç mekan çerçevesi bulunursa ilk kare burada 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ğı içeren ve "s" ile biten saniye cinsinden bir süre. Örnek: "3.5s".

NoOverlapGpsFailureDetails

PhotoSequenceProcessingFailureREASON#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ı.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
gpsEndTime

string (Timestamp format)

Kaydedilen son GPS noktasının zamanı.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
videoStartTime

string (Timestamp format)

Videonun başlangıç zamanı.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
videoEndTime

string (Timestamp format)

Videonun bitiş zamanı.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

LatLngBounds

Coğrafi koordinatlarda bir 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 değerini döndürecek.
VIDEO 360 derece video.
XDM Genişletilebilir Cihaz Meta Verileri, http://www.xdm.org