इस पेज का अनुवाद Cloud Translation API से किया गया है.

वीडियो फ़ेच करें

मान्य पता या वीडियो आईडी दिए जाने पर, lookupVideo तरीका, एरियल व्यू एपीआई वीडियो के सेट की पहचान करने वाले यूआरआई दिखाता है. lookupVideo वाला तरीका, यूआरआई को सिर्फ़ तब दिखाता है, जब Google उस जगह के लिए पहले ही वीडियो जनरेट कर चुका हो.

यह देखने के लिए कि वीडियो मौजूद है या नहीं, lookupVideoMetadata तरीके का इस्तेमाल करें.

एपीआई का इस्तेमाल कैसे करें

इस एंडपॉइंट को कॉल करने के लिए, इसे यूआरएल के लिए कोड में बदला गया अमेरिका का डाक पता या videoId दें.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideo?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

इसके बाद, एपीआई इन तीन में से कोई एक रिस्पॉन्स दिखाता है:

अगर कोई वीडियो मौजूद है, तो lookupVideo उसके प्रोसेस होने की स्थिति ACTIVE दिखाता है. साथ ही, इस्तेमाल किए जा सकने वाले हर तरह के मीडिया के लिए, लैंडस्केप और पोर्ट्रेट यूआरआई और मेटाडेटा दिखाता है.

ध्यान दें: इस एंडपॉइंट पर आने वाले कॉल का बिल सिर्फ़ तब भेजा जाता है, जब कोई वीडियो मौजूद हो और वीडियो यूआरआई लौटाया जाता हो.
अगर वीडियो हमारे सिस्टम में है, लेकिन वह अब भी पूरी तरह से रेंडर नहीं हुआ है, तो lookupVideo, PROCESSING की प्रोसेसिंग स्थिति दिखाता है. साथ ही, videoId दिखाता है. इसका इस्तेमाल, रेंडर होने के बाद वीडियो को पाने के लिए किया जा सकता है.
अगर वीडियो अब तक मौजूद नहीं है, तो एपीआई 404 स्टेटस कोड दिखाता है. ऐसे मामले में, renderVideo पर कॉल करके नया वीडियो जनरेट किया जा सकता है.

दिखाए गए वीडियो यूआरआई का इस्तेमाल कैसे करें

lookupVideo तरीके को हर पते के लिए एक बार या हर व्यू के लिए videoID कॉल करें. रिस्पॉन्स में दिए गए वीडियो यूआरआई को कुछ समय तक रहने वाले यूआरआई के तौर पर जाना जाता है और कुछ समय बाद इनकी समयसीमा खत्म हो जाती है.

Google अक्सर वीडियो अपडेट करता है. इसलिए, हर बार वीडियो दिखाते समय lookupVideo तरीके को कॉल करें, ताकि यह पक्का किया जा सके कि ग्राहकों को नया कॉन्टेंट दिखाया जा रहा है.

सुलभ वीडियो की सहायता करना

सुलभता की सुविधा के लिए, Google यह सुझाव देता है कि आप अपने ग्राहकों को एरियल व्यू वाला वीडियो दिखाते समय, ट्रांसक्रिप्ट या वीडियो का ब्यौरा जोड़ें. ऐसे में, स्क्रीन रीडर किसी उपयोगकर्ता को ट्रांसक्रिप्ट या उसके ब्यौरे के बारे में बता सकता है.

उदाहरण के लिए, फ़ॉर्म में कोई जानकारी जोड़ें:

"यह ADDRESS का एक फ़ोटोरियलिस्टिक एरियल व्यू है, जिसे Google Maps ने उपलब्ध कराया है."

पते के बजाय, वीडियो के बारे में जानकारी देने के लिए, इस फ़ॉर्म का इस्तेमाल करें:

"यह न्यूयॉर्क की एंपायर स्टेट बिल्डिंग का एरियल व्यू है, जिसे Google Maps ने दिखाया है."

बाद में इस्तेमाल के लिए वीडियो आईडी सेव करें

एरियल व्यू एपीआई के लिए सेवा की खास शर्तों के हिसाब से, एरियल व्यू एपीआई वीडियो आईडी को कैश मेमोरी में सेव करने से जुड़ी उन पाबंदियों से छूट देता है जो Google Maps Platform की सेवा की शर्तों के सेक्शन 3.2.3(b)(कैश मेमोरी में नहीं सेव करना) में बताई गई हैं. इसलिए, वीडियो आईडी की वैल्यू को सेव किया जा सकता है, ताकि बाद में उनका इस्तेमाल किया जा सके.

