Package google.streetview.publish.v1

Dizin

StreetViewPublishService

Kullanıcılar tarafından eklenen fotoğrafları Street View'da yayınlar ve birbirine bağlar.

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Photos listesini ve meta verilerini siler.

BatchDeletePhotos başarısız olursa kritik alanların eksik olduğunu veya kimlik doğrulama hatası oluştuğunu unutmayın. BatchDeletePhotos başarılı olsa bile gruptaki her fotoğrafta hata oluşabilir. Bu hatalar BatchDeletePhotosResponse.results içindeki her bir PhotoResponse.status için belirtilir. Her fotoğraf için oluşabilecek belirli hatalar için DeletePhoto inceleyin.

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.

BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

Belirtilen Photo grubunun meta verilerini alır.

BatchGetPhotos başarısız olursa kritik alanların eksik olduğunu veya kimlik doğrulama hatası oluştuğunu unutmayın. BatchGetPhotos başarılı olsa bile gruptaki her fotoğrafta hata oluşabilir. Bu hatalar BatchGetPhotosResponse.results içindeki her bir PhotoResponse.status için belirtilir. Her fotoğraf için oluşabilecek belirli hatalar için GetPhoto inceleyin.

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.

BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

Photos öğesinin poz, yer ilişkilendirmesi, bağlantılar gibi meta verilerini günceller. Fotoğrafların piksellerinin değiştirilmesi desteklenmez.

BatchUpdatePhotos başarısız olursa kritik alanların eksik olduğunu veya kimlik doğrulama hatası oluştuğunu unutmayın. BatchUpdatePhotos başarılı olsa bile gruptaki her fotoğrafta hata oluşabilir. Bu hatalar BatchUpdatePhotosResponse.results içindeki her bir PhotoResponse.status için belirtilir. Her fotoğraf için oluşabilecek belirli hatalar için UpdatePhoto inceleyin.

Yalnızca updateMask alanında belirtilen alanlar kullanılır. updateMask mevcut değilse güncelleme tüm alanlara uygulanır.

BatchUpdatePhotosRequest içinde UpdatePhotoRequest mesaj sayısı 20'yi aşmamalıdır.

Not: Pose.altitude uygulamasını güncellemek için Pose.latLngPair alanının da doldurulması gerekir. Aksi takdirde istek başarısız olur.

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.

CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

Müşteri iade edilen UploadRef ile fotoğrafı yüklemeyi tamamladıktan sonra CreatePhoto, yüklenen Photo dosyasını Google Haritalar'da Street View'da yayınlar.

Şu anda CreatePhoto'da başlık, sunum ve zarı ayarlamanın tek yolu fotoğraf baytları cinsinden Photo Sphere XMP meta verileri kullanmaktır. CreatePhoto, Poz'daki pose.heading, pose.pitch, pose.roll, pose.altitude ve pose.level alanlarını yoksayar.

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

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.

CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

İstemci döndürülen UploadRef ile PhotoSequence dosyasını yüklemeyi bitirdikten sonra, CreatePhotoSequence 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.

CreatePhotoSequence, 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:

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.

DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

Bir Photo öğesini ve meta verilerini siler.

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

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.

DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

Bir PhotoSequence öğesini ve meta verilerini siler.

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

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.

GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

Belirtilen Photo öğesinin meta verilerini alır.

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

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.

GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

Operation arayüzü aracılığıyla belirtilen PhotoSequence öğesinin meta verilerini alır.

Bu yöntem aşağıdaki üç yanıt türünü döndürür:

  • Operation.done = false (yanlış), PhotoSequence öğesinin işlenmesi henüz tamamlanmadıysa.
  • Operation.done = true (doğru) değerine ayarlanırsa Operation.error doldurulur.
  • Operation.done = true (doğru) değerine ve Operation.response değerine ulaşırsa PhotoSequence mesajı içerir.

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

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.

ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

Kullanıcıya ait tüm PhotoSequences öğelerini, azalan CreatePhotoSequence zaman damgası sırasında listeler.

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.

ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

