- HTTP isteği
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- PhotoSequence
- GpsSource
- Imu
- Measurement3d
- ProcessingState
- ProcessingFailureReason
- ProcessingFailureDetails
- InsufficientGpsFailureDetails
- GpsDataGapFailureDetails
- ImuDataGapFailureDetails
- NotOutdoorsFailureDetails
- NoOverlapGpsFailureDetails
- LatLngBounds
- InputType
- Deneyin.
İ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:
- İstek hatalıysa
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ş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 ( |
Alanlar | |
---|---|
id |
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[] |
Yalnızca çıkış. Zaman damgası artan fotoğraflar. |
uploadReference |
Yalnızca giriş. Fotoğraf dizisi oluştururken gereklidir. Fotoğraf dizisinin (video biçimindeki) baytlarının yüklendiği kaynak adı. |
captureTimeOverride |
İ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: |
uploadTime |
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: |
rawGpsTimeline[] |
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 |
Yalnızca giriş. Hem HamGpsTimeline 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 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 |
Yalnızca çıkış. Bu adım sırasının işlenme durumu. |
failureReason |
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 |
Yalnızca çıkış. Bu adım sırasında |
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 Serisi'nde yayınlanan tüm resimlerin toplam görüntülenme sayısı. |
filename |
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 ( |
Alanlar | |
---|---|
accelMpsps[] |
Cihazlardan gelen zaman damgalarında artışla birlikte metre/sn^2 cinsinden ivme ölçer ölçümleri. |
gyroRps[] |
Cihazlardan gelen zaman damgalarında artış ile birlikte radyan/sn cinsinden jiroskop ölçümleri. |
magUt[] |
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 |
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: |
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. 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 |
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 |
YetersizGpsFailureDetails bölümüne bakın. |
gpsDataGapDetails |
Bkz. GpsDataGapFailureDetails. |
imuDataGapDetails |
ImuDataGapFailureDetails konusuna bakın. |
notOutdoorsDetails |
NotOutdoorsFailureDetails konusuna bakın. |
noOverlapGpsDetails |
NoOverlapGpsFailureDetails konusuna bakın. |
InsufficientGpsFailureDetails
İşlemeFailureNedeni#INSUFFICIENT_GPS ile ilgili ayrıntılar.
JSON gösterimi |
---|
{ "gpsPointsFound": integer } |
Alanlar | |
---|---|
gpsPointsFound |
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 |
Bulunan GPS verilerindeki boşluğun süresi. En fazla dokuz kesir basamağı içeren ve " |
gapStartTime |
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 " |
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 |
Bulunan IMU verilerindeki boşluğun süresi. En fazla dokuz kesir basamağı içeren ve " |
gapStartTime |
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 " |
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 |
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 " |
NoOverlapGpsFailureDetails
PhotoSequenceProcessingFailureREASON#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ı. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
gpsEndTime |
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: |
videoStartTime |
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: |
videoEndTime |
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: |
LatLngBounds
Coğrafi koordinatlarda bir 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 değerini döndürecek. |
VIDEO |
360 derece video. |
XDM |
Genişletilebilir Cihaz Meta Verileri, http://www.xdm.org |