- HTTP isteği
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- PhotoSequence
- GpsSource
- Imu
- Ölçüm3d
- ProcessingState
- ProcessingFailureReason
- ProcessingFailureDetails
- InsufficientGpsFailureDetails
- GpsDataGapFailureDetails
- ImuDataGapFailureDetails
- NotOutdoorsFailureDetails
- NoOverlapGpsFailureDetails
- LatLngBounds
- InputType
- Deneyin.
İ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:
- İstek bozuksa
google.rpc.Code.INVALID_ARGUMENT
. - Yükleme referansı yoksa
google.rpc.Code.NOT_FOUND
.
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 |
Zorunlu. |
İ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 ( |
Alanlar | |
---|---|
id |
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[] |
Yalnızca çıkış. Zaman damgaları artan fotoğraflar. |
uploadReference |
Yalnızca giriş. Fotoğraf dizisi oluştururken gereklidir. Fotoğraf dizisindeki baytların (video biçimindeki) yüklendiği kaynağın adı. |
captureTimeOverride |
İ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: |
uploadTime |
Yalnızca çıkış. Bu fotoğraf dizisinin uSV Store hizmetinde oluşturulma zamanı. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
rawGpsTimeline[] |
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 |
Yalnızca giriş. HemRAWGpsTimeline hem de Camera Motion Metadata Track (CAMM) GPS ölçümleri içeriyorsa hangisinin öncelikli olduğunu belirtin. |
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 |
Yalnızca çıkış. Bu adım sırasının işleme durumu. |
failureReason |
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 |
Yalnızca çıkış. Bu dizide |
distanceMeters |
Yalnızca çıkış. Fotoğraf dizisinin metre cinsinden hesaplanan mesafesi. |
sequenceBounds |
Yalnızca çıkış. Bu fotoğraf dizisindeki her resmi kapsayan dikdörtgen bir kutu. |
viewCount |
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 |
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 ( |
Alanlar | |
---|---|
accelMpsps[] |
Cihazlardan artan zaman damgalarıyla birlikte metre/sn^2 cinsinden ivme ölçer ölçümleri. |
gyroRps[] |
Cihazlardan artan zaman damgalarıyla birlikte radyan/sn cinsinden jiroskop ölçümleri. |
magUt[] |
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 |
IMU ölçümünün zaman damgası. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
x |
X eksenindeki sensör ölçümü. |
y |
Y eksenindeki sensör ölçümü. |
z |
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 |
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 |
Yetersiz GpsFailureDetails sayfasına göz atın. |
gpsDataGapDetails |
Bkz. GpsDataGapFailureDetails. |
imuDataGapDetails |
Bkz. ImuDataGapFailureDetails. |
notOutdoorsDetails |
NotOutdoorsFailureDetails sayfasına göz atın. |
noOverlapGpsDetails |
NoOverlapGpsFailureDetails konusuna bakın. |
InsufficientGpsFailureDetails
İşlemeFailureREASON#INSUFFICIENT_GPS ile ilgili ayrıntılar.
JSON gösterimi |
---|
{ "gpsPointsFound": integer } |
Alanlar | |
---|---|
gpsPointsFound |
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 |
Bulunan GPS verilerindeki boşluğun süresi. En fazla dokuz kesir basamağı olan ve " |
gapStartTime |
Boşluğun başladığı göreli zaman (video akışının başlangıcından itibaren). En fazla dokuz kesir basamağı olan ve " |
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 |
Bulunan IMU verilerindeki boşluğun süresi. En fazla dokuz kesir basamağı olan ve " |
gapStartTime |
Boşluğun başladığı göreli zaman (video akışının başlangıcından itibaren). En fazla dokuz kesir basamağı olan ve " |
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 |
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 " |
NoOverlapGpsFailureDetails
PhotoSequenceProcessingFailure reason#NO_OVERLAP_GPS ile ilgili ayrıntılar.
JSON gösterimi |
---|
{ "gpsStartTime": string, "gpsEndTime": string, "videoStartTime": string, "videoEndTime": string } |
Alanlar | |
---|---|
gpsStartTime |
Kaydedilen ilk GPS noktasının zamanı. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
gpsEndTime |
Son kaydedilen GPS noktasının saati. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
videoStartTime |
Videonun başlangıç zamanı. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
videoEndTime |
Videonun bitiş zamanı. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
LatLngBounds
Coğrafi koordinatlardaki dikdörtgen.
JSON gösterimi |
---|
{ "southwest": { object ( |
Alanlar | |
---|---|
southwest |
Bu sınırların güneybatı köşesi. |
northeast |
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 |