Kullanıcıya ait tüm Photos listelenir.

Not: Yakın zamanda oluşturulan ve dizine eklenmekte olan fotoğraflar yanıtta döndürülmez.

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.

StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

Fotoğraf dizisi verilerini yüklemeye başlamak için yükleme oturumu oluşturur. Döndürülen UploadRef öğesinin yükleme URL'si, photoSequence için veri yüklemek amacıyla kullanılır.

Yükleme tamamlandıktan sonra UploadRef, PhotoSequence nesne girişini oluşturmak için CreatePhotoSequence ile kullanılır.

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.

StartUpload

rpc StartUpload(Empty) returns (UploadRef)

Fotoğraf baytları yüklemeye başlamak için yükleme oturumu oluşturur. Yöntem, Photo için baytları yüklemek üzere döndürülen UploadRef öğesinin yükleme URL'sini kullanır.

https://support.google.com/maps/answer/7012050?ref_topic=6275604 adresinde gösterilen fotoğraf şartlarının yanı sıra fotoğraf aşağıdaki koşulları da karşılamalıdır:

Yükleme işlemi tamamlandıktan sonra yöntem, Photo nesne girişini oluşturmak için CreatePhoto ile UploadRef yöntemini kullanır.

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.

UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

Bir Photo öğesinin poz, yer ilişkilendirmesi, bağlantılar gibi meta verilerini günceller. Fotoğrafın piksellerini değiştirme desteklenmiyor.

Yalnızca updateMask alanında belirtilen alanlar kullanılır. updateMask mevcut değilse güncelleme tüm alanlara uygulanır.

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

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.

BatchDeletePhotosRequest

Birden çok Photos silme isteği.

Alanlar
photo_ids[]

string

Zorunlu. Photos kimlikleri. HTTP GET istekleri, URL sorgu parametresi için şu söz dizimini gerektirir: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

Bir veya daha fazla Photos için toplu silme yanıtı.

Alanlar
status[]

Status

Toplu istekteki tek bir Photo öğesini silme işleminin durumu.

BatchGetPhotosRequest

Bir veya daha fazla Photos alma isteği gönderin. Varsayılan olarak

  • fotoğraf baytları için indirme URL'sini döndürmez.

Parametreler:

  • view, fotoğraf baytları için indirme URL'sinin döndürülüp döndürülmeyeceğini kontrol eder.
Alanlar
photo_ids[]

string

Zorunlu. Photos kimlikleri. HTTP GET istekleri için URL sorgu parametresi photoIds=<id1>&photoIds=<id2>&... olmalıdır.

view

PhotoView

Zorunlu. Fotoğraf yanıtında fotoğraf baytları için bir indirme URL'sinin döndürülüp döndürülmeyeceğini belirler.

language_code

string

İsteğe bağlı. BCP-47 dil kodu (ör. "en-US" veya "sr-Latn"). Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier sayfasına bakın. dil_kodu belirtilmezse kullanıcının Google hizmetleri için dil tercihi kullanılır.

BatchGetPhotosResponse

Photos toplu alımına yanıt.

Alanlar
results[]

PhotoResponse

BatchGetPhotos politikasındaki isteklerle aynı sırada, istenen her bir Photo için sonuç listesi.

BatchUpdatePhotosRequest

Fotoğrafların meta verilerini güncelleme isteğinde bulunun. Fotoğrafların piksellerinin güncellenmesi desteklenmiyor.

Alanlar
update_photo_requests[]

UpdatePhotoRequest

Zorunlu. UpdatePhotoRequests listesi.

BatchUpdatePhotosResponse

Bir veya daha fazla Photos meta verisinin toplu güncellemesine verilen yanıt.

Alanlar
results[]

PhotoResponse

Her bir Photo için sonuçların listesi, istekle aynı sırada güncellenir.

Bağlantı

Bağlantı, kaynak fotoğraftan hedef fotoğrafa bağlantıdır.