पता पास करने के अनुरोध का उदाहरण

नीचे दिया गया कोड सैंपल, ट्रांसअमेरिका के लिए एरियल व्यू वीडियो का अनुरोध करता है. यह पिरामिड, 600 मॉन्टगमरी स्ट्रीट, सैन फ़्रांसिस्को, सीए 94111 पर स्थित है.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideo?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"

रिस्पॉन्स का उदाहरण

JSON के ये उदाहरण, lookupVideo अनुरोध के सभी संभावित रिस्पॉन्स दिखाते हैं.

वीडियो मिला

अगर आपने जिस वीडियो का अनुरोध किया है वह मौजूद है, तो एपीआई यूआरआई की सूची दिखाता है. हर यूआरआई एक अलग फ़ॉर्मैट में या अनुरोध किए गए वीडियो के वर्शन से जुड़ा होता है. विभिन्न फ़ॉर्मैट के बारे में जानने के लिए, देखें MPEG-DASH क्या है? | HLS बनाम डैशबोर्ड.

{
  "uris": {
    "IMAGE": {
      "landscapeUri": "https://www.gstatic.com/aerialview/thumbnail/-1202461100507922431.jpg?sqp=CKiU6qIGGPQD&rs=AHRQkOe1j6EA5Q3WzJgDluv8AXbNlZ8M-g",
      "portraitUri": "https://www.gstatic.com/aerialview/thumbnail/2256303413312618497.jpg?sqp=CKiU6qIGGPQD&rs=AHRQkOelSBTTVgOmFrSZ71c1xjyuoSBAAA"
    },
    "MP4_HIGH": {
      "landscapeUri": "https://rr1---sn-p5qs7nzy.googlevideo.com/videoplayback?expire=1683655708&ei=KIpaZKvJBpnc-LYP8v6T-AM&ip=0.0.0.0&id=5f50000000000001&itag=375&source=aerial_view&mh=dX&mm=31&mn=sn-p5qs7nzy&ms=au&mv=D&mvi=1&pl=0&susc=av&mime=video/mp4&vprv=1&gir=yes&clen=37357139&dur=40.016&lmt=1683384545351664&mt=1683654760&txp=0011224&sparams=expire,ei,ip,id,itag,source,susc,mime,vprv,gir,clen,dur,lmt&sig=AOq0QJ8wRgIhAOhUzpUZGXThRz481S5YAVoy7d7V29-8GDRWLdDEtzagAiEA5laBMqKNnoPCeTHFVT56FYQ5MZp7pZTtDNp9tSJffyc=&lsparams=mh,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRQIgVqK6hzOoDaTnWt4UmIQgXOyGCc5Pxf4tmp2t6YzwkrQCIQCCOsPpfT2g_BT32Ki_iMwwBb2IhoquVISoHbBMI5_dAw==",
      "portraitUri": "https://rr5---sn-p5qlsn7s.googlevideo.com/videoplayback?expire=1683655708&ei=KIpaZJiuBo3g-LYPhtaG6AU&ip=0.0.0.0&id=9f50000000000001&itag=375&source=aerial_view&mh=D3&mm=31&mn=sn-p5qlsn7s&ms=au&mv=D&mvi=5&pl=0&susc=av&mime=video/mp4&vprv=1&gir=yes&clen=11844099&dur=40.016&lmt=1683384626250758&mt=1683654760&txp=0011224&sparams=expire,ei,ip,id,itag,source,susc,mime,vprv,gir,clen,dur,lmt&sig=AOq0QJ8wRgIhAPP030ASCfKrXHpu72d78SBN_3T-7jKQ5_OjAvVzvYLaAiEAhEDAo689v0DWSCkfxxD8oU2iJVifC25Q7gQplx5_25U=&lsparams=mh,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRQIgREl7bSQ_z9Y86A_bRnX1RdQqoIbwgjV2rEkhLlNilBICIQC9amH8IwmRdbbcCUxnSttBjcy_4BwiBBbSd_PM1KgICw=="
    },
    "MP4_LOW": {
      "landscapeUri": "https://rr1---sn-p5qs7nzy.googlevideo.com/videoplayback?expire=1683655708&ei=KIpaZKvJBpnc-LYP8v6T-AM&ip=0.0.0.0&id=5f50000000000001&itag=134&source=aerial_view&mh=dX&mm=31&mn=sn-p5qs7nzy&ms=au&mv=D&mvi=1&pl=0&susc=av&mime=video/mp4&vprv=1&gir=yes&clen=3152145&dur=39.999&lmt=1683384843730359&mt=1683654760&txp=0011224&sparams=expire,ei,ip,id,itag,source,susc,mime,vprv,gir,clen,dur,lmt&sig=AOq0QJ8wRAIgVDf8P_aMLthAC6ASciANODNo7p7IqofngIgCUnfUofYCICV7JexvuPTnaqOfShKIL33uhtzIfnfOj2LgfpY0zKdx&lsparams=mh,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRQIhAM2jKSXegkPbIFD4L7H6FeBz5ytYtMkXNfowGlAB9aL2AiA3DQJIeoTfs3EOIPMfDBCGm7v_vWTruRBjXLN4lRIa-Q==",
      "portraitUri": "https://rr5---sn-p5qlsn7s.googlevideo.com/videoplayback?expire=1683655708&ei=KIpaZJiuBo3g-LYPhtaG6AU&ip=0.0.0.0&id=9f50000000000001&itag=134&source=aerial_view&mh=D3&mm=31&mn=sn-p5qlsn7s&ms=au&mv=D&mvi=5&pl=0&susc=av&mime=video/mp4&vprv=1&gir=yes&clen=1002125&dur=39.999&lmt=1683384248881200&mt=1683654760&txp=0011224&sparams=expire,ei,ip,id,itag,source,susc,mime,vprv,gir,clen,dur,lmt&sig=AOq0QJ8wRAIgYRyzRjtsGYFcodlU4-SvJ9GRgx97MF1nFlhoY74YtN4CIF5GuHAEnKqPoZBt5qYO2jur46q1OMEjvjtYATwNHMtD&lsparams=mh,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRgIhAPoXkJ5-MQTNCy19W1zJu8Hi8eo-eYw-5kH-AbFpAsuTAiEAi2EmxfUwfYtPlTQe0jWFVxc7yKMMz0Bqidcf2ZRvYU4="
    },
    "MP4_MEDIUM": {
      "landscapeUri": "https://rr1---sn-p5qs7nzy.googlevideo.com/videoplayback?expire=1683655708&ei=KIpaZKvJBpnc-LYP8v6T-AM&ip=0.0.0.0&id=5f50000000000001&itag=374&source=aerial_view&mh=dX&mm=31&mn=sn-p5qs7nzy&ms=au&mv=D&mvi=1&pl=0&susc=av&mime=video/mp4&vprv=1&gir=yes&clen=25879743&dur=40.016&lmt=1683384621721411&mt=1683654760&txp=0011224&sparams=expire,ei,ip,id,itag,source,susc,mime,vprv,gir,clen,dur,lmt&sig=AOq0QJ8wRQIhANzPUc2SwvlDZ-nyhxNfY8CGVjyitnfpS7MvbXb_f5kSAiAVArz85QjBBAZw-8ugFPIggKCO54IhR6xDg4rfJIh1Tw==&lsparams=mh,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRQIgJJyNxWDuqLZ89X5wThN1IsVJyvyZ7Qw1Z4jqhCyahjgCIQD9hOjN3hDvX3CN5LiNkoLm-GGAuriUtv0PhtREc7yTVQ==",
      "portraitUri": "https://rr5---sn-p5qlsn7s.googlevideo.com/videoplayback?expire=1683655708&ei=KIpaZJiuBo3g-LYPhtaG6AU&ip=0.0.0.0&id=9f50000000000001&itag=374&source=aerial_view&mh=D3&mm=31&mn=sn-p5qlsn7s&ms=au&mv=D&mvi=5&pl=0&susc=av&mime=video/mp4&vprv=1&gir=yes&clen=8228161&dur=40.016&lmt=1683384373331986&mt=1683654760&txp=0011224&sparams=expire,ei,ip,id,itag,source,susc,mime,vprv,gir,clen,dur,lmt&sig=AOq0QJ8wRQIgKsfEQB3GbLqYP5tmHwmkMVqVlfcNl7SBiuBqRw748VsCIQDgkwyNF4jOuOjoX5Qw6TgbpdIPhqS-EvCZ2g2JWPYpbw==&lsparams=mh,mm,mn,ms,mv,mvi,pl&lsig=AG3C_xAwRQIgHdDEnopIcI2jzLkRLOaKz8Cq1Pwm2yl3nJzaru1dBEsCIQCgor9bkMfAeULTq3EwjzCGjB_RvGBqhGfhJblbBloJpg=="
    },
    "HLS": {
      "landscapeUri": "https://manifest.googlevideo.com/api/manifest/hls_variant/expire/1682711042/ei/DSBMZM7qPPPh-LYP9ZWNmA8/ip/0.0.0.0/id/7fffffffffffffff/source/aerial_view/susc/av/playback_host/rr3---sn-aigzrnsz.googlevideo.com/mh/ap/mm/31/mn/sn-aigzrnsz/ms/au/mv/D/mvi/3/pl/0/vprv/1/pacing/0/mt/1682709203/itag/0/playlist_type/LIVE/sparams/expire,ei,ip,id,source,susc,vprv,itag,playlist_type/sig/AOq0QJ8wRgIhAKreaNNOkePt9uVonHcqKIXqUe0TQSA1fcI6BWJexJ2hAiEAv9cj6N9iXI0bH6Ke4fz4XWDtrxVCMgrkGijpsLMpvy8%3D/lsparams/playback_host,mh,mm,mn,ms,mv,mvi,pl/lsig/AG3C_xAwRgIhAMbA_78Uc_HUS8LaVWnJB4Qg7ZKO5IZECuhldckmJ3hPAiEA-GR-0w1zuyFHpvaF1LZBuWgpUM55iosY0KF9MMsePDE%3D/file/index.m3u8",
      "portraitUri": "https://manifest.googlevideo.com/api/manifest/hls_variant/expire/1682711042/ei/DSBMZM7qPPPh-LYP9ZWNmA8/ip/0.0.0.0/id/7fffffffffffffff/source/aerial_view/susc/av/playback_host/rr3---sn-aigzrnsz.googlevideo.com/mh/ap/mm/31/mn/sn-aigzrnsz/ms/au/mv/D/mvi/3/pl/0/vprv/1/pacing/0/mt/1682709203/itag/0/playlist_type/LIVE/sparams/expire,ei,ip,id,source,susc,vprv,itag,playlist_type/sig/AOq0QJ8wRgIhAKreaNNOkePt9uVonHcqKIXqUe0TQSA1fcI6BWJexJ2hAiEAv9cj6N9iXI0bH6Ke4fz4XWDtrxVCMgrkGijpsLMpvy8%3D/lsparams/playback_host,mh,mm,mn,ms,mv,mvi,pl/lsig/AG3C_xAwRgIhAMbA_78Uc_HUS8LaVWnJB4Qg7ZKO5IZECuhldckmJ3hPAiEA-GR-0w1zuyFHpvaF1LZBuWgpUM55iosY0KF9MMsePDE%3D/file/index.m3u8"
    },
    "DASH": {
      "landscapeUri": "https://manifest.googlevideo.com/api/manifest/dash/expire/1682711042/ei/DSBMZM7qPPPh-LYP9ZWNmA8/ip/0.0.0.0/id/7fffffffffffffff/source/aerial_view/susc/av/playback_host/rr3---sn-aigzrnsz.googlevideo.com/mh/ap/mm/31/mn/sn-aigzrnsz/ms/au/mv/D/mvi/3/pl/0/vprv/1/pacing/0/mt/1682709203/itag/0/sparams/expire,ei,ip,id,source,susc,vprv,itag/sig/AOq0QJ8wRAIgCClKKnnVXeNnUHirpyxkegs8XSw5bq5e2VHWu-2NGtkCIBvXoHxlfTVmIvB4F9mlxn9EnJxPrcPGo1yIrS-_zbBu/lsparams/playback_host,mh,mm,mn,ms,mv,mvi,pl/lsig/AG3C_xAwRQIhAIU_a8wIuPfzMXy1selgJ1bRz1ffXm0YQeFshe0ijAzhAiAPzhkpOjm-IGubZ-Z7o3W_U7lAjR6OkEpWvNEFCRzUVg%3D%3D",
      "portraitUri": "https://manifest.googlevideo.com/api/manifest/dash/expire/1682711042/ei/DSBMZM7qPPPh-LYP9ZWNmA8/ip/0.0.0.0/id/7fffffffffffffff/source/aerial_view/susc/av/playback_host/rr3---sn-aigzrnsz.googlevideo.com/mh/ap/mm/31/mn/sn-aigzrnsz/ms/au/mv/D/mvi/3/pl/0/vprv/1/pacing/0/mt/1682709203/itag/0/sparams/expire,ei,ip,id,source,susc,vprv,itag/sig/AOq0QJ8wRAIgCClKKnnVXeNnUHirpyxkegs8XSw5bq5e2VHWu-2NGtkCIBvXoHxlfTVmIvB4F9mlxn9EnJxPrcPGo1yIrS-_zbBu/lsparams/playback_host,mh,mm,mn,ms,mv,mvi,pl/lsig/AG3C_xAwRQIhAIU_a8wIuPfzMXy1selgJ1bRz1ffXm0YQeFshe0ijAzhAiAPzhkpOjm-IGubZ-Z7o3W_U7lAjR6OkEpWvNEFCRzUVg%3D%3D"
    }
  },
  "state": "ACTIVE",
  "metadata": {
    "videoId": "-wVXGP6Hkogfqz6sZulUf3",
    "captureDate": {
      "year": 2022,
      "month": 10,
      "day": 24
    },
    "duration": "40s"
  }
}

