একটি ভিডিও আনুন

একটি বৈধ ঠিকানা বা ভিডিও আইডি দেওয়া হলে, lookupVideo পদ্ধতিটি এরিয়াল ভিউ এপিআই ভিডিওগুলির একটি সেট সনাক্তকারী ইউআরআই প্রদান করে। lookupVideo পদ্ধতিটি শুধুমাত্র তখনই ইউআরআই প্রদান করে যখন Google ইতিমধ্যেই সেই অবস্থানের জন্য একটি ভিডিও তৈরি করেছে৷

একটি ভিডিও বিদ্যমান কিনা তা পরীক্ষা করতে, lookupVideoMetadata পদ্ধতি ব্যবহার করুন।

কিভাবে API ব্যবহার করবেন

একটি ইউআরএল-এনকোডেড ইউএস পোস্টাল ঠিকানা বা একটি videoId পাস করে এই এন্ডপয়েন্টটিকে কল করুন।

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

API তারপর নিম্নলিখিত তিনটি প্রতিক্রিয়াগুলির মধ্যে একটি প্রদান করে:

  • যদি একটি ভিডিও বিদ্যমান থাকে, তাহলে lookupVideo ACTIVE এর একটি প্রক্রিয়াকরণ অবস্থা এবং প্রতিটি সমর্থিত মিডিয়া প্রকারের জন্য একটি ল্যান্ডস্কেপ এবং একটি পোর্ট্রেট URI এবং মেটাডেটা প্রদান করে।

  • যদি ভিডিওটি আমাদের সিস্টেমে থাকে, কিন্তু এটি এখনও সম্পূর্ণরূপে রেন্ডার করা না হয়, lookupVideo PROCESSING -এর একটি প্রসেসিং অবস্থা এবং একটি videoId প্রদান করে, যা আপনি ভিডিওটি রেন্ডারিং সম্পন্ন করার পরে পেতে ব্যবহার করতে পারেন৷

  • যদি ভিডিওটি এখনও বিদ্যমান না থাকে, তাহলে API একটি 404 স্ট্যাটাস কোড প্রদান করে। এই ক্ষেত্রে, আপনি renderVideo কল করে একটি নতুন ভিডিও তৈরি করতে পারেন।

ফিরে আসা ভিডিও ইউআরআইগুলি কীভাবে ব্যবহার করবেন

ঠিকানা প্রতি একবার অথবা ভিউ প্রতি videoID প্রতি একবার lookupVideo পদ্ধতিতে কল করুন। প্রতিক্রিয়াতে ভিডিও ইউআরআইগুলিকে স্বল্পকালীন ইউআরআই হিসাবে উল্লেখ করা হয় এবং অল্প সময়ের পরে মেয়াদ শেষ হয়ে যায়।

গুগল প্রায়ই ভিডিও আপডেট করে। অতএব, আপনি আপনার গ্রাহকদের কাছে সাম্প্রতিক বিষয়বস্তু প্রদর্শন করছেন তা নিশ্চিত করতে, প্রতিবার ভিডিও প্রদর্শন করার সময় lookupVideo পদ্ধতিতে কল করুন।

অ্যাক্সেসযোগ্য ভিডিও সমর্থন করে

অ্যাক্সেসযোগ্যতা সমর্থন করার জন্য, Google সুপারিশ করে যে আপনি যখন আপনার গ্রাহকদের কাছে একটি বায়বীয় দৃশ্য ভিডিও প্রদর্শন করেন তখন আপনি একটি প্রতিলিপি বা ভিডিও বিবরণ যোগ করুন। এইভাবে, একজন স্ক্রিন রিডার ব্যবহারকারীকে প্রতিলিপি বা তার বিবরণ ঘোষণা করতে পারে।

উদাহরণস্বরূপ, ফর্মে একটি বিবরণ যোগ করুন:

"এটি Google মানচিত্র দ্বারা প্রদত্ত ADDRESS- এর একটি ফটোরিয়েলিস্টিক বায়বীয় দৃশ্য।"

ঠিকানার পরিবর্তে, আপনি ফর্মটিতে ভিডিওটির একটি বিবরণ যোগ করতে পারেন:

"এটি নিউ ইয়র্কের এম্পায়ার স্টেট বিল্ডিংয়ের একটি আলোকবাস্তব বায়বীয় দৃশ্য যা Google মানচিত্র দ্বারা সরবরাহ করা হয়েছে।"

পরবর্তী ব্যবহারের জন্য ভিডিও আইডি সংরক্ষণ করুন

এরিয়াল ভিউ API-এর জন্য পরিষেবার নির্দিষ্ট শর্তাবলী সাপেক্ষে, এরিয়াল ভিউ API ভিডিও আইডিগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার শর্তাবলীর ধারা 3.2.3(b)(কোন ক্যাশিং নেই) এ বর্ণিত ক্যাশিং বিধিনিষেধ থেকে অব্যাহতিপ্রাপ্ত ৷ আপনি তাই পরবর্তী ব্যবহারের জন্য ভিডিও আইডি মান সংরক্ষণ করতে পারেন।

একটি ঠিকানা পাস উদাহরণ অনুরোধ

নিম্নলিখিত কোড নমুনা 600 Montgomery St, San Francisco, CA 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 অনুরোধের সমস্ত সম্ভাব্য প্রতিক্রিয়া উপস্থাপন করে।

ভিডিও পাওয়া গেছে

আপনি যে ভিডিওটির অনুরোধ করছেন সেটি যদি বিদ্যমান থাকে, তাহলে API ইউআরআই-এর একটি তালিকা প্রদান করে, যার প্রত্যেকটি অনুরোধ করা ভিডিওটির ভিন্ন ফর্ম্যাট বা সংস্করণের সাথে লিঙ্ক করে। বিভিন্ন ফরম্যাট সম্পর্কে জানতে, দেখুন MPEG-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"
  }
}

রেন্ডারিং চলছে

সিস্টেমটি এখনও আপনার রেন্ডার অনুরোধ প্রক্রিয়া করছে, যেমনটি PROCESSING সেট করা state দ্বারা সংজ্ঞায়িত করা হয়েছে। আপনি একটি 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"