REST Resource: photo

संसाधन: फ़ोटो

इस कुकी का इस्तेमाल, फ़ोटो के मेटाडेटा के साथ-साथ 360 फ़ोटो को सेव करने के लिए किया जाता है.

JSON के काेड में दिखाना 
{
  "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)
}
फ़ील्ड
photoId

object (PhotoId)

ज़रूरी है. सिर्फ़ आउटपुट के लिए. किसी फ़ोटो को अपडेट करते समय इसकी ज़रूरत होती है. फ़ोटो बनाते समय ही आउटपुट दें. यह फ़ोटो का आइडेंटिफ़ायर होता है. यह Google पर मौजूद सभी फ़ोटो में यूनीक होता है.
uploadReference

object (UploadRef)

सिर्फ़ इनपुट के लिए. फ़ोटो बनाते समय यह ज़रूरी है. सिर्फ़ इनपुट के लिए. वह संसाधन यूआरएल जहां फ़ोटो बाइट अपलोड किए जाते हैं.
downloadUrl

string

सिर्फ़ आउटपुट के लिए. फ़ोटो बाइट डाउनलोड करने का यूआरएल. इस फ़ील्ड को सिर्फ़ तब सेट किया जाता है, जब GetPhotoRequest.view को PhotoView.INCLUDE_DOWNLOAD_URL पर सेट किया गया हो.
thumbnailUrl

string

सिर्फ़ आउटपुट के लिए. दी गई फ़ोटो की झलक दिखाने के लिए थंबनेल का यूआरएल.
pose

object (Pose)

ज़रूरी नहीं. फ़ोटो में पोज़.
connections[]

object (Connection)

ज़रूरी नहीं. अन्य फ़ोटो से कनेक्शन. कनेक्शन, इस फ़ोटो से किसी दूसरी फ़ोटो के लिंक को दिखाता है.
captureTime

string (Timestamp format)

ज़रूरी नहीं. फ़ोटो कैप्चर किए जाने का सटीक समय. जब फ़ोटो में कोई EXIF़ टाइमस्टैंप नहीं होता है, तब इसका इस्तेमाल फ़ोटो के मेटाडेटा में टाइमस्टैंप सेट करने के लिए किया जाता है.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
uploadTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब इमेज अपलोड की गई थी.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
places[]

object (Place)

ज़रूरी नहीं. वे जगहें जहां यह फ़ोटो ली गई थी.
viewCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. फ़ोटो को देखे जाने की संख्या.
transferStatus

enum (TransferStatus)

सिर्फ़ आउटपुट के लिए. इस फ़ोटो पर अधिकारों के ट्रांसफ़र की स्थिति.
mapsPublishStatus

enum (MapsPublishStatus)

सिर्फ़ आउटपुट के लिए. Google Maps में स्टेटस. इससे पता चलता है कि फ़ोटो पब्लिश की गई है या अस्वीकार कर दी गई है.

PhotoId

Photo के लिए आइडेंटिफ़ायर.

JSON के काेड में दिखाना 
{
  "id": string
}
फ़ील्ड
id

string

किसी फ़ोटो के लिए यूनीक आइडेंटिफ़ायर.

UploadRef

मीडिया फ़ाइलों के लिए रेफ़रंस अपलोड करें.

JSON के काेड में दिखाना 
{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}
फ़ील्ड
यूनियन फ़ील्ड file_source. ज़रूरी है. file_source इनमें से सिर्फ़ एक हो सकता है:
uploadUrl

string

हर उपयोगकर्ता के लिए, अपलोड किया गया रेफ़रंस यूनीक होना चाहिए. यह इस फ़ॉर्मैट में होता है: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

पोज़

किसी इकाई के लिए, पोज़ का मेज़रमेंट करने से जुड़ा रॉ डेटा.

JSON के काेड में दिखाना 
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
फ़ील्ड
latLngPair

object (LatLng)

पोज़ का अक्षांश और देशांतर पेयर, जैसा कि यहां बताया गया है: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng Photo बनाते समय, अगर अक्षांश और देशांतर पेयर नहीं दिया जाता है, तो exif हेडर से जियोलोकेशन का इस्तेमाल किया जाता है. फ़ोटो या EXIF हेडर में अक्षांश और देशांतर की जानकारी न होने की वजह से, फ़ोटो प्रोसेस नहीं हो पाती.
altitude

