REST Resource: photo

Kaynak: Fotoğraf

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

JSON gösterimi 
{
  "photoId": {
    object (PhotoId)
  },
  "uploadReference": {
    object (UploadRef)
  },
  "downloadUrl": string,
  "thumbnailUrl": string,
  "shareLink": string,
  "pose": {
    object (Pose)
  },
  "connections": [
    {
      object (Connection)
    }
  ],
  "captureTime": string,
  "uploadTime": string,
  "places": [
    {
      object (Place)
    }
  ],
  "viewCount": string,
  "transferStatus": enum (TransferStatus),
  "mapsPublishStatus": enum (MapsPublishStatus)
}
Alanlar
photoId

object (PhotoId)

Zorunlu. Yalnızca çıkış. Fotoğraf güncellenirken gereklidir. Yalnızca fotoğraf oluştururken çıkış. Fotoğrafın tanımlayıcısıdır ve Google'daki tüm fotoğraflar arasında benzersizdir.
uploadReference

object (UploadRef)

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

string

Yalnızca çıkış. Fotoğraf baytlarının indirme URL'si. Bu alan yalnızca GetPhotoRequest.view, PhotoView.INCLUDE_DOWNLOAD_URL olarak ayarlandığında belirlenir.
thumbnailUrl

string

Yalnızca çıkış. Belirli bir fotoğrafın önizlemesini göstermek için kullanılan küçük resim URL'si.
pose

object (Pose)

İsteğe bağlıdır. Fotoğrafın pozu.
connections[]

object (Connection)

İsteğe bağlıdır. Diğer fotoğraflarla bağlantılar. Bağlantı, bu fotoğraftan başka bir fotoğrafa giden bağlantıyı gösterir.
captureTime

string (Timestamp format)

İsteğe bağlıdır. Fotoğrafın çekildiği mutlak zaman. Fotoğrafta EXIF zaman damgası yoksa fotoğraf meta verilerinde zaman damgası ayarlamak için bu kullanılır.

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ış. Resmin yüklendiği 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".
places[]

object (Place)

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

string (int64 format)

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

enum (TransferStatus)

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

enum (MapsPublishStatus)

Yalnızca çıkış. Google Haritalar'daki durumu (bu fotoğrafın yayınlanıp yayınlanmadığı veya reddedilip edilmediği).

PhotoId

Photo için tanımlayıcı.

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

string

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

UploadRef

Medya dosyaları için referans yükleyin.

JSON gösterimi 
{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}
Alanlar
file_source birleşik alanı. Zorunlu. file_source aşağıdakilerden yalnızca biri olabilir:
uploadUrl

string

Yükleme referansı her kullanıcı için benzersiz olmalıdır. "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}" biçimindedir.

Poz

Bir öğenin ham poz ölçümü.

JSON gösterimi 
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
Alanlar
latLngPair

object (LatLng)

Pozun enlem ve boylam çifti. https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng adresinde açıklandığı gibidir. Photo oluştururken enlem ve boylam çifti sağlanmazsa exif üstbilgisindeki coğrafi konum kullanılır. Fotoğraf veya EXIF başlığında enlem ve boylam çifti sağlanmadığında fotoğraf işleme başarısız olur.
altitude

number

Pozun WGS84 elipsoidinin üzerindeki yüksekliği (metre cinsinden). NaN, ölçülmemiş bir miktarı gösterir.
heading

number

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ında kuzeyden saat yönünde derece cinsinden ölçülür. Değer >=0 ve <360 olmalıdır. NaN, ölçülmemiş bir miktarı gösterir.
pitch

number

Eğim, fotoğrafın merkezinde derece cinsinden ölçülür. Değer, -90 ile 90 arasında olmalıdır. -90 değeri doğrudan aşağıya bakıldığı, 90 değeri ise doğrudan yukarıya bakıldığı anlamına gelir. NaN, ölçülmemiş bir miktarı gösterir.
roll

number

Yuvarlanma (derece cinsinden ölçülür). Değer >= 0 ve <360 olmalıdır. 0 değeri, ufuk çizgisiyle aynı seviyede olduğu anlamına gelir. NaN, ölçülmemiş bir miktarı gösterir.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

UTC döneminden beri GPS kaydı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".
level

object (Level)

Dikey gezinmeyi yapılandırmak için kullanılan düzey (binadaki kat).
accuracyMeters

number

Bu pozun metre cinsinden tahmini yatay doğruluğu (68% güvenle, 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 tahminleri elde etmek için farklı yöntemler kullanılır.

LatLng

Bir enlem/boylam çiftini temsil eden nesne. Bu, enlem derecelerini ve boylam derecelerini temsil etmek için çift sayı olarak ifade edilir. Aksi belirtilmediği sürece bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Enlem (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır.
longitude

number

Boylam (derece cinsinden). [-180.0, +180.0] aralığında olmalıdır.

Seviye

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

JSON gösterimi 
{
  "number": number,
  "name": string
}
Alanlar
number

number

İsteğe bağlıdır. Sipariş için kullanılan kat numarası. 0, zemin seviyesini; 1, zemin seviyesinin üzerindeki ilk katı; -1 ise zemin seviyesinin altındaki ilk katı gösterir. Tam sayı olmayan değerler kullanılabilir.
name

string

Zorunlu. Bu düzeye atanan ve 3 karakterle sınırlı bir ad. Asansör olsaydı bu katta asansör düğmelerinin nasıl etiketleneceğini düşünün.

Bağlantı

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

JSON gösterimi 
{
  "target": {
    object (PhotoId)
  }
}
Alanlar
target

object (PhotoId)

Zorunlu. Kapsayan fotoğraftan başka bir fotoğrafa bağlantının hedefi.

Yer

Bir öğenin yer meta verileri.

JSON gösterimi 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
Alanlar
placeId

string

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

string

Yalnızca çıkış. Yerin languageCode diline yerelleştirilmiş adı.
languageCode

string

Yalnızca çıkış. Adın yerelleştirildiği languageCode. Bu, istekte belirtilen languageCode olmalıdır ancak yedek bir dil kodu da olabilir.

TransferStatus

Hak aktarımının durumu.

Sıralamalar
TRANSFER_STATUS_UNKNOWN Bu transferin durumu belirtilmemiş.
NEVER_TRANSFERRED Bu fotoğraf daha önce hiç aktarılmadı.
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 Fotoğraf aktarımı, alıcı herhangi bir işlem yapmadan önce sona erdi.
CANCELLED Gönderen, bu fotoğraf aktarımını iptal etti.
RECEIVED_VIA_TRANSFER Alıcı, hak aktarımı nedeniyle bu fotoğrafın sahibidir.

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 üzerinden herkese açık olarak yayınlanır.
REJECTED_UNKNOWN Fotoğraf bilinmeyen bir nedenle reddedildi.

Yöntemler

create

 İstemci, döndürülen UploadRef ile fotoğrafı yüklemeyi bitirdikten sonra CreatePhoto, yüklenen Photo öğesini Google Haritalar'daki Street View'da yayınlar.

delete

 Photo ve meta verilerini siler.

get

 Belirtilen Photo meta verilerini alır.

startUpload

 Fotoğraf baytlarını yüklemeye başlamak için bir yükleme oturumu oluşturur.

update

 Bir Photo öğesinin meta verilerini (ör. poz, yer ilişkilendirmesi, bağlantılar vb.) günceller.