এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

একটি বৈধ ঠিকানা বা ভিডিও আইডি দেওয়া হলে, lookupVideo পদ্ধতিটি Aerial View API ভিডিওর একটি সেট সনাক্তকারী URI গুলি প্রদান করে। lookupVideo পদ্ধতিটি কেবলমাত্র তখনই URI গুলি প্রদান করে যখন Google ইতিমধ্যেই সেই অবস্থানের জন্য একটি ভিডিও তৈরি করে।

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

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

এই এন্ডপয়েন্টে একটি URL-এনকোডেড মার্কিন ডাক ঠিকানা অথবা একটি videoId লিখে কল করুন।

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

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

যদি কোনও ভিডিও বিদ্যমান থাকে, তাহলে lookupVideo ACTIVE এর একটি প্রক্রিয়াকরণ অবস্থা, এবং প্রতিটি সমর্থিত মিডিয়া ধরণের জন্য একটি ল্যান্ডস্কেপ এবং একটি পোর্ট্রেট URI এবং মেটাডেটা প্রদান করে।
দ্রষ্টব্য: এই এন্ডপয়েন্টে কল করার জন্য শুধুমাত্র তখনই বিল করা হবে যখন একটি ভিডিও বিদ্যমান থাকবে এবং একটি ভিডিও URI ফেরত পাঠানো হবে।
যদি ভিডিওটি আমাদের সিস্টেমে থাকে, কিন্তু এখনও সম্পূর্ণরূপে রেন্ডার না করা হয়, তাহলে lookupVideo PROCESSING এর একটি প্রসেসিং অবস্থা এবং একটি videoId প্রদান করে, যা আপনি রেন্ডারিং সম্পন্ন হওয়ার পরে ভিডিওটি পেতে ব্যবহার করতে পারেন।
যদি ভিডিওটি এখনও বিদ্যমান না থাকে, তাহলে API একটি 404 স্ট্যাটাস কোড প্রদান করে। এই ক্ষেত্রে, আপনি renderVideo কল করে একটি নতুন ভিডিও তৈরি করতে পারেন।

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

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

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

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

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

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

"এটি গুগল ম্যাপস দ্বারা সরবরাহিত ADDRESS এর একটি আলোক-বাস্তববাদী আকাশ দৃশ্য।"

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

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

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

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

ঠিকানা পাঠানোর অনুরোধের উদাহরণ

নিম্নলিখিত কোড নমুনাটি 600 মন্টগোমারি স্ট্রিট, সান ফ্রান্সিসকো, 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 URI গুলির একটি তালিকা প্রদান করে, যার প্রতিটি URI অনুরোধ করা ভিডিওর একটি ভিন্ন ফর্ম্যাট বা সংস্করণের সাথে লিঙ্ক করে। বিভিন্ন ফর্ম্যাট সম্পর্কে জানতে, 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 চিত্রাবলী উপলব্ধ কিনা তার উপর নির্ভর করে "ভিডিও পাওয়া যায়নি" এর দুটি সম্ভাব্য প্রতিক্রিয়া থাকতে পারে।

রেন্ডার করা হয়নি

ভিডিওটি আগে রেন্ডার করা হয়নি, এবং তাই এটি এখনও গুগলের ডাটাবেসে নেই।

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

কোনও 3D চিত্র নেই

গুগল ইতিমধ্যেই ভিডিওটি রেন্ডার করার চেষ্টা করেছে, কিন্তু ব্যর্থ হয়েছে কারণ সেই ঠিকানার জন্য 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 থাকে। আপনি পরে lookupVideo এ পাস করে ভিডিওটি পেতে ঠিকানার পরিবর্তে videoId ব্যবহার করতে পারেন।

নিচের কোড উদাহরণটি দেখায় কিভাবে lookupVideo কল করতে হয়, এটিকে একটি videoId পাস করতে হয়।

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