मान्य पता या वीडियो आईडी दिए जाने पर,
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 से मिला है."
बाद में इस्तेमाल करने के लिए वीडियो के आईडी सेव करें
यह एरियल व्यू एपीआई, एरियल व्यू एपीआई के लिए सेवा की खास शर्तों पर निर्भर करता है वीडियो आईडी को कैश मेमोरी में सेव करने की पाबंदियों से छूट मिली है. इसके बारे में यहां बताया गया है सेक्शन 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 बनाम DASH.
{
"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
शामिल है. आप बाद में, videoId
का इस्तेमाल कर सकते हैं
इससे वीडियो को पाने के लिए, lookupVideo
को पास करें.
नीचे दिया गया कोड उदाहरण दिखाता है कि lookupVideo
को कॉल कैसे करें और इसे किस तरह पास करें
videoId
.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideo?key=YOUR_API_KEY&videoId=VIDEO_ID "