Alanlar
target

PhotoId

Zorunlu. İçeren fotoğrafla başka bir fotoğraf arasındaki bağlantının hedefi.

CreatePhotoRequest

Photo oluşturma isteği.

Alanlar
photo

Photo

Zorunlu. Oluşturulacak fotoğraf.

CreatePhotoSequenceRequest

Bir videodan PhotoSequence oluşturma isteği.

Alanlar
photo_sequence

PhotoSequence

Zorunlu. Oluşturmak için PhotoSequence.

input_type

InputType

Zorunlu. PhotoSequence öğesinin giriş biçimi.

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

DeletePhotoRequest

Photo silme isteği.

Alanlar
photo_id

string

Zorunlu. Photo kimliği.

DeletePhotoSequenceRequest

PhotoSequence silme isteği.

Alanlar
sequence_id

string

Zorunlu. PhotoSequence kimliği.

GetPhotoRequest

Photo isteme.

Varsayılan olarak

  • fotoğraf baytları için indirme URL'sini döndürmez.

Parametreler:

  • view, fotoğraf baytları için indirme URL'sinin döndürülüp döndürülmeyeceğini kontrol eder.
Alanlar
photo_id

string

Zorunlu. Photo kimliği.

view

PhotoView

Zorunlu. Photo yanıtında fotoğraf baytları için bir indirme URL'sinin döndürülüp döndürülmeyeceğini belirler.

language_code

string

BCP-47 dil kodu (ör. "en-US" veya "sr-Latn"). Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier sayfasına bakın. dil_kodu belirtilmezse kullanıcının Google hizmetleri için dil tercihi kullanılır.

GetPhotoSequenceRequest

PhotoSequence isteme.

Varsayılan olarak

Parametreler:

  • view, PhotoSequence için indirme URL'sinin döndürülüp döndürülmeyeceğini kontrol eder.
Alanlar
sequence_id

string

Zorunlu. Fotoğraf dizisinin kimliği.

view
(deprecated)

PhotoView

PhotoSequence yanıtında, fotoğraf dizisi için bir indirme URL'sinin tek tek fotoğrafların download_url tanesinde döndürülüp döndürülmeyeceğini belirler.

Not: Şu anda uygulanmamıştır.

filter

string

İsteğe bağlı. Filtre ifadesi. Örneğin: published_status=PUBLISHED.

Desteklenen filtreler: published_status. Daha fazla bilgi için https://google.aip.dev/160 adresini ziyaret edin.

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.

Alanlar
gap_duration

Duration

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

gap_start_time

Duration

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

Imu Dili

Cihaz sensörlerinden alınan IMU verileri.

Alanlar
accel_mpsps[]

Measurement3d

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

gyro_rps[]

Measurement3d

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

mag_ut[]

Measurement3d

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

Ölçüm3g

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

Alanlar
capture_time

Timestamp

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

x

float

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

y

float

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

z

float

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

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.

Alanlar
gap_duration

Duration

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

gap_start_time

Duration

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

InsufficientGpsFailureDetails

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

Alanlar
gps_points_found

int32

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

LatLngBounds

Coğrafi koordinatlarda bir dikdörtgen.

Alanlar
southwest

LatLng

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

northeast

LatLng

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

Seviye

Seviye numarasını ve ilgili adı içeren seviye bilgileri.

Alanlar
number

double

İsteğe bağlı. Kat numarası, sipariş için kullanılır. 0, yer seviyesini, 1 yer seviyesinden ilk düzeyi, -1 ise yer seviyesi altındaki ilk seviyeyi belirtir. Tam sayı olmayan değerler kabul edilebilir.

name

string

Zorunlu. Bu Seviyeye atanmış, 3 karakterle sınırlı bir ad. Asansör olsaydı bu kat için asansör düğmelerinin nasıl etiketleneceğini düşünün.

ListPhotoSequencesRequest

İsteği gönderen kullanıcıya ait tüm fotoğraf dizilerini listeleme isteği.

