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

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

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

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

এপিআই কীভাবে ব্যবহার করবেন

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

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

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

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

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

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

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

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

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

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

এটি গুগল ম্যাপস কর্তৃক প্রদত্ত ADDRESS- এর একটি ফটোরিয়ালিস্টিক আকাশ থেকে তোলা দৃশ্য।

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

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

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

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

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

নিম্নলিখিত কোড নমুনাটি ৬০০ মন্টগোমারি স্ট্রিট, সান ফ্রান্সিসকো, সিএ ৯৪১১১-এ অবস্থিত ট্রান্সআমেরিকা পিরামিডের একটি আকাশ থেকে তোলা ভিডিওর অনুরোধ করে।

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

ভিডিওটি খুঁজে পাওয়া যায়নি

স্থানটির জন্য ত্রিমাত্রিক চিত্র উপলব্ধ আছে কি না, তার উপর নির্ভর করে "ভিডিও পাওয়া যায়নি" এর দুটি সম্ভাব্য প্রতিক্রিয়া থাকতে পারে।

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

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

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

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

সিস্টেমটি এখনও আপনার রেন্ডার অনুরোধটি প্রসেস করছে, যার প্রমাণ হলো এর state PROCESSING অবস্থায় রয়েছে। আপনি একটি videoId পাবেন, যা ব্যবহার করে lookupVideo কল করার মাধ্যমে ভিডিওটি পেতে পারবেন।

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

রেন্ডারিং প্রক্রিয়াটিতে এক ঘণ্টা থেকে কয়েক ঘণ্টা পর্যন্ত সময় লাগতে পারে। ভিডিওটি যদি তখনও প্রসেসিং হতে থাকে, তবে আপনি lookupVideo ব্যবহার করে ভিডিওটির স্ট্যাটাস পোল করতে পারেন, যতক্ষণ না এটি ACTIVE অবস্থায় ফিরে আসে।

পোল করার জন্য, videoId পাস করে lookupVideo তে একটি রিকোয়েস্ট পাঠান। রেন্ডার হতে কয়েক ঘণ্টা সময় লাগতে পারে, তাই আপনার কলগুলোর মধ্যে ব্যবধান রাখতে এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করুন।

`videoId` পাস করে অনুরোধের উদাহরণ

যদি আপনি lookupVideo কল করার পর দেখেন যে ওই ঠিকানার জন্য কোনো এরিয়াল ভিউ ভিডিও নেই, তাহলে আপনি সেই ঠিকানাটি দিয়ে renderVideo কল করতে পারেন। renderVideo একটি VideoMetadata অবজেক্ট রিটার্ন করে, যাতে videoId থাকে। পরবর্তীতে আপনি ঠিকানার পরিবর্তে videoId ব্যবহার করে lookupVideo তে পাস করার মাধ্যমে ভিডিওটি পেতে পারেন।

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

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