Method: photoSequence.create

İstemci, döndürülen UploadRef ile PhotoSequence yüklemeyi tamamladıktan sonra photoSequence.create, Google Haritalar'da Street View'de yayınlanacak bir videodan veya Genişletilebilir Cihaz Meta Verileri'nden (XDM, http://www.xdm.org/) 360 fotoğraf dizisi çı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ş formu.

İstek metni

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

Yanıt metni

Başarılı olursa yanıt metni, yeni oluşturulan 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 sayfasına bakın.

PhotoSequence

Meta verilerle birlikte 360° fotoğraflardan oluşan bir dizi.

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 işlemi eşzamansız olarak gerçekleştiriliyorsa bu, uzun süreli 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 dizisinin (video şeklinde) baytlarının yüklendiği kaynak adı.
captureTimeOverride

string (Timestamp format)

İsteğe bağlıdır. Fotoğraf dizisinin çekilmeye başlandığı mutlak zaman. Fotoğraf dizisi bir videodan oluşuyorsa bu, videonun başlangıç zamanıdır. Bu alan girişte doldurulursa videodaki veya XDM dosyasındaki yakalama zamanını geçersiz kılar.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
uploadTime

string (Timestamp format)

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

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
rawGpsTimeline[]

object (Pose)

Yalnızca giriş. Cihazdan alınan, her fotoğrafla zaman senkronizasyonu yapılmamış ve zaman damgaları artan ham GPS ölçümleri. Bu ham ölçümler, her karenin pozunu tahmin etmek 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. Kullanıcı, hem rawGpsTimeline hem de Camera Motion Metadata Track (CAMM) içinde ham GPS ölçümleri sağlanıyorsa gpsSource kullanarak hangisinin öncelikli olduğunu belirtebilir.
gpsSource

enum (GpsSource)

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

object (Imu)

Yalnızca giriş. Toplama için üç eksenli IMU verileri. Bu veriler isteğe eklenecek kadar büyükse videonun CAMM parçasında yer almalıdır. Bu veriler, varsa her zaman eşdeğer CAMM verilerine göre önceliklidir.
processingState

enum (ProcessingState)

Yalnızca çıkış. Bu dizinin işleme durumu.
failureReason

enum (ProcessingFailureReason)

Yalnızca çıkış. Bu dizinin processingState = FAILED ise başarısız olma nedeni burada yer alır. processingState başka bir değerse bu alan ayarlanmaz.
failureDetails

object (ProcessingFailureDetails)

Yalnızca çıkış. Bu sırada failureReason ayarlanmışsa bu, hatayla ilgili ek ayrıntılar içerebilir.
distanceMeters

number

Yalnızca çıkış. Fotoğraf dizisinin hesaplanan mesafesi (metre).
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 PhotoSequence'te yayınlanan tüm resimlerin aldığı toplam görüntüleme sayısı.
filename

string

Yalnızca çıkış. Yüklemenin dosya adı. Dizin yolu dahil değildir. Yalnızca dizinin, dosya adını sağlayan bir platforma yüklenmesi durumunda kullanılabilir.

GpsSource

GPS ölçümlerinin birincil kaynağı.

Sıralamalar
PHOTO_SEQUENCE rawGpsTimeline'da GPS varsa öncelikli olur.
CAMERA_MOTION_METADATA_TRACK Kamera Hareketi Meta Verileri İzinde (CAMM) GPS varsa öncelikli olur.

Imu

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, artan zaman damgalarıyla birlikte metre/sn^2 cinsinden ivmeölçer ölçümleri.
gyroRps[]

object (Measurement3d)

Cihazlardan gelen, zaman damgaları artan radyan/sn cinsinden jiroskop ölçümleri.
magUt[]

object (Measurement3d)

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

Measurement3d

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

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
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. Durumlar aşağıdaki şekilde değişir:

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

Sıra, herhangi bir durumdan BAŞARISIZ durumuna geçebilir. Ayrıca, işlenen bir sıra herhangi bir zamanda yeniden işlenebilir.