Parametreler:

  • pageSize, döndürülecek maksimum fotoğraf dizisi sayısını belirler.
  • pageToken, varsa önceki ListPhotoSequences isteğinden döndürülen sonraki sayfa jetonu değeridir.
Alanlar
page_size

int32

İsteğe bağlı. Döndürülecek maksimum fotoğraf dizisi sayısı. pageSize, negatif olmamalıdır. pageSize sıfırsa veya sağlanmazsa 100 olan varsayılan sayfa boyutu kullanılır. Eşleşme sayısı pageSize değerinden azsa yanıtta döndürülen fotoğraf dizisi sayısı pageSize değerinden az olabilir. Bu, şu anda uygulanmamaktadır ancak devam etmektedir.

page_token

string

İsteğe bağlı. Varsa önceki ListPhotoSequences isteğinden döndürülen nextPageToken değeri.

filter

string

İsteğe bağlı. Filtre ifadesi. Örneğin: imagery_type=SPHERICAL.

Desteklenen filtreler şunlardır: imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, `max_capture_time_seconds. Daha fazla bilgi için https://google.aip.dev/160 adresini ziyaret edin. Dosya adı sorguları, çıkış yapılmış tırnak işaretleri eklenerek birden çok kelime ve özel karakteri desteklemek için Öbek olarak gönderilmelidir. Ör: filename_query="kelime öbeği.mp4 örneği"

ListPhotoSequencesResponse

Bir kullanıcıya ait olan tüm fotoğraf dizilerini listeleme yanıtı.

Alanlar
photo_sequences[]

Operation

Operation arayüzü üzerinden oluşturulan fotoğraf dizilerinin listesi.

Döndürülen maksimum öğe sayısı, istekteki pageSize alanına bağlıdır.

Listedeki her öğe, üç olası duruma sahip olabilir:

  • Operation.done = false (yanlış), PhotoSequence öğesinin işlenmesi henüz tamamlanmadıysa.
  • Operation.done = true (doğru) değerine ayarlanırsa Operation.error doldurulur.
  • Operation.done = true (doğru) değerine ayarlanırsa ve Operation.response, bir PhotoSequence mesajı içerir. Her dizide yalnızca Id doldurulur.
next_page_token

string

Sonraki sonuç sayfasını almak için jeton veya listede başka sonuç yoksa boştur.

ListPhotosRequest

İsteği gönderen kullanıcıya ait tüm fotoğrafların listelenmesi isteği.

Varsayılan olarak

  • fotoğraf baytları için indirme URL'sini döndürmez.

Parametreler:

  • view, fotoğraf baytları için indirme URL'sinin döndürülüp döndürülmeyeceğini kontrol eder.
  • pageSize, iade edilecek maksimum fotoğraf sayısını belirler.
  • pageToken, varsa önceki ListPhotos isteğinden döndürülen sonraki sayfa jetonu değeridir.
  • filter, belirli bir parametreye göre filtreleme yapılmasına olanak tanır. Şu anda desteklenen tek parametre "placeId"dir.
Alanlar
view

PhotoView

Zorunlu. Fotoğraflar yanıtında fotoğraf baytları için bir indirme URL'sinin döndürülüp döndürülmeyeceğini belirler.

page_size

int32

İsteğe bağlı. İade edilecek maksimum fotoğraf sayısı. pageSize, negatif olmamalıdır. pageSize sıfırsa veya sağlanmazsa 100 olan varsayılan sayfa boyutu kullanılır. Kullanıcıya ait fotoğraf sayısı pageSize değerinden azsa yanıtta döndürülen fotoğraf sayısı en fazla pageSize olabilir.

page_token

string

İsteğe bağlı. Varsa önceki ListPhotos isteğinden döndürülen nextPageToken değeri.

filter

string

İsteğe bağlı. Filtre ifadesi. Örneğin: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw.

Desteklenen filtreler şunlardır: placeId, min_latitude, max_latitude, min_longitude, max_longitude. Daha fazla bilgi için https://google.aip.dev/160 adresini ziyaret edin.

language_code

string

İsteğe bağlı. BCP-47 dil kodu (ör. "en-US" veya "sr-Latn"). Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier sayfasına bakın. dil_kodu belirtilmezse kullanıcının Google hizmetleri için dil tercihi kullanılır.

ListPhotosResponse

"Bir kullanıcıya ait" olan tüm fotoğrafların listelendiği yanıt.

Alanlar
photos[]

Photo

Fotoğraf listesi. İstekteki pageSize alanı, döndürülen öğelerin sayısını belirler.

next_page_token

string

Sonraki sonuç sayfasını almak için jeton veya listede başka sonuç yoksa boştur.

NoOverlapGpsFailureDetails

PhotoSequenceProcessingFailureREASON#NO_OVERLAP_GPS ile ilgili ayrıntılar.

Alanlar
gps_start_time

Timestamp

Kaydedilen ilk GPS noktasının zamanı.

gps_end_time

Timestamp

Kaydedilen son GPS noktasının zamanı.

video_start_time

Timestamp

Videonun başlangıç zamanı.

video_end_time

Timestamp

Videonun bitiş zamanı.

NotOutdoorsFailureDetails

İşlemeFailureNedeni#NOT_OUTDOORS ile ilgili ayrıntılar. Birden fazla iç mekan çerçevesi bulunursa ilk kare burada kaydedilir.

Alanlar
start_time

Duration

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

Fotoğraf

Fotoğraf, 360° fotoğrafları fotoğraf meta verileriyle birlikte depolamak için kullanılır.

Alanlar
photo_id

PhotoId

Zorunlu. Yalnızca çıkış. Fotoğraf güncellenirken gereklidir. Yalnızca fotoğraf oluştururken çıktı alın. Fotoğrafın, Google'daki tüm fotoğraflar arasında benzersiz olan kimliği.

upload_reference

UploadRef

Yalnızca giriş. Fotoğraf oluştururken gereklidir. Yalnızca giriş. Fotoğraf baytlarının yüklendiği kaynak URL'si.

download_url

string

Yalnızca çıkış. Fotoğraf baytları için indirme URL'si. Bu alan yalnızca GetPhotoRequest.view, PhotoView.INCLUDE_DOWNLOAD_URL olarak ayarlandığında ayarlanır.

thumbnail_url

string

Yalnızca çıkış. Fotoğrafın önizlemesini gösteren küçük resim URL'si.

pose

Pose

İsteğe bağlı. Fotoğrafın pozu.

connections[]

Connection

İsteğe bağlı. Diğer fotoğraflara bağlantılar. Bağlantı, bu fotoğraftan başka bir fotoğrafa giden bağlantıyı temsil eder.

capture_time

Timestamp

İsteğe bağlı. Fotoğrafın çekildiği mutlak zamandır. Fotoğrafta EXIF zaman damgası yoksa, fotoğraf meta verilerine zaman damgası eklemek için kullanılır.

upload_time

Timestamp

Yalnızca çıkış. Resmin yüklendiği zaman.

places[]

Place

İsteğe bağlı. Bu fotoğrafın ait olduğu yerler.

view_count

int64

Yalnızca çıkış. Fotoğrafın görüntülenme sayısı.

transfer_status

TransferStatus

Yalnızca çıkış. Bu fotoğraftaki hak aktarımının durumu.

maps_publish_status

MapsPublishStatus

Yalnızca çıkış. Google Haritalar'daki durum (bu fotoğrafın yayınlanmış veya reddedilmiş olmasına bakılmaksızın).

MapsPublishStatus

Fotoğrafın Google Haritalar'daki yayınlanma durumu.

Sıralamalar
UNSPECIFIED_MAPS_PUBLISH_STATUS Fotoğrafın durumu bilinmiyor.
PUBLISHED Fotoğraf, Google Haritalar aracılığıyla herkese açık olarak yayınlanır.
REJECTED_UNKNOWN Fotoğraf bilinmeyen bir nedenden dolayı reddedildi.

TransferStatus

Hak aktarımının durumu.

Sıralamalar
TRANSFER_STATUS_UNKNOWN Bu aktarımın durumu belirtilmedi.
NEVER_TRANSFERRED Bu fotoğraf daha önce hiç aktarıma dahil edilmedi.
PENDING Bu fotoğraf aktarımı başlatıldı ancak alıcı henüz yanıt vermedi.
COMPLETED Fotoğraf aktarımı tamamlandı ve bu fotoğraf alıcıya aktarıldı.
REJECTED Alıcı bu fotoğraf aktarımını reddetti.
EXPIRED Alıcı herhangi bir işlem yapmadan önce fotoğraf aktarımının süresi doldu.
CANCELLED Gönderen, bu fotoğraf aktarımını iptal etti.
RECEIVED_VIA_TRANSFER Bir hak aktarımı nedeniyle bu fotoğrafın sahibi alıcıya ait.

PhotoId

Photo için tanımlayıcı.

Alanlar
id

string

Fotoğraf için benzersiz bir tanımlayıcı.

PhotoResponse

BatchGetPhotos ve BatchUpdatePhotos dahil olmak üzere toplu işlemlerde tek bir Photo için yanıt yükü.

Alanlar
status

Status

Toplu istekte tek bir fotoğraf alma veya güncelleme işleminin durumu.

photo

Photo

İstek başarılı olduysa Photo kaynağı.

PhotoSequence

Meta verilerle birlikte 360° fotoğraflar dizisi.

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[]

Photo

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

upload_reference

UploadRef

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

capture_time_override

Timestamp

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

upload_time

Timestamp

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

raw_gps_timeline[]

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. HemRAW_gps_timeline hem de Camera Motion Meta Veri Track'te (CAMM) ham GPS ölçümleri sağlanıyorsa kullanıcı, gps_source etiketini kullanarak hangisinin öncelikli olduğunu belirtebilir.

gps_source

GpsSource

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

imu

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.

processing_state

ProcessingState

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

failure_reason

ProcessingFailureReason

Yalnızca çıkış. Bu dizide transaction_state = BAŞARISIZ varsa başarısızlığın nedenini içerir. transaction_state için başka bir değer varsa bu alan ayarlanmadan bırakılır.

failure_details

ProcessingFailureDetails

Yalnızca çıkış. Bu adım sırasında failure_reason ayarlanmışsa bu bölüm, hatayla ilgili ek ayrıntıları içerebilir.

distance_meters

double

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

sequence_bounds

LatLngBounds

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

view_count

int64

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 Ham_gps_timeline içindeki GPS varsa önceliklidir.
CAMERA_MOTION_METADATA_TRACK Camera Motion Metadata Track'te (CAMM) GPS varsa, varsa önceliklidir.

PhotoView

Yanıta hangi Photo görünümünün dahil edileceğini belirtir.

Sıralamalar
BASIC Sunucu yanıtları, fotoğraf baytları için indirme URL'sini içermez. Varsayılan değer.
INCLUDE_DOWNLOAD_URL Sunucu yanıtları, fotoğraf baytları için indirme URL'sini içerir.

Yer

Bir varlığa ait meta verileri yerleştirin.

Alanlar
place_id

string

https://developers.google.com/places/place-id adresinde açıklandığı şekilde yer tanımlayıcısı.

name

string

Yalnızca çıkış. Yerin adı (language_code) yerelleştirilir.

language_code

string

Yalnızca çıkış. Adın yerelleştirildiği dil_kodudur. Bu, istekte belirtilen dil_kodu olmalıdır, ancak yedek olabilir.

Duruş

Bir varlık için ham poz ölçümü.

Alanlar
lat_lng_pair

LatLng

Pozun enlem ve boylam çifti (burada açıklandığı gibi): https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng Bir Photo oluştururken enlem ve boylam çifti sağlanmamışsa exif başlığındaki coğrafi konum kullanılır. Fotoğraf veya EXIF üstbilgisinde bir enlem ve boylam çiftinin sağlanmamış olması, fotoğraf işleminin başarısız olmasına neden olur.

altitude

double

Pozun WGS84 elipsoitin üzerinde metre cinsinden yüksekliği. NaN, ölçülmeyen bir miktarı ifade eder.

heading

double

Aşağıdaki poz parametreleri fotoğrafın merkeziyle ilgilidir. https://developers.google.com/streetview/spherical-metadata ile eşleşir. Pusula yönü, fotoğrafın ortasından saat yönünde kuzeye doğru ölçülen derece. Değer en az 0 ve en fazla 360 olmalıdır. NaN, ölçülmeyen bir miktarı ifade eder.

pitch

double

Derece, fotoğrafın ortasından derece cinsinden ölçülür. Değer >=-90 ve <= 90 olmalıdır. -90 değeri doğrudan aşağı bakma, 90 değeri ise doğrudan yukarı bakma anlamına gelir. NaN, ölçülmeyen bir miktarı ifade eder.

roll

double

Derece cinsinden ölçülen yuvarlanma. Değer en az 0 ve en fazla 360 olmalıdır. 0 değeri, ufukta seviye anlamına gelir. NaN, ölçülmeyen bir miktarı ifade eder.

gps_record_timestamp_unix_epoch

Timestamp

UTC döneminden itibaren GPS kaydının zamanı.

level

Level

Dikey gezinmeyi yapılandırmak için kullanılan kat (bir binanın katı).

accuracy_meters

float

Bu pozun% 68 güvenilirlikle metre cinsinden tahmini yatay doğruluğu (bir standart sapma). Örneğin, Android'de bu değer, şu yöntemle kullanılabilir: https://developer.android.com/reference/android/location/Location#getAccuracy(). Diğer platformlarda benzer doğruluk tahminlerini almak için farklı yöntemler mevcuttur.

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.

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:
insufficient_gps_details

InsufficientGpsFailureDetails

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

gps_data_gap_details

GpsDataGapFailureDetails

Bkz. GpsDataGapFailureDetails.

imu_data_gap_details

ImuDataGapFailureDetails

ImuDataGapFailureDetails konusuna bakın.

not_outdoors_details

NotOutdoorsFailureDetails

NotOutdoorsFailureDetails konusuna bakın.

no_overlap_gps_details

NoOverlapGpsFailureDetails

NoOverlapGpsFailureDetails konusuna 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.

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.

UpdatePhotoRequest

Photo öğesinin meta verilerini güncelleme isteği. Bir fotoğrafın piksellerinin güncellenmesi desteklenmiyor.

Alanlar
photo

Photo

Zorunlu. Yeni meta veriyi içeren Photo nesnesi.

update_mask

FieldMask

Zorunlu. Fotoğraf meta verilerinde güncellenecek alanları tanımlayan maske. Bu istekteki mevcut değilse eski Photo meta verileri, bu istekte tamamen yeni Photo meta verileriyle değiştirilir. Geçersiz alanlar belirtilirse güncelleme başarısız olur. Virgülle ayrılmış bir listede birden çok alan belirtilebilir.

Aşağıdaki alanlar geçerlidir:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

Not: updateMask yinelenen alanlar içerdiğinde, tekrarlanan değer grubunun tamamı yeni içeriklerle değiştirilir. Örneğin, updateMask içinde connections bulunuyorsa ve UpdatePhotoRequest.photo.connections boşsa tüm bağlantılar kaldırılır.

UploadRef

Medya dosyaları için referans yükleyin.

Alanlar
file_source alanı. Zorunlu. file_source şunlardan yalnızca biri olabilir:
upload_url

string

Yükleme referansı her kullanıcı için benzersiz olmalıdır. Şu forma göre belirlenir: "https://streetviewpublish.googleapis.com/media/user/{hesap_kimliği}/photo/{upload_reference}"