number

डब्ल्यूजीएस84 एलिप्सॉइड से मीटर में पोज़ की ऊंचाई. NaN का मतलब है कि मात्रा का मेज़रमेंट नहीं किया गया है.
heading

number

यहां दिए गए पोज़ पैरामीटर, फ़ोटो के बीच के हिस्से से जुड़े हैं. ये https://developers.google.com/streetview/spherical-metadata से मेल खाते हैं. कंपास की दिशा, जिसे फ़ोटो के बीच में मापा जाता है. यह उत्तर से घड़ी की दिशा में डिग्री में होती है. वैल्यू, 0 से 360 के बीच होनी चाहिए. NaN का मतलब है कि मात्रा का मेज़रमेंट नहीं किया गया है.
pitch

number

पिच, जिसे डिग्री में मापा जाता है. यह फ़ोटो के बीच में मापी जाती है. वैल्यू, -90 और 90 के बीच होनी चाहिए. -90 का मतलब है कि सीधे नीचे की ओर देखना और 90 का मतलब है कि सीधे ऊपर की ओर देखना. NaN का मतलब है कि मात्रा का मेज़रमेंट नहीं किया गया है.
roll

number

रोल, जिसे डिग्री में मापा जाता है. वैल्यू 0 से ज़्यादा या उसके बराबर और 360 से कम होनी चाहिए. वैल्यू 0 का मतलब है कि यह हॉरिज़ॉन के लेवल पर है. NaN का मतलब है कि मात्रा का मेज़रमेंट नहीं किया गया है.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

यूटीसी के हिसाब से, जीपीएस रिकॉर्ड का समय.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
level

object (Level)

लेवल (किसी इमारत में मौजूद फ़्लोर) का इस्तेमाल, वर्टिकल नेविगेशन को कॉन्फ़िगर करने के लिए किया जाता है.
accuracyMeters

number

इस पोज़ की अनुमानित हॉरिज़ॉन्टल ऐक्युरेसी, मीटर में. इसमें 68% कॉन्फ़िडेंस (एक स्टैंडर्ड डेविएशन) होता है. उदाहरण के लिए, Android पर यह वैल्यू इस तरीके से मिलती है: https://developer.android.com/reference/android/location/Location#getAccuracy(). अन्य प्लैटफ़ॉर्म पर, जगह की सटीक जानकारी के अनुमान पाने के अलग-अलग तरीके होते हैं.

LatLng

यह ऑब्जेक्ट, अक्षांश/देशांतर की जोड़ी को दिखाता है. इसे डबल के तौर पर दिखाया जाता है, ताकि अक्षांश और देशांतर की डिग्री को दिखाया जा सके. जब तक अलग से कोई जानकारी न दी जाए, तब तक इस ऑब्जेक्ट को WGS84 स्टैंडर्ड के मुताबिक होना चाहिए. वैल्यू, सामान्य की गई सीमाओं के अंदर होनी चाहिए.

JSON के काेड में दिखाना 
{
  "latitude": number,
  "longitude": number
}
फ़ील्ड
latitude

number

डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए.
longitude

number

डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए.

लेवल

लेवल की जानकारी, जिसमें लेवल नंबर और उसका नाम शामिल होता है.

JSON के काेड में दिखाना 
{
  "number": number,
  "name": string
}
फ़ील्ड
number

number

ज़रूरी नहीं. फ़्लोर नंबर, जिसका इस्तेमाल ऑर्डर करने के लिए किया जाता है. 0 का मतलब ज़मीन का लेवल, 1 का मतलब ज़मीन के लेवल से ऊपर का पहला लेवल, और -1 का मतलब ज़मीन के लेवल से नीचे का पहला लेवल होता है. नॉन-इंटिजर वैल्यू इस्तेमाल की जा सकती हैं.
name

string

