REST Resource: photo

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

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

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 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
uploadTime

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
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

WGS84 दीर्घवृत्ताभ के ऊपर मीटर में पोज़ की ऊंचाई. 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)

UTC समय के बाद से GPS रिकॉर्ड का समय.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
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 का मेटाडेटा अपडेट करता है, जैसे कि पोज़, जगह की जानकारी, कनेक्शन वगैरह.