वीडियो ऐक्सेस करने के लिए, आपको इन डोमेन को अनुमति वाली सूची में शामिल करना होगा:

*.gstatic.com
*.googlevideo.com

वीडियो नहीं मिला

"वीडियो नहीं मिला" के दो संभावित जवाब हो सकते हैं. यह इस बात पर निर्भर करता है कि किसी जगह के लिए 3D तस्वीरें उपलब्ध हैं या नहीं.

रेंडर नहीं किया गया

वीडियो पहले से रेंडर नहीं हुआ है. इसलिए, यह अब तक Google के डेटाबेस में मौजूद नहीं है.

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}

3D तस्वीरों का कोई संग्रह नहीं है

Google ने पहले ही वीडियो रेंडर करने की कोशिश की, लेकिन वह नाकाम रहा, क्योंकि उस पते के लिए 3D तस्वीरें उपलब्ध नहीं हैं.

{
  "error": {
    "code": 404,
    "message": "Video not found: No 3d imagery.",
    "status": "NOT_FOUND"
  }
}

रेंडरिंग जारी है

सिस्टम अब भी आपके रेंडर करने के अनुरोध को प्रोसेस कर रहा है, जैसा कि state को PROCESSING पर सेट किया गया है. आपको एक videoId मिलता है, जिसका इस्तेमाल आप lookupVideo पर कॉल करके वीडियो पाने के लिए कर सकते हैं.