ज़रूरी है. इस लेवल को असाइन किया गया नाम. इसमें ज़्यादा से ज़्यादा तीन वर्ण हो सकते हैं. अगर इस लेवल पर लिफ़्ट होती, तो लिफ़्ट के बटन को कैसे लेबल किया जाता.

कनेक्शन

कनेक्शन, सोर्स फ़ोटो से डेस्टिनेशन फ़ोटो तक का लिंक होता है.

JSON के काेड में दिखाना 
{
  "target": {
    object (PhotoId)
  }
}
फ़ील्ड
target

object (PhotoId)

ज़रूरी है. यह उस कनेक्शन का डेस्टिनेशन है जो फ़ोटो में मौजूद किसी व्यक्ति को दूसरी फ़ोटो में मौजूद किसी व्यक्ति से जोड़ता है.

जगह

किसी इकाई के लिए जगह का मेटाडेटा.

JSON के काेड में दिखाना 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
फ़ील्ड
placeId

string

जगह की पहचान करने वाला आईडी, जैसा कि https://developers.google.com/places/place-id में बताया गया है.
name

string

सिर्फ़ आउटपुट के लिए. जगह का नाम, जिसे languageCode के हिसाब से स्थानीय भाषा में लिखा गया हो.
languageCode

string

सिर्फ़ आउटपुट के लिए. वह languageCode जिसके हिसाब से नाम को स्थानीय भाषा में बदला गया है. यह अनुरोध में दिया गया languageCode होना चाहिए. हालांकि, यह फ़ॉलबैक भी हो सकता है.

TransferStatus

अधिकारों के ट्रांसफ़र की स्थिति.

Enums
TRANSFER_STATUS_UNKNOWN इस ट्रांसफ़र के स्टेटस के बारे में जानकारी नहीं है.
NEVER_TRANSFERRED इस फ़ोटो को कभी ट्रांसफ़र नहीं किया गया है.
PENDING फ़ोटो ट्रांसफ़र करने की प्रोसेस शुरू कर दी गई है, लेकिन पाने वाले व्यक्ति ने अब तक कोई जवाब नहीं दिया है.
COMPLETED फ़ोटो ट्रांसफ़र करने की प्रोसेस पूरी हो गई है. यह फ़ोटो, पाने वाले व्यक्ति को ट्रांसफ़र कर दी गई है.
REJECTED जिस व्यक्ति को फ़ोटो ट्रांसफ़र की जा रही है उसने फ़ोटो ट्रांसफ़र करने का अनुरोध अस्वीकार कर दिया है.
EXPIRED फ़ोटो ट्रांसफ़र करने का लिंक, फ़ोटो पाने वाले व्यक्ति के कोई कार्रवाई करने से पहले ही खत्म हो गया हो.
CANCELLED भेजने वाले व्यक्ति ने फ़ोटो ट्रांसफ़र करने का अनुरोध रद्द कर दिया है.
RECEIVED_VIA_TRANSFER अधिकारों के ट्रांसफ़र की वजह से, इस फ़ोटो का मालिकाना हक पाने वाले व्यक्ति के पास है.

MapsPublishStatus

Google Maps में फ़ोटो के पब्लिश होने की स्थिति.

Enums
UNSPECIFIED_MAPS_PUBLISH_STATUS फ़ोटो के स्टेटस के बारे में जानकारी नहीं है.
PUBLISHED फ़ोटो को Google Maps के ज़रिए सार्वजनिक तौर पर पब्लिश किया जाता है.
REJECTED_UNKNOWN इस फ़ोटो को किसी वजह से अस्वीकार कर दिया गया है.

तरीके

create

 क्लाइंट के UploadRef के साथ फ़ोटो अपलोड करने के बाद, CreatePhoto, अपलोड की गई Photo को Google Maps पर Street View में पब्लिश करता है.

delete

 इससे Photo और उसका मेटाडेटा मिट जाता है.

get

 बताए गए Photo का मेटाडेटा मिलता है.

startUpload

 यह कुकी, फ़ोटो बाइट अपलोड करना शुरू करने के लिए एक अपलोड सेशन बनाती है.

update

 यह Photo का मेटाडेटा अपडेट करता है. जैसे, पोज़, जगह से जुड़ाव, कनेक्शन वगैरह.