এক নজরে
Google Street View, কভারেজ এরিয়া জুড়ে নির্দিষ্ট রাস্তা থেকে ৩৬০ ডিগ্রি প্যানোরামিক ভিউ
প্রদান করে। Street View-এর API
কভারেজ Google Maps অ্যাপ্লিকেশনের (https://maps.google.com/)
মতোই। Street View-এর জন্য বর্তমানে
সমর্থিত শহরগুলির তালিকা
Google
Maps ওয়েবসাইটে উপলভ্য।
Street View ছবির একটি নমুনা নিচে দেখানো হল।
Maps JavaScript API, Google Maps Street View-তে ব্যবহার করা ছবি পেতে ও ম্যানিপুলেট করতে Street View পরিষেবা প্রদান করে। এই Street View পরিষেবা ব্রাউজারের মধ্যে নেটিভভাবে কাজ করে।
Street View ম্যাপের ব্যবহার
যদিও Street View একটি
স্ট্যান্ডঅ্যালোন DOM এলিমেন্ট-এর মধ্যে ব্যবহার করা যেতে পারে, তবে এটি ম্যাপে কোনও লোকেশন নির্দেশ করার সময় সবচেয়ে
বেশি উপযোগী। ডিফল্ট হিসেবে, ম্যাপে Street View
চালু করা থাকে এবং নেভিগেশন (জুম ও প্যান) কন্ট্রোলের মধ্যে
Street View পেগম্যান কন্ট্রোল ইন্টিগ্রেট করা থাকে। আপনি ম্যাপের MapOptions-এর মধ্যে এই কন্ট্রোল লুকাতে পারেন,
streetViewControl-কে false-এ সেট করে। এছাড়াও, আপনি Map-এর streetViewControlOptions.position
প্রপার্টি নতুন ControlPosition-এ সেট করে
Street View কন্ট্রোলের ডিফল্ট পজিশন
পরিবর্তন করতে পারেন।
Street View পেগম্যান কন্ট্রোল আপনাকে সরাসরি ম্যাপের মধ্যে Street View প্যানোরামা দেখতে দেয়। ব্যবহারকারী পেগম্যান ক্লিক করে ধরে রাখলে, ম্যাপ আপডেট হয়ে Street View চালু থাকা রাস্তার চারপাশে নীল রঙের আউটলাইন দেখায়, যা Google Maps অ্যাপের মতোই ব্যবহারকারীর অভিজ্ঞতা প্রদান করে।
ব্যবহারকারী কোনও রাস্তায় পেগম্যান মার্কার ড্রপ করলে, ম্যাপ আপডেট হয়ে উল্লেখিত লোকেশনের Street View প্যানোরামা দেখায়।
Street View প্যানোরামা
Street View ছবি
StreetViewPanorama অবজেক্ট ব্যবহারের মাধ্যমে কাজ করে, যা Street View "ভিউয়ার"-এর জন্য API
ইন্টারফেস প্রদান করে। প্রতিটি ম্যাপে ডিফল্ট
Street View প্যানোরামা থাকে, যা আপনি
ম্যাপের getStreetView() পদ্ধতি কল করে ফিরিয়ে আনতে পারবেন। আপনি যখন ম্যাপে Street View
কন্ট্রোল যোগ করেন, তখন এর streetViewControl
বিকল্প true-এ সেট করে, আপনি অটোমেটিক Pegman
কন্ট্রোলকে এই ডিফল্ট Street View প্যানোরামার সাথে কানেক্ট করেন।
এছাড়াও, আপনি নিজের StreetViewPanorama
অবজেক্ট তৈরি করতে এবং ডিফল্টের পরিবর্তে সেটি ব্যবহার করার জন্য ম্যাপ সেট করতে পারবেন,
ম্যাপের streetView প্রপার্টি স্পষ্টভাবে
সেই তৈরি করা অবজেক্টে সেট করার মাধ্যমে। আপনি ডিফল্ট প্যানোরামা ওভাররাইড করতে চাইতে পারেন
যদি আপনি ডিফল্ট আচরণ পরিবর্তন করতে চান, যেমন ম্যাপ এবং প্যানোরামার মধ্যে ওভারলেগুলির
অটোমেটিক শেয়ারিং। (নিচে
Street View-এর মধ্যে ওভারলে দেখুন।)
Street View কন্টেনার
আপনি হয়ত আলাদা DOM এলিমেন্টের মধ্যে StreetViewPanorama
দেখাতে চাইবেন, সাধারণত <div> এলিমেন্ট।
StreetViewPanorama-এর কনস্ট্রাক্টরের মধ্যে
DOM এলিমেন্ট পাস করুন। ছবি যাতে সবচেয়ে ভালভাবে দেখা যায়, তার জন্য আমরা সাজেস্ট করি যে ছবির সাইজ যেন কমপক্ষে
২০০ পিক্সেল x ২০০ পিক্সেল হয়।
মনে রাখবেন: Street View ফাংশনালিটি ম্যাপের সাথে ব্যবহার করার জন্য ডিজাইন করা হলেও, এই ব্যবহার বাধ্যতামূলক নয়। আপনি ম্যাপ ছাড়াই একটি স্বতন্ত্র Street View অবজেক্ট ব্যবহার করতে পারেন।
Street View লোকেশন ও পয়েন্ট-অফ-ভিউ (POV)
StreetViewPanorama কনস্ট্রাক্টর আপনাকে StreetViewOptions প্যারামিটার ব্যবহার করে Street View লোকেশন এবং পয়েন্ট অফ ভিউ সেট করার অনুমতি দেয়। অবজেক্টের লোকেশন ও POV পরিবর্তন করার জন্য আপনি
নির্মাণের পরে অবজেক্টে
setPosition() ও setPov() কল করতে পারেন।
Street View লোকেশন কোনও ছবির জন্য ক্যামেরা ফোকাসের প্লেসমেন্ট নির্ধারণ করে, কিন্তু এটি সেই ছবির জন্য ক্যামেরার ওরিয়েন্টেশন নির্ধারণ করে না। সেই উদ্দেশ্যে, StreetViewPov অবজেক্ট
দুটি প্রপার্টি নির্ধারণ করে:
heading(ডিফল্ট0) ক্যামেরা লোকাসের চারপাশে প্রকৃত উত্তর থেকে আপেক্ষিক ডিগ্রিতে ঘূর্ণন কোণ নির্ধারণ করে। দিকনির্দেশ ঘড়ির কাঁটার দিকে পরিমাপ করা হয় (৯০ ডিগ্রি হল প্রকৃত পূর্ব)।pitch(ডিফল্ট0) ক্যামেরার প্রাথমিক ডিফল্ট পিচ থেকে "উপর" বা "নিচে" অ্যাঙ্গেল ভ্যারিয়েন্স নির্ধারণ করে, যা প্রায়শই (তবে সবসময় নয়) ফ্ল্যাট অনুভূমিক হয়। (যেমন, পাহাড়ে তোলা কোনও ছবিতে ডিফল্ট পিচ অনুভূমিক নাও হতে পারে।) পিচ অ্যাঙ্গেল পজিটিভ ভ্যালু দিয়ে উপরের দিকে (ডিফল্ট পিচের সাথে +৯০ ডিগ্রি সোজা উপরে এবং অর্থোগোনাল) এবং নেগেটিভ ভ্যালু দিয়ে নিচের দিকে (ডিফল্ট পিচের সাথে -৯০ ডিগ্রি সোজা নিচে এবং অর্থোগোনাল) পরিমাপ করা হয়।
StreetViewPov অবজেক্টটি প্রায়ই Street View ক্যামেরার পয়েন্ট অফ ভিউ
নির্ধারণ করতে ব্যবহার করা হয়। এছাড়াও, আপনি
ফটোগ্রাফারের পয়েন্ট-অফ-ভিউ নির্ধারণ করতে পারবেন — সাধারণত যেদিকে
গাড়ি
বা ট্রাইক মুখ করে ছিল —
StreetViewPanorama.getPhotographerPov() পদ্ধতির মাধ্যমে।
নিম্নলিখিত কোডটি Fenway Park-এর প্রাথমিক ভিউ সহ Boston-এর একটি ম্যাপ দেখায়। পেগম্যান বেছে নিয়ে ম্যাপের কোনও কাজ করে এমন লোকেশনে টেনে নিয়ে গেলে Street View প্যানোরামা পরিবর্তন হবে:
TypeScript
async function init(): Promise<void> { // Request needed libraries. const [{ StreetViewPanorama }] = await Promise.all([ google.maps.importLibrary('streetView'), google.maps.importLibrary('maps'), ]); // Get the gmp-map element and its innerMap. const mapElement = document.querySelector('gmp-map')!; const innerMap = mapElement.innerMap; // Get the center of the map. const position = mapElement.center as google.maps.LatLng; // Create a new StreetViewPanorama, set its position, and attach it to the map. const panorama = new StreetViewPanorama(document.getElementById('pano')!, { position, pov: { heading: 34, pitch: 10, }, }); /** * Set the StreetViewPanorama so it displays in the pano element * rather than taking over the map. * This creates a link between the map and the panorama so that * the map is updated when the StreetViewPanorama position changes, * and the StreetViewPanorama is updated when the map changes. */ innerMap.setStreetView(panorama); } void init();
জাভাস্ক্রিপ্ট
async function init() { // Request needed libraries. const [{ StreetViewPanorama }] = await Promise.all([ google.maps.importLibrary('streetView'), google.maps.importLibrary('maps'), ]); // Get the gmp-map element and its innerMap. const mapElement = document.querySelector('gmp-map'); const innerMap = mapElement.innerMap; // Get the center of the map. const position = mapElement.center; // Create a new StreetViewPanorama, set its position, and attach it to the map. const panorama = new StreetViewPanorama(document.getElementById('pano'), { position, pov: { heading: 34, pitch: 10, }, }); /** * Set the StreetViewPanorama so it displays in the pano element * rather than taking over the map. * This creates a link between the map and the panorama so that * the map is updated when the StreetViewPanorama position changes, * and the StreetViewPanorama is updated when the map changes. */ innerMap.setStreetView(panorama); } void init();
CSS
html, body { height: 100%; margin: 0; padding: 0; } body { display: flex; } gmp-map, #pano { flex: 1; height: 100%; }
HTML
<html>
<head>
<title>Street View split-map-panes</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.ts"></script>
<script>
// prettier-ignore
(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
key: "GOOGLE_MAPS_API_KEY",
});
</script>
</head>
<body>
<gmp-map
center="42.345573,-71.098326"
zoom="14"
map-id="DEMO_MAP_ID"></gmp-map>
<div id="pano"></div>
</body>
</html>স্যাম্পেল ব্যবহার করে দেখুন
মোবাইল ডিভাইসে মোশন ট্র্যাকিং
যেসব ডিভাইসে ডিভাইস ওরিয়েন্টেশন ইভেন্ট কাজ করে, সেইসব ডিভাইসে API ব্যবহারকারীদের ডিভাইসের মুভমেন্টের উপর ভিত্তি করে Street View-এর পয়েন্ট অফ ভিউ পরিবর্তন করার সুবিধা দেয়। ব্যবহারকারীরা তাদের ডিভাইস ঘুরিয়ে চারপাশে দেখতে পারবেন। এটি মোশন ট্র্যাকিং বা ডিভাইস রোটেশন ট্র্যাকিং নামে পরিচিত।
অ্যাপ ডেভেলপার হিসেবে, আপনি নিম্নলিখিত উপায়ে ডিফল্ট অ্যাকশন পরিবর্তন করতে পারবেন:
- মোশন ট্র্যাকিং ফাংশন চালু বা বন্ধ করুন। ডিফল্ট হিসেবে, মোশন
ট্র্যাকিং কাজ করে এমন যেকোনও ডিভাইসে এটি চালু করা থাকে। নিম্নলিখিত স্যাম্পেল
মোশন ট্র্যাকিং বন্ধ করে দেয়, তবে মোশন ট্র্যাকিং কন্ট্রোল দৃশ্যমান রাখে।
(মনে রাখবেন যে ব্যবহারকারী কন্ট্রোলে ট্যাপ করে মোশন ট্র্যাকিং চালু করতে পারবেন।)
var panorama = new google.maps.StreetViewPanorama( document.getElementById('pano'), { position: {lat: 37.869260, lng: -122.254811}, pov: {heading: 165, pitch: 0}, motionTracking: false });
-
মোশন ট্র্যাকিং কন্ট্রোল লুকান বা দেখান। ডিফল্ট হিসেবে, মোশন ট্র্যাকিং কাজ করে এমন ডিভাইসে কন্ট্রোল দেখানো হয়। ব্যবহারকারী মোশন ট্র্যাকিং চালু বা বন্ধ করতে কন্ট্রোল ট্যাপ করতে পারেন। মনে রাখবেন, ডিভাইসে মোশন ট্র্যাকিং কাজ না করলে,
motionTrackingControl-এর ভ্যালু যাই হোক না কেন, কন্ট্রোল কখনই দেখা যাবে না।নিম্নলিখিত স্যাম্পেল মোশন ট্র্যাকিং ও মোশন ট্র্যাকিং কন্ট্রোল, দুটিই বন্ধ করে দেয়। এই ক্ষেত্রে, ব্যবহারকারী মোশন ট্র্যাকিং চালু করতে পারবেন না:
var panorama = new google.maps.StreetViewPanorama( document.getElementById('pano'), { position: {lat: 37.869260, lng: -122.254811}, pov: {heading: 165, pitch: 0}, motionTracking: false, motionTrackingControl: false });
- মোশন ট্র্যাকিং কন্ট্রোলের ডিফল্ট পজিশন পরিবর্তন করুন। ডিফল্ট হিসেবে,
প্যানোরামার নিচের ডানদিকে কন্ট্রোল দেখা যায় (পজিশন
RIGHT_BOTTOM)। নিম্নলিখিত স্যাম্পেল কন্ট্রোলের পজিশন নিচের বাঁদিকে সেট করে:var panorama = new google.maps.StreetViewPanorama( document.getElementById('pano'), { position: {lat: 37.869260, lng: -122.254811}, pov: {heading: 165, pitch: 0}, motionTrackingControlOptions: { position: google.maps.ControlPosition.LEFT_BOTTOM } });
মোশন ট্র্যাকিং কীভাবে কাজ করে তা দেখতে, মোবাইল ডিভাইসে (বা ডিভাইস ওরিয়েন্টেশন ইভেন্ট কাজ করে এমন যেকোনও ডিভাইসে) নিম্নলিখিত স্যাম্পেল দেখুন:
Street View-এর মধ্যে ওভারলে
ডিফল্ট StreetViewPanorama অবজেক্ট ম্যাপ
ওভারলে-এর নেটিভ
ডিসপ্লেকে সাপোর্ট করে।
ওভারলে সাধারণত "রাস্তার লেভেলে" LatLng
পজিশনে অ্যাঙ্কর করা অবস্থায় দেখা যায়। (উদাহরণস্বরূপ, Street View প্যানোরামার মধ্যে লোকেশনের অনুভূমিক প্লেনে
অ্যাঙ্কর করা লেজ সহ মার্কারগুলি দেখানো হবে।)
বর্তমানে, Street View প্যানোরামাতে কাজ করে এমন ওভারলে-এর ধরন
Marker, InfoWindow এবং
কাস্টম OverlayView-এর মধ্যে সীমিত। আপনি ম্যাপে যে ওভারলে দেখান তা Street View প্যানোরামাতে
দেখানো হতে পারে। এর জন্য প্যানোরামাকে Map অবজেক্টের বিকল্প হিসেবে
ব্যবহার করা হয়, setMap() কল করা হয় এবং ম্যাপের পরিবর্তে
আর্গুমেন্ট হিসেবে StreetViewPanorama পাস করা হয়। তথ্য
উইন্ডো একইভাবে Street View প্যানোরামার মধ্যে খোলা যেতে পারে, এর জন্য
open() কল করতে হবে এবং ম্যাপের পরিবর্তে
StreetViewPanorama() পাস করতে হবে।
এছাড়াও, ডিফল্ট
StreetViewPanorama সহ ম্যাপ তৈরি করার সময়, ম্যাপে তৈরি করা যেকোনও মার্কার
অটোমেটিক ম্যাপের সাথে যুক্ত Street View প্যানোরামার সাথে শেয়ার করা হয়, তবে
প্যানোরামাটি দৃশ্যমান হতে হবে। ডিফল্ট Street View প্যানোরামা ফিরিয়ে আনতে,
Map অবজেক্টে getStreetView() কল করুন। মনে রাখবেন যে আপনি যদি
ম্যাপের streetView প্রপার্টিকে আপনার নিজের তৈরি করা
StreetViewPanorama-এ স্পষ্টভাবে সেট করেন, তাহলে আপনি
ডিফল্ট প্যানোরামা ওভাররাইড করবেন।
নিম্নলিখিত উদাহরণে নিউ ইয়র্ক সিটির অ্যাস্টর প্লেসের আশেপাশে বিভিন্ন লোকেশন
চিহ্নিত করার জন্য মার্কার দেখানো হয়েছে। Street View-তে ডিসপ্লে টগল করুন যাতে StreetViewPanorama-এর মধ্যে
শেয়ার করা মার্কার দেখা যায়।
TypeScript
const ASSET_BASE_URL = new URL('https://maps-docs-team.web.app/samples/streetview-overlays/dist/'); let panorama: google.maps.StreetViewPanorama; let innerMap: google.maps.Map; async function init() { // Request needed libraries. const [{ Marker }] = await Promise.all([ google.maps.importLibrary('marker'), google.maps.importLibrary('maps'), ]); // Set the location of Astor Place. const astorPlace = { lat: 40.729884, lng: -73.990988 }; const mapElement = document.querySelector('gmp-map')!; innerMap = mapElement.innerMap; document .getElementById('streetview-toggle-button')! .addEventListener('click', toggleStreetView); const cafeIcon = document.createElement('img'); cafeIcon.src = new URL('./cafe_icon.svg', ASSET_BASE_URL).href; const dollarIcon = document.createElement('img'); dollarIcon.src = new URL('./bank_icon.svg', ASSET_BASE_URL).href; const busIcon = document.createElement('img'); busIcon.src = new URL('./bus_icon.svg', ASSET_BASE_URL).href; // Set up the markers on the map new Marker({ position: { lat: 40.730031, lng: -73.991428 }, map: innerMap, title: 'Cafe', icon: cafeIcon.src, }); new Marker({ position: { lat: 40.729681, lng: -73.991138 }, map: innerMap, title: 'Bank', icon: dollarIcon.src, }); new Marker({ position: { lat: 40.729559, lng: -73.990741 }, map: innerMap, title: 'Bus Stop', icon: busIcon.src, }); // We get the map's default panorama and set up some defaults. // Note that we don't yet set it visible. panorama = innerMap.getStreetView()!; // TODO fix type panorama.setPosition(astorPlace); panorama.setPov({ heading: 265, pitch: 0, }); } function toggleStreetView(): void { const toggle = panorama.getVisible(); if (!toggle) { panorama.setVisible(true); } else { panorama.setVisible(false); } } void init();
জাভাস্ক্রিপ্ট
const ASSET_BASE_URL = new URL('https://maps-docs-team.web.app/samples/streetview-overlays/dist/'); let panorama; let innerMap; async function init() { // Request needed libraries. const [{ Marker }] = await Promise.all([ google.maps.importLibrary('marker'), google.maps.importLibrary('maps'), ]); // Set the location of Astor Place. const astorPlace = { lat: 40.729884, lng: -73.990988 }; const mapElement = document.querySelector('gmp-map'); innerMap = mapElement.innerMap; document .getElementById('streetview-toggle-button') .addEventListener('click', toggleStreetView); const cafeIcon = document.createElement('img'); cafeIcon.src = new URL('./cafe_icon.svg', ASSET_BASE_URL).href; const dollarIcon = document.createElement('img'); dollarIcon.src = new URL('./bank_icon.svg', ASSET_BASE_URL).href; const busIcon = document.createElement('img'); busIcon.src = new URL('./bus_icon.svg', ASSET_BASE_URL).href; // Set up the markers on the map new Marker({ position: { lat: 40.730031, lng: -73.991428 }, map: innerMap, title: 'Cafe', icon: cafeIcon.src, }); new Marker({ position: { lat: 40.729681, lng: -73.991138 }, map: innerMap, title: 'Bank', icon: dollarIcon.src, }); new Marker({ position: { lat: 40.729559, lng: -73.990741 }, map: innerMap, title: 'Bus Stop', icon: busIcon.src, }); // We get the map's default panorama and set up some defaults. // Note that we don't yet set it visible. panorama = innerMap.getStreetView(); // TODO fix type panorama.setPosition(astorPlace); panorama.setPov({ heading: 265, pitch: 0, }); } function toggleStreetView() { const toggle = panorama.getVisible(); if (!toggle) { panorama.setVisible(true); } else { panorama.setVisible(false); } } void init(); export {};
CSS
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ #map { height: 100%; } /* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; } #floating-panel { position: absolute; top: 10px; left: 25%; z-index: 5; background-color: #fff; padding: 5px; border: 1px solid #999; text-align: center; font-family: 'Roboto', sans-serif; line-height: 30px; padding-left: 10px; } #streetview-toggle-button { height: 40px; display: flex; align-items: center; justify-content: center; padding: 0 17px; border: none; background: white; cursor: pointer; border-radius: 2px; box-shadow: 0 1px 4px -1px rgba(0, 0, 0, 0.3); margin: 10px 0px 10px -2px; font-family: Roboto, Arial, sans-serif; font-size: 18px; font-weight: 400; color: rgb(86, 86, 86); } #streetview-toggle-button:hover { background: #f4f4f4; color: #000; }
HTML
<html>
<head>
<title>Overlays Within Street View</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
<script>
// prettier-ignore
(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
key: "GOOGLE_MAPS_API_KEY"
});
</script>
</head>
<body>
<gmp-map map-id="DEMO_MAP_ID" center="40.729884, -73.990988" zoom="18">
<input
type="button"
value="Toggle Street View"
id="streetview-toggle-button"
slot="control-block-start-inline-start" />
</gmp-map>
</body>
</html>স্যাম্পেল ব্যবহার করে দেখুন
Street View ইভেন্ট
Street View-এর মধ্যে নেভিগেট করার সময় বা এর ওরিয়েন্টেশন
পরিবর্তন করার সময়, আপনি হয়ত এমন কিছু ইভেন্ট মনিটর করতে চাইবেন যা
StreetViewPanorama-এর স্ট্যাটাসে পরিবর্তন নির্দেশ করে:
pano_changedস্বতন্ত্র প্যানো আইডি পরিবর্তন হলেই ফায়ার করে। এই ইভেন্টটি ট্রিগার করার সময় প্যানোরামার মধ্যে থাকা কোনও সংশ্লিষ্ট ডেটা (যেমন লিঙ্ক) পরিবর্তিত হয়েছে কিনা তা এই ইভেন্টটি গ্যারান্টি দেয় না; এই ইভেন্টটি শুধুমাত্র নির্দেশ করে যে একটি প্যানো আইডি পরিবর্তিত হয়েছে। মনে রাখবেন যে প্যানো আইডি (যা আপনি এই প্যানোরামা রেফারেন্সের জন্য ব্যবহার করতে পারেন) শুধুমাত্র বর্তমান ব্রাউজার সেশনের মধ্যে স্থিতিশীল।- প্যানোরামার অন্তর্নিহিত (
LatLng) পজিশন পরিবর্তন হলেইposition_changedফায়ার হয়। প্যানোরামা ঘোরালে এই ইভেন্ট ট্রিগার হবে না। মনে রাখবেন, আপনি সংশ্লিষ্ট প্যানোরামা আইডি পরিবর্তন না করেই প্যানোরামার অন্তর্নিহিত অবস্থান পরিবর্তন করতে পারবেন, কারণ API অটোমেটিক প্যানোরামার অবস্থানের সাথে নিকটতম প্যানোরামা আইডিকে যুক্ত করবে। - Street View-এর
StreetViewPovপরিবর্তন হলেpov_changedফায়ার হয়। মনে রাখবেন যে পজিশন ও প্যানো আইডি একই থাকলেও এই ইভেন্ট ট্রিগার হতে পারে। - Street View-এর লিঙ্ক পরিবর্তন হলে
links_changedফায়ার হয়। মনে রাখবেন যেpano_changed-এর মাধ্যমে দেখানো প্যানো আইডিতে পরিবর্তন হওয়ার পরে এই ইভেন্টটি অ্যাসিঙ্ক্রোনাসভাবে ফায়ার হতে পারে। - Street View-এর দৃশ্যমানতা পরিবর্তন হলে
visible_changedফায়ার হয়। মনে রাখবেন যেpano_changed-এর মাধ্যমে দেখানো প্যানো আইডিতে পরিবর্তন হওয়ার পরে এই ইভেন্টটি অ্যাসিঙ্ক্রোনাসভাবে ফায়ার হতে পারে।
নিম্নলিখিত কোড থেকে বোঝা যায় যে কীভাবে এইসব ইভেন্ট ম্যানেজ করা যায়
যাতে অন্তর্নিহিত StreetViewPanorama সম্পর্কে ডেটা সংগ্রহ করা যায়:
TypeScript
function initPano() { const panorama = new google.maps.StreetViewPanorama( document.getElementById("pano") as HTMLElement, { position: { lat: 37.869, lng: -122.255 }, pov: { heading: 270, pitch: 0, }, visible: true, } ); panorama.addListener("pano_changed", () => { const panoCell = document.getElementById("pano-cell") as HTMLElement; panoCell.innerHTML = panorama.getPano(); }); panorama.addListener("links_changed", () => { const linksTable = document.getElementById("links_table") as HTMLElement; while (linksTable.hasChildNodes()) { linksTable.removeChild(linksTable.lastChild as ChildNode); } const links = panorama.getLinks(); for (const i in links) { const row = document.createElement("tr"); linksTable.appendChild(row); const labelCell = document.createElement("td"); labelCell.innerHTML = "<b>Link: " + i + "</b>"; const valueCell = document.createElement("td"); valueCell.innerHTML = links[i].description as string; linksTable.appendChild(labelCell); linksTable.appendChild(valueCell); } }); panorama.addListener("position_changed", () => { const positionCell = document.getElementById( "position-cell" ) as HTMLElement; (positionCell.firstChild as HTMLElement).nodeValue = panorama.getPosition() + ""; }); panorama.addListener("pov_changed", () => { const headingCell = document.getElementById("heading-cell") as HTMLElement; const pitchCell = document.getElementById("pitch-cell") as HTMLElement; (headingCell.firstChild as HTMLElement).nodeValue = panorama.getPov().heading + ""; (pitchCell.firstChild as HTMLElement).nodeValue = panorama.getPov().pitch + ""; }); } declare global { interface Window { initPano: () => void; } } window.initPano = initPano;
জাভাস্ক্রিপ্ট
function initPano() { const panorama = new google.maps.StreetViewPanorama( document.getElementById("pano"), { position: { lat: 37.869, lng: -122.255 }, pov: { heading: 270, pitch: 0, }, visible: true, }, ); panorama.addListener("pano_changed", () => { const panoCell = document.getElementById("pano-cell"); panoCell.innerHTML = panorama.getPano(); }); panorama.addListener("links_changed", () => { const linksTable = document.getElementById("links_table"); while (linksTable.hasChildNodes()) { linksTable.removeChild(linksTable.lastChild); } const links = panorama.getLinks(); for (const i in links) { const row = document.createElement("tr"); linksTable.appendChild(row); const labelCell = document.createElement("td"); labelCell.innerHTML = "<b>Link: " + i + "</b>"; const valueCell = document.createElement("td"); valueCell.innerHTML = links[i].description; linksTable.appendChild(labelCell); linksTable.appendChild(valueCell); } }); panorama.addListener("position_changed", () => { const positionCell = document.getElementById("position-cell"); positionCell.firstChild.nodeValue = panorama.getPosition() + ""; }); panorama.addListener("pov_changed", () => { const headingCell = document.getElementById("heading-cell"); const pitchCell = document.getElementById("pitch-cell"); headingCell.firstChild.nodeValue = panorama.getPov().heading + ""; pitchCell.firstChild.nodeValue = panorama.getPov().pitch + ""; }); } window.initPano = initPano;
CSS
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ #map { height: 100%; } /* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; } #floating-panel { position: absolute; top: 10px; left: 25%; z-index: 5; background-color: #fff; padding: 5px; border: 1px solid #999; text-align: center; font-family: "Roboto", "sans-serif"; line-height: 30px; padding-left: 10px; } #pano { width: 50%; height: 100%; float: left; } #floating-panel { width: 45%; height: 100%; float: right; text-align: left; overflow: auto; position: static; border: 0px solid #999; }
HTML
<html>
<head>
<title>Street View Events</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
</head>
<body>
<div id="pano"></div>
<div id="floating-panel">
<table>
<tr>
<td><b>Position</b></td>
<td id="position-cell"> </td>
</tr>
<tr>
<td><b>POV Heading</b></td>
<td id="heading-cell">270</td>
</tr>
<tr>
<td><b>POV Pitch</b></td>
<td id="pitch-cell">0.0</td>
</tr>
<tr>
<td><b>Pano ID</b></td>
<td id="pano-cell"> </td>
</tr>
<table id="links_table"></table>
</table>
</div>
<!--
The `defer` attribute causes the script to execute after the full HTML
document has been parsed. For non-blocking uses, avoiding race conditions,
and consistent behavior across browsers, consider loading using Promises. See
https://developers.google.com/maps/documentation/javascript/load-maps-js-api
for more information.
-->
<script
src="https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initPano&v=weekly"
defer
></script>
</body>
</html>Street View কন্ট্রোল
StreetViewPanorama দেখানোর সময়, ডিফল্ট হিসেবে প্যানোরামাতে
বিভিন্ন ধরনের কন্ট্রোল দেখা যায়। আপনি
StreetViewPanoramaOptions-এর মধ্যে
true বা false-এ উপযুক্ত ফিল্ড সেট করে এইসব কন্ট্রোল চালু বা বন্ধ করতে পারবেন:
panControl-এর মাধ্যমে প্যানোরামা ঘোরানো যায়। এই কন্ট্রোল ডিফল্ট হিসেবে স্ট্যান্ডার্ড ইন্টিগ্রেটেড কম্পাস ও প্যান কন্ট্রোল হিসেবে দেখা যায়। আপনিpanControlOptionsফিল্ডের মধ্যেPanControlOptionsপ্রদান করে কন্ট্রোলের পজিশন পরিবর্তন করতে পারেন।zoomControl-এর মাধ্যমে ছবির মধ্যে জুম করা যায়। এই কন্ট্রোল ডিফল্ট হিসেবে প্যানোরামার নিচে ডানদিকে দেখানো হয়। আপনিzoomControlOptionsফিল্ডের মধ্যেZoomControlOptionsপ্রদান করে কন্ট্রোলের চেহারা পরিবর্তন করতে পারেন।addressControl-এ টেক্সচুয়াল ওভারলে থাকে যা সংশ্লিষ্ট লোকেশনের ঠিকানা দেখায় এবং Google Maps-এ লোকেশন খোলার জন্য লিঙ্ক প্রদান করে। আপনিaddressControlOptionsফিল্ডের মধ্যেStreetViewAddressControlOptionsপ্রদান করে কন্ট্রোলের চেহারা পরিবর্তন করতে পারেন।fullscreenControl-এ Street View ফুল-স্ক্রিন মোডে খোলার বিকল্প থাকে। আপনিfullscreenControlOptionsফিল্ডের মধ্যেFullscreenControlOptionsপ্রদান করে কন্ট্রোলের চেহারা পরিবর্তন করতে পারেন।motionTrackingControlমোবাইল ডিভাইসে মোশন ট্র্যাকিং চালু বা বন্ধ করার বিকল্প অফার করে। এই কন্ট্রোল শুধুমাত্র ডিভাইস ওরিয়েন্টেশন ইভেন্ট কাজ করে এমন ডিভাইসে দেখা যায়। ডিফল্ট হিসেবে, প্যানোরামার নিচে ডানদিকে কন্ট্রোল দেখা যায়।MotionTrackingControlOptionsপ্রদান করে আপনি কন্ট্রোলের পজিশন পরিবর্তন করতে পারবেন। আরও তথ্যের জন্য, মোশন ট্র্যাকিং সংক্রান্ত বিভাগটি দেখুন।linksControl-এ, আশেপাশের প্যানোরামা ছবিতে যাওয়ার জন্য ছবিতে গাইড তীরচিহ্ন প্রদান করা হয়।- 'বন্ধ করুন' কন্ট্রোল ব্যবহারকারীকে Street View ভিউয়ার বন্ধ করার অনুমতি দেয়। আপনি
enableCloseButton-কেtrueবাfalse-এ সেট করে বন্ধ করার কন্ট্রোল চালু বা বন্ধ করতে পারবেন।
নিম্নলিখিত উদাহরণটি সংশ্লিষ্ট Street View-এর মধ্যে দেখানো কন্ট্রোল পরিবর্তন করে এবং ভিউয়ের লিঙ্ক সরিয়ে দেয়:
TypeScript
function initPano() { // Note: constructed panorama objects have visible: true // set by default. const panorama = new google.maps.StreetViewPanorama( document.getElementById("map") as HTMLElement, { position: { lat: 42.345573, lng: -71.098326 }, addressControlOptions: { position: google.maps.ControlPosition.BOTTOM_CENTER, }, linksControl: false, panControl: false, enableCloseButton: false, } ); } declare global { interface Window { initPano: () => void; } } window.initPano = initPano;
জাভাস্ক্রিপ্ট
function initPano() { // Note: constructed panorama objects have visible: true // set by default. const panorama = new google.maps.StreetViewPanorama( document.getElementById("map"), { position: { lat: 42.345573, lng: -71.098326 }, addressControlOptions: { position: google.maps.ControlPosition.BOTTOM_CENTER, }, linksControl: false, panControl: false, enableCloseButton: false, }, ); } window.initPano = initPano;
CSS
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ #map { height: 100%; } /* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; }
HTML
<html>
<head>
<title>Street View Controls</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
</head>
<body>
<div id="map"></div>
<!--
The `defer` attribute causes the script to execute after the full HTML
document has been parsed. For non-blocking uses, avoiding race conditions,
and consistent behavior across browsers, consider loading using Promises. See
https://developers.google.com/maps/documentation/javascript/load-maps-js-api
for more information.
-->
<script
src="https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initPano&v=weekly"
defer
></script>
</body>
</html>Street View ডেটা সরাসরি অ্যাক্সেস করা
আপনি হয়ত প্রোগ্রাম্যাটিক্যালি Street View ডেটার উপলভ্যতা নির্ধারণ করতে
বা নির্দিষ্ট প্যানোরামা সম্পর্কে তথ্য ফেরত দিতে চাইতে পারেন,
যার জন্য ম্যাপ/প্যানোরামা সরাসরি ম্যানিপুলেট করার প্রয়োজন হয় না। আপনি StreetViewService অবজেক্ট ব্যবহার করে
এটি করতে পারেন, যা Google-এর Street View পরিষেবায় স্টোর করা ডেটার
ইন্টারফেস প্রদান করে।
Street View পরিষেবার অনুরোধ
Street View পরিষেবা অ্যাক্সেস করা অ্যাসিঙ্ক্রোনাস, কারণ Google Maps API-কে একটি এক্সটার্নাল সার্ভারে কল করতে হয়। সেই কারণে, অনুরোধ সম্পূর্ণ হওয়ার পরে এক্সিকিউট করার জন্য আপনাকে একটি কলব্যাক পদ্ধতি পাস করতে হবে। এই কলব্যাক পদ্ধতি ফলাফল প্রসেস করে।
আপনি StreetViewService-এ অনুরোধ শুরু করতে পারেন
StreetViewPanoRequest বা
StreetViewLocationRequest ব্যবহার করে।
StreetViewPanoRequest ব্যবহার করে করা অনুরোধ, রেফারেন্স আইডি দেওয়া প্যানোরামা ডেটা ফিরিয়ে দেয় যা অনন্যভাবে প্যানোরামা শনাক্ত করে। মনে রাখবেন যে
এই রেফারেন্স আইডিগুলি শুধুমাত্র সেই প্যানোরামার ছবির লাইফটাইমের জন্য
স্টেবল থাকে।
StreetViewLocationRequest ব্যবহার করে করা অনুরোধ, নিম্নলিখিত প্যারামিটার ব্যবহার করে
নির্দিষ্ট লোকেশনে প্যানোরামা ডেটা সার্চ করে:
locationপ্যানোরামা সার্চ করার জন্য লোকেশন (অক্ষাংশ ও দ্রাঘিমাংশ) নির্দিষ্ট করে।preferenceব্যাসার্ধের মধ্যে কোন প্যানোরামা খুঁজে পাওয়া উচিত তার জন্য একটি পছন্দ সেট করে: প্রদান করা লোকেশনের সবচেয়ে কাছেরটি অথবা ব্যাসার্ধের মধ্যে সবচেয়ে ভালোটি।radiusমিটারে নির্দিষ্ট করা ব্যাসার্ধ সেট করে, যার মধ্যে প্যানোরামা সার্চ করতে হবে, প্রদত্ত অক্ষাংশ এবং দ্রাঘিমাংশের উপর কেন্দ্র করে। উল্লেখ করা না থাকলে ৫০ হল ডিফল্ট।sourceসার্চ করার জন্য প্যানোরামার সোর্স নির্দিষ্ট করে। সঠিক ভ্যালু হল:defaultStreet View-এর জন্য ডিফল্ট সোর্স ব্যবহার করে; সার্চ নির্দিষ্ট সোর্সের মধ্যে সীমাবদ্ধ নয়।outdoorআউটডোর কালেকশনে সার্চ সীমিত করে। মনে রাখবেন, নির্দিষ্ট লোকেশনের জন্য আউটডোর প্যানোরামা নাও থাকতে পারে।
Street View পরিষেবা সংক্রান্ত উত্তর
Street View পরিষেবা থেকে
ফলাফল পাওয়ার পরে তা কার্যকর করার জন্য getPanorama() ফাংশনের
কলব্যাক ফাংশন প্রয়োজন। এই কলব্যাক ফাংশন StreetViewPanoramaData অবজেক্টের মধ্যে প্যানোরামা ডেটার সেট এবং অনুরোধের স্ট্যাটাস উল্লেখ করে StreetViewStatus কোড, এই ক্রমে দেখায়।
একটি StreetViewPanoramaData অবজেক্ট স্পেসিফিকেশনে
নিম্নলিখিত ফর্মের Street View প্যানোরামা সম্পর্কে মেটা-ডেটা থাকে:
{ "location": { "latLng": LatLng, "description": string, "pano": string }, "copyright": string, "links": [{ "heading": number, "description": string, "pano": string, "roadColor": string, "roadOpacity": number }], "tiles": { "worldSize": Size, "tileSize": Size, "centerHeading": number } }
মনে রাখবেন যে এই ডেটা অবজেক্টটি নিজে কোনও StreetViewPanorama
অবজেক্ট নয়। এই ডেটা ব্যবহার করে Street View অবজেক্ট তৈরি করতে, আপনাকে
StreetViewPanorama তৈরি করতে হবে এবং
setPano() কল করতে হবে, এটিতে আইডি পাস করতে হবে, যেমনটি রিটার্ন করা
location.pano ফিল্ডে উল্লেখ করা আছে।
status কোড নিম্নলিখিত মানগুলির মধ্যে যেকোনও একটি দেখাতে পারে:
OK-এর অর্থ হল, পরিষেবাটি একটি মানানসই প্যানোরামা খুঁজে পেয়েছে।ZERO_RESULTSথেকে বোঝা যায় যে পরিষেবাটি পাস করা মাপকাঠির সাথে ম্যাচ করা প্যানোরামা খুঁজে পায়নি।UNKNOWN_ERROR-এর অর্থ হল, Street View-এর অনুরোধ প্রসেস করা যায়নি, তবে সঠিক কারণ জানা যায়নি।
নিম্নলিখিত কোডটি একটি StreetViewService তৈরি করে
যা ম্যাপে ব্যবহারকারীর ক্লিকের উত্তর দেয় মার্কার তৈরি করার মাধ্যমে,
যেটিতে ক্লিক করলে, সেই লোকেশনের একটি StreetViewPanorama
দেখায়। পরিষেবা থেকে ফেরত আসা StreetViewPanoramaData-এর কন্টেন্ট
কোডটি ব্যবহার করে।
TypeScript
/* * Click the map to set a new location for the Street View camera. */ let map: google.maps.Map; let panorama: google.maps.StreetViewPanorama; function initMap(): void { const berkeley = { lat: 37.869085, lng: -122.254775 }; const sv = new google.maps.StreetViewService(); panorama = new google.maps.StreetViewPanorama( document.getElementById("pano") as HTMLElement ); // Set up the map. map = new google.maps.Map(document.getElementById("map") as HTMLElement, { center: berkeley, zoom: 16, streetViewControl: false, }); // Set the initial Street View camera to the center of the map sv.getPanorama({ location: berkeley, radius: 50 }).then(processSVData); // Look for a nearby Street View panorama when the map is clicked. // getPanorama will return the nearest pano when the given // radius is 50 meters or less. map.addListener("click", (event) => { sv.getPanorama({ location: event.latLng, radius: 50 }) .then(processSVData) .catch((e) => console.error("Street View data not found for this location.") ); }); } function processSVData({ data }: google.maps.StreetViewResponse) { const location = data.location!; const marker = new google.maps.Marker({ position: location.latLng, map, title: location.description, }); panorama.setPano(location.pano as string); panorama.setPov({ heading: 270, pitch: 0, }); panorama.setVisible(true); marker.addListener("click", () => { const markerPanoID = location.pano; // Set the Pano to use the passed panoID. panorama.setPano(markerPanoID as string); panorama.setPov({ heading: 270, pitch: 0, }); panorama.setVisible(true); }); } declare global { interface Window { initMap: () => void; } } window.initMap = initMap;
জাভাস্ক্রিপ্ট
/* * Click the map to set a new location for the Street View camera. */ let map; let panorama; function initMap() { const berkeley = { lat: 37.869085, lng: -122.254775 }; const sv = new google.maps.StreetViewService(); panorama = new google.maps.StreetViewPanorama( document.getElementById("pano"), ); // Set up the map. map = new google.maps.Map(document.getElementById("map"), { center: berkeley, zoom: 16, streetViewControl: false, }); // Set the initial Street View camera to the center of the map sv.getPanorama({ location: berkeley, radius: 50 }).then(processSVData); // Look for a nearby Street View panorama when the map is clicked. // getPanorama will return the nearest pano when the given // radius is 50 meters or less. map.addListener("click", (event) => { sv.getPanorama({ location: event.latLng, radius: 50 }) .then(processSVData) .catch((e) => console.error("Street View data not found for this location."), ); }); } function processSVData({ data }) { const location = data.location; const marker = new google.maps.Marker({ position: location.latLng, map, title: location.description, }); panorama.setPano(location.pano); panorama.setPov({ heading: 270, pitch: 0, }); panorama.setVisible(true); marker.addListener("click", () => { const markerPanoID = location.pano; // Set the Pano to use the passed panoID. panorama.setPano(markerPanoID); panorama.setPov({ heading: 270, pitch: 0, }); panorama.setVisible(true); }); } window.initMap = initMap;
CSS
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ #map { height: 100%; } /* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; }
HTML
<html>
<head>
<title>Directly Accessing Street View Data</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
</head>
<body>
<div id="map" style="width: 45%; height: 100%; float: left"></div>
<div id="pano" style="width: 45%; height: 100%; float: left"></div>
<!--
The `defer` attribute causes the script to execute after the full HTML
document has been parsed. For non-blocking uses, avoiding race conditions,
and consistent behavior across browsers, consider loading using Promises. See
https://developers.google.com/maps/documentation/javascript/load-maps-js-api
for more information.
-->
<script
src="https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly"
defer
></script>
</body>
</html>কাস্টম Street View প্যানোরামা প্রদান করা
Maps JavaScript API, StreetViewPanorama অবজেক্টের মধ্যে কাস্টম প্যানোরামা
দেখানোর সুবিধা প্রদান করে। কাস্টম প্যানোরামা ব্যবহার করে, আপনি বিল্ডিংয়ের ভিতরের অংশ, মনোরম লোকেশনের দৃশ্য বা আপনার কল্পনার যেকোনও কিছু দেখাতে পারেন। এমনকি আপনি
এইসব কাস্টম প্যানোরামা Google-এর আগে থেকে থাকা Street View
প্যানোরামার সাথে লিঙ্ক করতে পারবেন।
কাস্টম প্যানোরামা ছবির সেট সেট-আপ করার মধ্যে নিম্নলিখিত ধাপগুলি অন্তর্ভুক্ত:
- প্রতিটি কাস্টম প্যানোরামার জন্য একটি বেস প্যানোরামিক ছবি তৈরি করুন। এই বেস ইমেজটি সর্বোচ্চ রেজোলিউশনের হতে হবে, যাতে আপনি জুম-ইন করা ছবি দেখাতে পারেন।
- (ঐচ্ছিক, তবে সাজেস্ট করা হচ্ছে) বেসিক ছবি থেকে বিভিন্ন জুম লেভেলে প্যানোরামিক টাইলসের একটি সেট তৈরি করুন।
- আপনার কাস্টম প্যানোরামার মধ্যে লিঙ্ক তৈরি করুন।
- (ঐচ্ছিক) Google-এর বর্তমান Street View ছবির মধ্যে "এন্ট্রি" প্যানোরামা নির্দিষ্ট করুন এবং কাস্টম সেট থেকে স্ট্যান্ডার্ড সেটে যাওয়ার/আসার লিঙ্ক কাস্টমাইজ করুন।
StreetViewPanoramaDataঅবজেক্টের মধ্যে প্রতিটি প্যানোরামা ছবির জন্য মেটাডেটা নির্ধারণ করুন।- এমন একটি পদ্ধতি প্রয়োগ করুন যা কাস্টম প্যানোরামা
ডেটা ও ছবি নির্ধারণ করে এবং
StreetViewPanoramaঅবজেক্টের মধ্যে সেই পদ্ধতিকে আপনার কাস্টম হ্যান্ডলার হিসেবে চিহ্নিত করুন।
নিম্নলিখিত বিভাগগুলি এই প্রসেস ব্যাখ্যা করে।
কাস্টম প্যানোরামা তৈরি করা
প্রতিটি Street View প্যানোরামা হল একটি ছবি বা ছবির সেট
যা একটি লোকেশন থেকে সম্পূর্ণ ৩৬০ ডিগ্রি ভিউ প্রদান করে।
StreetViewPanorama অবজেক্ট
এমন ছবি ব্যবহার করে যা ইকুইরেকট্যাঙ্গুলার (প্লেট
ক্যারি) প্রোজেকশনের সাথে মানানসই। এই ধরনের প্রোজেকশনে ৩৬০ ডিগ্রি
অনুভূমিক ভিউ (সম্পূর্ণ র্যাপ-অ্যারাউন্ড) এবং ১৮০ ডিগ্রি
উল্লম্ব ভিউ (সোজা উপর থেকে সোজা নিচ পর্যন্ত) থাকে। এই ফিল্ড অফ ভিউয়ের
ফলে ২:১ অ্যাস্পেক্ট রেশিও সহ ছবি পাওয়া যায়। নিচে
একটি সম্পূর্ণ র্যাপ-অ্যারাউন্ড প্যানোরামা দেখানো হয়েছে।

প্যানোরামা ছবি সাধারণত একটি অবস্থান থেকে একাধিক ফটো তুলে এবং প্যানোরামা সফ্টওয়্যার ব্যবহার করে সেগুলি একসাথে সেলাই করে পাওয়া যায়। (আরও তথ্যের জন্য Wikipedia-এর ফটো স্টিচিং অ্যাপ্লিকেশনের তুলনা দেখুন।) এই ধরনের ছবিগুলি একটি "ক্যামেরা" লোকাস শেয়ার করবে, যেখান থেকে প্রতিটি প্যানোরামা ছবি তোলা হয়েছে। এর ফলে তৈরি হওয়া ৩৬০ ডিগ্রি প্যানোরামা, গোলকের দ্বি-মাত্রিক সারফেসে ছবিটি র্যাপ করে গোলকের উপর প্রোজেকশন নির্ধারণ করতে পারে।

রেক্টিলিনিয়ার কোঅর্ডিনেট সিস্টেম সহ গোলকের উপর প্রজেকশন হিসেবে প্যানোরামাকে বিবেচনা করা সুবিধাজনক হয় যখন ছবিকে রেক্টিলিনিয়ার টাইল-এ ভাগ করা হয় এবং গণনা করা টাইল কোঅর্ডিনেটের উপর ভিত্তি করে ছবি দেখানো হয়।
কাস্টম প্যানোরামা টাইল তৈরি করা
এছাড়াও, Street View-তে জুম কন্ট্রোল ব্যবহার করে ছবির ডিটেল বিভিন্ন লেভেলে দেখা যায়। এর মাধ্যমে আপনি ডিফল্ট ভিউ থেকে জুম-ইন ও জুম-আউট করতে পারবেন। সাধারণত, Street View যেকোনও প্যানোরামা ছবির জন্য জুম রেজোলিউশনের পাঁচটি লেভেল প্রদান করে। আপনি যদি সব জুম লেভেলে দেখানোর জন্য একটি প্যানোরামা ছবির উপর নির্ভর করেন, তাহলে সেই ছবি হয় অনেক বড় হবে এবং আপনার অ্যাপ্লিকেশনকে উল্লেখযোগ্যভাবে স্লো করে দেবে, অথবা বেশি জুম লেভেলে এত খারাপ রেজোলিউশনের হবে যে আপনি একটি খারাপ পিক্সেলযুক্ত ছবি দেখাবেন। তবে, সৌভাগ্যবশত, আমরা একই ধরনের ডিজাইন প্যাটার্ন ব্যবহার করতে পারি যা Google-এর ম্যাপ টাইল বিভিন্ন জুম লেভেলে দেখানোর জন্য ব্যবহার করা হয়, যাতে প্রতিটি জুম লেভেলে প্যানোরামার জন্য উপযুক্ত রেজোলিউশনের ছবি প্রদান করা যায়।
কোনও StreetViewPanorama প্রথমবার লোড হলে, ডিফল্ট হিসেবে
এটি এমন একটি ছবি দেখায় যা প্যানোরামার অনুভূমিক প্রস্থের ২৫% (৯০ ডিগ্রি আর্ক)
জুম লেভেল ১-এ দেখায়। এই ভিউ
মোটামুটিভাবে একজন সাধারণ মানুষের ফিল্ড অফ ভিউয়ের সাথে মিলে যায়। এই ডিফল্ট ভিউ থেকে
"জুম-আউট" করলে মূলত একটি বৃহত্তর আর্ক পাওয়া যায়,
যেখানে জুম-ইন করলে ভিউয়ের ফিল্ডটি একটি ছোট আর্কে সংকুচিত হয়। StreetViewPanorama
বেছে নেওয়া জুম লেভেলের জন্য উপযুক্ত ফিল্ড অফ ভিউ অটোমেটিক
হিসাব করে এবং তারপর আনুভূমিক ফিল্ড অফ ভিউয়ের ডাইমেনশনের সাথে
মোটামুটি মেলে এমন টাইল সেট বেছে নেওয়ার মাধ্যমে সেই রেজোলিউশনের জন্য
সবচেয়ে উপযুক্ত ছবি বেছে নেয়। নিম্নলিখিত ফিল্ড অফ ভিউ Street View-এর জুম লেভেলে
ম্যাপ করা হয়:
| Street View জুম লেভেল | ফিল্ড অফ ভিউ (ডিগ্রি) |
|---|---|
| 0 | ১৮০ |
| ১ (ডিফল্ট) | ৯০ |
| 2 | 45 |
| 3 | 22.5 |
| 4 | ১১.২৫ |
মনে রাখবেন, Street View-তে দেখানো ছবির সাইজ সম্পূর্ণভাবে Street View কন্টেনারের স্ক্রিনের সাইজের (প্রস্থ) উপর নির্ভর করে। আপনি আরও বড় কন্টেনার প্রদান করলে, পরিষেবাটি যেকোনও জুম লেভেলের জন্য একই ফিল্ড অফ ভিউ প্রদান করবে, যদিও এটি সেই রেজোলিউশনের জন্য আরও উপযুক্ত টাইলস বেছে নিতে পারে।
প্রতিটি প্যানোরামা ইকুইরেকট্যাঙ্গুলার প্রোজেকশন দিয়ে তৈরি হয় বলে, প্যানোরামা টাইল তৈরি করা তুলনামূলকভাবে সহজ। যেহেতু প্রোজেকশন ২:১ অ্যাস্পেক্ট রেশিও সহ ছবি প্রদান করে, তাই ২:১ অনুপাত সহ টাইল ব্যবহার করা সহজ, যদিও স্কোয়্যার টাইল স্কোয়্যার ম্যাপে আরও ভাল পারফর্ম্যান্স প্রদান করতে পারে (কারণ ফিল্ড অফ ভিউ স্কোয়্যার হবে)।
২:১ টাইলসের জন্য, সম্পূর্ণ প্যানোরামা জুড়ে থাকা একটি ছবি জুম লেভেল ০-তে সম্পূর্ণ প্যানোরামা "ওয়ার্ল্ড" (বেস ছবি) দেখায়, প্রতিটি ক্রমবর্ধমান জুম লেভেল ৪zoomLevel টাইলস অফার করে। (যেমন, জুম লেভেল ২-এ, সম্পূর্ণ প্যানোরামাতে ১৬টি টাইল থাকে।) মনে রাখবেন: Street View টাইলিংয়ের জুম লেভেল Street View কন্ট্রোল ব্যবহার করে প্রদান করা জুম লেভেলের সাথে সরাসরি মেলে না; পরিবর্তে, Street View কন্ট্রোল জুম লেভেল একটি ফিল্ড অফ ভিউ (FoV) বেছে নেয়, যেখান থেকে উপযুক্ত টাইল বেছে নেওয়া হয়।

সাধারণত, আপনি নিজের ইমেজ টাইলসের নাম দিতে চাইবেন যাতে সেগুলি প্রোগ্রাম্যাটিক্যালি বেছে নেওয়া যায়। এই ধরনের নামকরণ স্কিম কাস্টম প্যানোরামা অনুরোধ ম্যানেজ করা বিভাগে আলোচনা করা হয়েছে।
কাস্টম প্যানোরামা সংক্রান্ত অনুরোধ ম্যানেজ করা
কাস্টম প্যানোরামা ব্যবহার করতে,
StreetViewPanorama.registerPanoProvider() কল করুন, আপনার কাস্টম প্যানোরামা প্রদানকারী পদ্ধতির নাম
উল্লেখ করুন। প্যানোরামা প্রোভাইডার
মেথডকে অবশ্যই একটি StreetViewPanoramaData অবজেক্ট রিটার্ন করতে হবে এবং এতে
নিম্নলিখিত সিগনেচার থাকতে হবে:
Function(pano):StreetViewPanoramaData
StreetViewPanoramaData হল নিম্নলিখিত ফর্মের
একটি অবজেক্ট:
{ copyright: string, location: { description: string, latLng: google.maps.LatLng, pano: string }, tiles: { tileSize: google.maps.Size, worldSize: google.maps.Size, heading: number, getTileUrl: Function }, links: [ description: string, heading: number, pano: string, roadColor: string, roadOpacity: number ] }
নিচে উল্লেখ করা পদ্ধতি অনুযায়ী কাস্টম প্যানোরামা ডিসপ্লে করুন:
StreetViewPanoramaOptions.panoপ্রপার্টিকে কাস্টম ভ্যালুতে সেট করুন।- একটি কাস্টম প্যানোরামা প্রদানকারী ফাংশন সরবরাহ করতে
StreetViewPanorama.registerPanoProvider()কল করুন। - নির্দিষ্ট করা
panoভ্যালু ম্যানেজ করতে আপনার কাস্টম প্যানোরামা প্রোভাইডার ফাংশন প্রয়োগ করুন। - একটি
StreetViewPanoramaDataঅবজেক্ট তৈরি করুন। - আপনার দেওয়া কাস্টম টাইল প্রদানকারী ফাংশনের নামে
StreetViewTileData.getTileUrlপ্রপার্টি সেট করুন। যেমন,getCustomPanoramaTileUrl। - নিচের স্যাম্পেলে যেভাবে দেখানো হয়েছে সেই হিসেবে আপনার কাস্টম টাইল প্রোভাইডার ফাংশন প্রয়োগ করুন।
StreetViewPanoramaDataঅবজেক্টটি ফিরিয়ে দিন।
মনে রাখবেন: আপনি কাস্টম প্যানোরামা দেখাতে চাইলে,
StreetViewPanorama-এ সরাসরি position
সেট করবেন না, কারণ এই ধরনের পজিশন Street View
পরিষেবাকে সেই লোকেশনের কাছাকাছি ডিফল্ট Street View ছবি
অনুরোধ করার নির্দেশ দেবে। পরিবর্তে, এই পজিশনটি
কাস্টম StreetViewPanoramaData অবজেক্টের
location.latLng ফিল্ডের মধ্যে সেট করুন।
নিম্নলিখিত উদাহরণে Google সিডনি অফিসের কাস্টম প্যানোরামা দেখানো হয়েছে। মনে রাখবেন যে এই উদাহরণে ম্যাপ বা ডিফল্ট Street View ছবি ব্যবহার করা হয় না:
TypeScript
async function init(): Promise<void> { // Request needed libraries. const [{ StreetViewPanorama }, { Size }] = await Promise.all([ google.maps.importLibrary('streetView'), google.maps.importLibrary('core'), ]); // Construct the appropriate StreetViewPanoramaData given // the passed pano IDs. function getCustomPanorama( pano: string ): google.maps.StreetViewPanoramaData | null { if (pano === 'reception') { return { location: { pano: 'reception', description: 'Google Sydney - Reception', }, links: [], // The text for the copyright control. copyright: 'Imagery (c) 2010 Google', // The definition of the tiles for this panorama. tiles: { tileSize: new Size(1024, 512), worldSize: new Size(2048, 1024), // The heading in degrees at the origin of the panorama // tile set. centerHeading: 105, getTileUrl: getCustomPanoramaTileUrl, }, }; } return null; } // Set up Street View and initially set it visible. Register the // custom panorama provider function. Set the StreetView to display // the custom panorama 'reception' which we check for below. const panorama = new StreetViewPanorama(document.getElementById('map')!, { pano: 'reception', visible: true, }); panorama.registerPanoProvider(getCustomPanorama); } // Return a pano image given the panoID. function getCustomPanoramaTileUrl( pano: string, zoom: number, tileX: number, tileY: number ): string { return `https://developers.google.com/maps/documentation/javascript/examples/full/images/panoReception1024-${String(zoom)}-${String(tileX)}-${String(tileY)}.jpg`; } void init();
জাভাস্ক্রিপ্ট
async function init() { // Request needed libraries. const [{ StreetViewPanorama }, { Size }] = await Promise.all([ google.maps.importLibrary('streetView'), google.maps.importLibrary('core'), ]); // Construct the appropriate StreetViewPanoramaData given // the passed pano IDs. function getCustomPanorama(pano) { if (pano === 'reception') { return { location: { pano: 'reception', description: 'Google Sydney - Reception', }, links: [], // The text for the copyright control. copyright: 'Imagery (c) 2010 Google', // The definition of the tiles for this panorama. tiles: { tileSize: new Size(1024, 512), worldSize: new Size(2048, 1024), // The heading in degrees at the origin of the panorama // tile set. centerHeading: 105, getTileUrl: getCustomPanoramaTileUrl, }, }; } return null; } // Set up Street View and initially set it visible. Register the // custom panorama provider function. Set the StreetView to display // the custom panorama 'reception' which we check for below. const panorama = new StreetViewPanorama(document.getElementById('map'), { pano: 'reception', visible: true, }); panorama.registerPanoProvider(getCustomPanorama); } // Return a pano image given the panoID. function getCustomPanoramaTileUrl(pano, zoom, tileX, tileY) { return `https://developers.google.com/maps/documentation/javascript/examples/full/images/panoReception1024-${String(zoom)}-${String(tileX)}-${String(tileY)}.jpg`; } void init();
CSS
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ #map { height: 100%; } /* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; }
HTML
<html>
<head>
<title>Custom Street View Panoramas</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
<script>
// prettier-ignore
(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
key: "GOOGLE_MAPS_API_KEY"
});
</script>
</head>
<body>
<div id="map"></div>
</body>
</html>স্যাম্পেল ব্যবহার করে দেখুন
কাস্টম প্যানোরামা প্রদানকারী, পাস করা প্যানোরামা আইডি, জুম লেভেল এবং প্যানোরামা টাইল স্থানাঙ্ক
অনুযায়ী উপযুক্ত টাইল প্রদান করে।
যেহেতু ছবি বেছে নেওয়া এইসব পাস করা ভ্যালুর উপর নির্ভর করে, তাই
এমন ছবির নাম দেওয়া উপযোগী যা এইসব পাস করা ভ্যালু
প্রোগ্রাম্যাটিক্যালি বেছে নিতে পারে, যেমন
pano_zoom_tileX_tileY.png।
নিম্নলিখিত উদাহরণটি ছবিতে আরেকটি তীর যোগ করে, ডিফল্ট Street View নেভিগেশন তীর ছাড়াও, যা Google Sydney-তে নির্দেশ করে এবং কাস্টম ছবির সাথে লিঙ্ক করে:
TypeScript
let panorama: google.maps.StreetViewPanorama; // StreetViewPanoramaData of a panorama just outside the Google Sydney office. let outsideGoogle: google.maps.StreetViewPanoramaData; // StreetViewPanoramaData for a custom panorama: the Google Sydney reception. function getReceptionPanoramaData(): google.maps.StreetViewPanoramaData { return { location: { pano: "reception", // The ID for this custom panorama. description: "Google Sydney - Reception", latLng: new google.maps.LatLng(-33.86684, 151.19583), }, links: [ { heading: 195, description: "Exit", pano: (outsideGoogle.location as google.maps.StreetViewLocation).pano, }, ], copyright: "Imagery (c) 2010 Google", tiles: { tileSize: new google.maps.Size(1024, 512), worldSize: new google.maps.Size(2048, 1024), centerHeading: 105, getTileUrl: function ( pano: string, zoom: number, tileX: number, tileY: number ): string { return ( "https://developers.google.com/maps/documentation/javascript/examples/full/images/" + "panoReception1024-" + zoom + "-" + tileX + "-" + tileY + ".jpg" ); }, }, }; } function initPanorama() { panorama = new google.maps.StreetViewPanorama( document.getElementById("street-view") as HTMLElement, { pano: (outsideGoogle.location as google.maps.StreetViewLocation).pano } ); // Register a provider for the custom panorama. panorama.registerPanoProvider( (pano: string): google.maps.StreetViewPanoramaData => { if (pano === "reception") { return getReceptionPanoramaData(); } // @ts-ignore TODO fix typings return null; } ); // Add a link to our custom panorama from outside the Google Sydney office. panorama.addListener("links_changed", () => { if ( panorama.getPano() === (outsideGoogle.location as google.maps.StreetViewLocation).pano ) { panorama.getLinks().push({ description: "Google Sydney", heading: 25, pano: "reception", }); } }); } function initMap(): void { // Use the Street View service to find a pano ID on Pirrama Rd, outside the // Google office. new google.maps.StreetViewService() .getPanorama({ location: { lat: -33.867386, lng: 151.195767 } }) .then(({ data }: google.maps.StreetViewResponse) => { outsideGoogle = data; initPanorama(); }); } declare global { interface Window { initMap: () => void; } } window.initMap = initMap;
জাভাস্ক্রিপ্ট
let panorama; // StreetViewPanoramaData of a panorama just outside the Google Sydney office. let outsideGoogle; // StreetViewPanoramaData for a custom panorama: the Google Sydney reception. function getReceptionPanoramaData() { return { location: { pano: "reception", // The ID for this custom panorama. description: "Google Sydney - Reception", latLng: new google.maps.LatLng(-33.86684, 151.19583), }, links: [ { heading: 195, description: "Exit", pano: outsideGoogle.location.pano, }, ], copyright: "Imagery (c) 2010 Google", tiles: { tileSize: new google.maps.Size(1024, 512), worldSize: new google.maps.Size(2048, 1024), centerHeading: 105, getTileUrl: function (pano, zoom, tileX, tileY) { return ( "https://developers.google.com/maps/documentation/javascript/examples/full/images/" + "panoReception1024-" + zoom + "-" + tileX + "-" + tileY + ".jpg" ); }, }, }; } function initPanorama() { panorama = new google.maps.StreetViewPanorama( document.getElementById("street-view"), { pano: outsideGoogle.location.pano }, ); // Register a provider for the custom panorama. panorama.registerPanoProvider((pano) => { if (pano === "reception") { return getReceptionPanoramaData(); } // @ts-ignore TODO fix typings return null; }); // Add a link to our custom panorama from outside the Google Sydney office. panorama.addListener("links_changed", () => { if (panorama.getPano() === outsideGoogle.location.pano) { panorama.getLinks().push({ description: "Google Sydney", heading: 25, pano: "reception", }); } }); } function initMap() { // Use the Street View service to find a pano ID on Pirrama Rd, outside the // Google office. new google.maps.StreetViewService() .getPanorama({ location: { lat: -33.867386, lng: 151.195767 } }) .then(({ data }) => { outsideGoogle = data; initPanorama(); }); } window.initMap = initMap;
CSS
html, body { height: 100%; margin: 0; padding: 0; } #street-view { height: 100%; }
HTML
<html>
<head>
<title>Custom Street View Panorama Tiles</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
</head>
<body>
<div id="street-view"></div>
<!--
The `defer` attribute causes the script to execute after the full HTML
document has been parsed. For non-blocking uses, avoiding race conditions,
and consistent behavior across browsers, consider loading using Promises. See
https://developers.google.com/maps/documentation/javascript/load-maps-js-api
for more information.
-->
<script
src="https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly"
defer
></script>
</body>
</html>