REST Resource: photo

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

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

जेएसओएन के काेड में दिखाना
{
  "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)

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

RFC3339 यूटीसी का "Zulu" फ़ॉर्मैट में टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

uploadTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए है. इमेज अपलोड होने का समय.

RFC3339 यूटीसी का "Zulu" फ़ॉर्मैट में टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "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 में स्थिति, चाहे यह फ़ोटो प्रकाशित की गई हो या अस्वीकार की गई हो.

फ़ोटो आईडी

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

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

string

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

अपलोड का संदर्भ

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

जेएसओएन के काेड में दिखाना
{

  // 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}"

पोज़

इकाई के लिए अपरिष्कृत स्थिति माप.

जेएसओएन के काेड में दिखाना
{
  "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)

यूटीसी अवधि के बाद से जीपीएस रिकॉर्ड चलने का समय.

RFC3339 यूटीसी का "Zulu" फ़ॉर्मैट में टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "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(). दूसरे प्लैटफ़ॉर्म पर, सटीक अनुमान का पता लगाने के अलग-अलग तरीके होते हैं.

लैटलिंग

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

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

number

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

longitude

number

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

लेवल

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

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

number

ज़रूरी नहीं. ऑर्डर करने के लिए इस्तेमाल किया गया फ़्लोर नंबर. 0 ग्राउंड लेवल पर लेवल दिखाता है, 1 ग्राउंड लेवल से पहले लेवल का संकेत देता है, -1 ग्राउंड लेवल से पहला लेवल दिखाता है. गैर-पूर्णांक मान ठीक हैं.

name

string

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

कनेक्शन

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

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

object (PhotoId)

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

जगह

इकाई के लिए मेटाडेटा डालें.

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

string

https://developers.google.com/places/place-id में बताई गई जगह के आइडेंटिफ़ायर.

name

string

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

languageCode

string

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

ट्रांसफ़र का स्टेटस

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

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

Mapsपब्लिश स्थिति

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

Enums
UNSPECIFIED_MAPS_PUBLISH_STATUS फ़ोटो की स्थिति अज्ञात है.
PUBLISHED फ़ोटो को Google मैप के ज़रिए सार्वजनिक रूप से प्रकाशित किया जाता है.
REJECTED_UNKNOWN फ़ोटो को किसी अज्ञात कारण से नामंजूर कर दिया गया हो.

तरीके

create

जब क्लाइंट UploadRef और लौटाए गए व्यक्ति की फ़ोटो अपलोड कर देता है, तो CreatePhoto Google Maps पर अपलोड किया गया Photo, Street View पर पब्लिश कर देता है.

delete

Photo और उसका मेटाडेटा मिटाएं.

get

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

startUpload

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

update

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