Sıralamalar
PROCESSING_STATE_UNSPECIFIED Durum belirtilmemiştir. Bu, varsayılan değerdir.
PENDING Sıra henüz işlenmeye başlamadı.
PROCESSING Sıra şu anda işleniyor.
PROCESSED Pozisyonu iyileştirme de dahil olmak üzere dizinin işlenmesi tamamlandı.
FAILED Sıra işlenemedi. Daha fazla bilgi için FailureReason'a 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üklenmiş.
INSUFFICIENT_GPS Çok az GPS noktası var.
NO_OVERLAP_GPS GPS izinin zaman aralığı ile videonun zaman aralığı arasında çakışma olmamalıdır.
INVALID_GPS GPS geçersiz (ör. tüm GPS noktaları (0,0) konumunda)
FAILED_TO_REFINE_POSITIONS Fotoğrafların sırası dünyada doğru şekilde bulunamadı.
TAKEDOWN Sıra, politika nedenleriyle kaldırıldı.
CORRUPT_VIDEO Video dosyası bozuk veya kod çözme işlemi yapılamadı.
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 çekim zamanı. Zaman damgaları gelecekteki bir tarihe aitti.
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 ya da sistemlerimizin ayrıştırmasını engelleyen başka bir sorun olabilir.
INSUFFICIENT_IMU Çok az IMU noktası var.
INSUFFICIENT_OVERLAP_TIME_SERIES GPS, IMU ve diğer zaman serisi verileri arasındaki zaman aralığında yeterli örtüşme olmaması.
IMU_DATA_GAP IMU (ivme ölçer, jiroskop vb.) verileri 0, 1 saniyeden uzun boşluklar içeriyor.
UNSUPPORTED_CAMERA Kamera desteklenmiyor.
NOT_OUTDOORS Bazı kareler iç mekanda çekilmiş. Bu durum desteklenmez.
INSUFFICIENT_VIDEO_FRAMES Yeterli sayıda video karesi yok.
INSUFFICIENT_MOVEMENT Yeterli hareket verisi yok.
MAST_DOWN Direk aşağı bakıyor.
CAMERA_COVERED Kameranın üstü kapalı.

ProcessingFailureDetails

ProcessingFailureReason enum'ına eşlik edecek ek ayrıntılar. Bu mesajın her zaman ProcessingFailureReason ile birlikte kullanılması beklenir ve bu mesajda ayarlanan oneof değeri FailureReason 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 birleşik alanı. Yalnızca bir grup ayrıntı ayarlanır ve ProcessingFailureReason'daki ilgili enum ile eşleşmelidir. details aşağıdakilerden yalnızca biri olabilir:
insufficientGpsDetails

object (InsufficientGpsFailureDetails)

InsufficientGpsFailureDetails konusuna bakın.
gpsDataGapDetails

object (GpsDataGapFailureDetails)

GpsDataGapFailureDetails'i inceleyin.
imuDataGapDetails

object (ImuDataGapFailureDetails)

ImuDataGapFailureDetails'i inceleyin.
notOutdoorsDetails

object (NotOutdoorsFailureDetails)

NotOutdoorsFailureDetails'e bakın.
noOverlapGpsDetails

object (NoOverlapGpsFailureDetails)

NoOverlapGpsFailureDetails'i inceleyin.

InsufficientGpsFailureDetails

ProcessingFailureReason#INSUFFICIENT_GPS ile ilgili ayrıntılar.

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

integer

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

GpsDataGapFailureDetails

ProcessingFailureReason#GPS_DATA_GAP ile ilgili ayrıntılar. Birden fazla GPS verisi boşluğu varsa yalnızca en uzun süreli olan burada bildirilir.

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

string (Duration format)

GPS verilerinde bulunan boşluğun süresi.

En fazla dokuz kesirli basamak içeren 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 kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

ImuDataGapFailureDetails

ProcessingFailureReason#IMU_DATA_GAP ile ilgili ayrıntılar. Birden fazla IMU veri boşluğu varsa yalnızca en uzun süreli olan burada bildirilir.

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

string (Duration format)

IMU verilerinde bulunan boşluğun süresi.

En fazla dokuz kesirli basamak içeren 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 kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

NotOutdoorsFailureDetails

ProcessingFailureReason#NOT_OUTDOORS ile ilgili ayrıntılar. Birden fazla iç mekan çerçevesi bulunursa ilk çerçeve buraya kaydedilir.

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

string (Duration format)

Bir iç mekan çerçevesinin bulunduğu göreli zaman (video akışının başlangıcından itibaren).

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden 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ı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
gpsEndTime

string (Timestamp format)

Kaydedilen son GPS noktasının zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
videoStartTime

string (Timestamp format)

Videonun başlangıç zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
videoEndTime

string (Timestamp format)

Videonun bitiş zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

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ürür.
VIDEO 360 derece video.
XDM Extensible Device Metadata, http://www.xdm.org