{
  "state": "PROCESSING",
  "metadata": {
    "videoId": "u-zlVPiScvcD8BYmIVyxoF"
  }
}

रेंडरिंग की प्रक्रिया में एक घंटे से लेकर कुछ घंटे तक लग सकते हैं. अगर वीडियो अब भी प्रोसेस हो रहा है, तो lookupVideo का इस्तेमाल करके वीडियो की स्थिति की जानकारी तब तक पोल के लिए इस्तेमाल किया जा सकता है, जब तक कि वीडियो ACTIVE की स्थिति न दिखाए.

पोल करने के लिए, videoId पास करके lookupVideo को अनुरोध करें. रेंडरिंग में कई घंटे लग सकते हैं, इसलिए अपने कॉल के लिए एक्सपोनेन्शियल बैकऑफ़ का इस्तेमाल करें.

`videoId` पास करने के अनुरोध का उदाहरण

अगर lookupVideo पर कॉल किया जाता है और आपको पता चलता है कि पते के लिए कोई एरियल व्यू वीडियो नहीं है, तो उस पते से renderVideo को कॉल किया जा सकता है. renderVideo एक VideoMetadata ऑब्जेक्ट दिखाता है, जिसमें videoId शामिल होता है. बाद में, वीडियो lookupVideo को भेजकर वीडियो पाने के लिए पते की जगह videoId का इस्तेमाल किया जा सकता है.

नीचे दिए गए कोड के उदाहरण में बताया गया है कि lookupVideo को कॉल कैसे किया जाए और इसे videoId पास किया जाए.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideo?key=YOUR_API_KEY&videoId=VIDEO_ID"