ভূমিকা
মানচিত্র স্ট্যাটিক API একটি URL এর মাধ্যমে একটি HTTP অনুরোধের প্রতিক্রিয়া হিসাবে একটি চিত্র (হয় GIF, PNG বা JPEG) প্রদান করে৷ প্রতিটি অনুরোধের জন্য, আপনি মানচিত্রের অবস্থান, চিত্রের আকার, জুম স্তর, মানচিত্রের ধরন এবং মানচিত্রের অবস্থানগুলিতে ঐচ্ছিক মার্কার স্থাপন করতে পারেন৷ আপনি অতিরিক্তভাবে আলফানিউমেরিক অক্ষর ব্যবহার করে আপনার মার্কারগুলিকে লেবেল করতে পারেন।
একটি মানচিত্র স্ট্যাটিক API ইমেজ একটি <img>
ট্যাগের src
অ্যাট্রিবিউটের মধ্যে বা অন্যান্য প্রোগ্রামিং ভাষায় এর সমতুল্য এম্বেড করা হয়।
এই নথিটি মানচিত্র স্ট্যাটিক API URL এবং উপলব্ধ পরামিতিগুলির প্রয়োজনীয় বিন্যাস বর্ণনা করে৷ এটি আপনার URL গুলি নির্দিষ্ট করার জন্য কিছু টিপস এবং কৌশলও নির্দেশ করে৷
আপনি শুরু করার আগে
এই ডকুমেন্টটি ওয়েবসাইট এবং মোবাইল ডেভেলপারদের জন্য যারা একটি ওয়েবপেজ বা মোবাইল অ্যাপ্লিকেশনের মধ্যে মানচিত্র স্ট্যাটিক API ইমেজ অন্তর্ভুক্ত করতে চান। এটি উপলব্ধ পরামিতিগুলিতে API এবং রেফারেন্স উপাদান ব্যবহার করার একটি ভূমিকা প্রদান করে।
আপনি মানচিত্র স্ট্যাটিক API এর সাথে বিকাশ শুরু করার আগে, প্রমাণীকরণের প্রয়োজনীয়তাগুলি পর্যালোচনা করুন (আপনার একটি API কী প্রয়োজন) এবং API ব্যবহার এবং বিলিং তথ্য (আপনাকে আপনার প্রকল্পে বিলিং সক্ষম করতে হবে)।
URL প্যারামিটার
একটি মানচিত্র স্ট্যাটিক API URL নিম্নলিখিত ফর্মের হতে হবে:
https://maps.googleapis.com/maps/api/staticmap?parameters
যদি আপনার ওয়েবসাইট HTTPS-এর মাধ্যমে অ্যাক্সেস করা হয়, তাহলে ব্রাউজার নিরাপত্তা সতর্কতা এড়াতে আপনাকে অবশ্যই HTTPS-এ মানচিত্র স্ট্যাটিক API ছবি লোড করতে হবে। আপনার অনুরোধে ব্যবহারকারীর অবস্থানের মতো সংবেদনশীল তথ্য অন্তর্ভুক্ত হলে HTTPS-এরও সুপারিশ করা হয়:
https://maps.googleapis.com/maps/api/staticmap?parameters
HTTP বা HTTPS ব্যবহার করা হোক না কেন, নির্দিষ্ট URL প্যারামিটার প্রয়োজন যখন কিছু ঐচ্ছিক। ইউআরএল-এ স্ট্যান্ডার্ড হিসাবে, অ্যাম্পারস্যান্ড ( &
) অক্ষর ব্যবহার করে সমস্ত প্যারামিটার আলাদা করা হয়। প্যারামিটারের তালিকা এবং তাদের সম্ভাব্য মান এই নথিতে গণনা করা হয়েছে।
মানচিত্র স্ট্যাটিক API নিম্নলিখিত URL প্যারামিটার ব্যবহার করে মানচিত্র চিত্রগুলিকে সংজ্ঞায়িত করে:
অবস্থানের পরামিতি
-
center
(মার্কার উপস্থিত না থাকলে প্রয়োজনীয় ) মানচিত্রের কেন্দ্রকে সংজ্ঞায়িত করে, মানচিত্রের সমস্ত প্রান্ত থেকে সমান দূরত্বে। এই প্যারামিটারটি হয় একটি কমা-বিভক্ত {অক্ষাংশ, দ্রাঘিমাংশ} জোড়া (যেমন "40.714728,-73.998672") বা একটি স্ট্রিং ঠিকানা (যেমন "সিটি হল, নিউ ইয়র্ক, NY") হিসাবে একটি অবস্থান নেয় পৃথিবী আরও তথ্যের জন্য, অবস্থান দেখুন। -
zoom
(মার্কার উপস্থিত না থাকলে প্রয়োজনীয় ) মানচিত্রের জুম স্তর নির্ধারণ করে, যা মানচিত্রের বিবর্ধন স্তর নির্ধারণ করে। এই প্যারামিটারটি পছন্দসই অঞ্চলের জুম স্তরের সাথে সম্পর্কিত একটি সংখ্যাসূচক মান নেয়৷ আরও তথ্যের জন্য, জুম স্তর দেখুন।
মানচিত্র পরামিতি
-
size
( প্রয়োজনীয় ) মানচিত্র চিত্রের আয়তক্ষেত্রাকার মাত্রা সংজ্ঞায়িত করে। এই প্যারামিটারটি ফর্মের একটি স্ট্রিং নেয়{horizontal_value} x {vertical_value}
। উদাহরণস্বরূপ,500x400
একটি মানচিত্রকে সংজ্ঞায়িত করে 500 পিক্সেল চওড়া বাই 400 পিক্সেল উঁচু৷ প্রস্থে 180 পিক্সেলের চেয়ে ছোট মানচিত্র একটি ছোট আকারের Google লোগো প্রদর্শন করবে। এই প্যারামিটারটিscale
প্যারামিটার দ্বারা প্রভাবিত হয়; চূড়ান্ত আউটপুট আকার আকার এবং স্কেলের মানগুলির পণ্য। -
scale
( ঐচ্ছিক ) ফিরে আসা পিক্সেলের সংখ্যাকে প্রভাবিত করে।scale=2
একই কভারেজ এলাকা এবং বিশদ স্তর বজায় রেখেscale=1
এর দ্বিগুণ পিক্সেল প্রদান করে (যেমন মানচিত্রের বিষয়বস্তু পরিবর্তন হয় না)। উচ্চ-রেজোলিউশন প্রদর্শনের জন্য বিকাশ করার সময় এটি কার্যকর। ডিফল্ট মান হল1
। গৃহীত মান হল1
এবং2
। আরও তথ্যের জন্য স্কেল মান দেখুন। -
format
( ঐচ্ছিক ) ফলে চিত্রের বিন্যাস সংজ্ঞায়িত করে। ডিফল্টরূপে, মানচিত্র স্ট্যাটিক API PNG ছবি তৈরি করে। GIF, JPEG এবং PNG প্রকার সহ বেশ কয়েকটি সম্ভাব্য বিন্যাস রয়েছে। আপনি কোন বিন্যাসটি ব্যবহার করবেন তা নির্ভর করে আপনি কীভাবে চিত্রটি উপস্থাপন করতে চান তার উপর। JPEG সাধারণত বৃহত্তর সংকোচন প্রদান করে, যখন GIF এবং PNG বৃহত্তর বিশদ প্রদান করে। আরও তথ্যের জন্য, চিত্র বিন্যাস দেখুন। -
maptype
( ঐচ্ছিক ) মানচিত্র নির্মাণের ধরন সংজ্ঞায়িত করে৷roadmap
,satellite
,hybrid
, এবংterrain
সহ বেশ কয়েকটি সম্ভাব্য মানচিত্রের মান রয়েছে৷ আরও তথ্যের জন্য, মানচিত্র স্ট্যাটিক API মানচিত্র দেখুন। -
language
( ঐচ্ছিক ) মানচিত্র টাইলগুলিতে লেবেল প্রদর্শনের জন্য ব্যবহার করার জন্য ভাষাকে সংজ্ঞায়িত করে। মনে রাখবেন যে এই প্যারামিটারটি শুধুমাত্র কিছু দেশের টাইলসের জন্য সমর্থিত; যদি অনুরোধ করা নির্দিষ্ট ভাষাটি টাইল সেটের জন্য সমর্থিত না হয়, তাহলে সেই টাইলসেটের জন্য ডিফল্ট ভাষা ব্যবহার করা হবে। -
region
( ঐচ্ছিক ) ভূ-রাজনৈতিক সংবেদনশীলতার উপর ভিত্তি করে প্রদর্শনের জন্য উপযুক্ত সীমানা নির্ধারণ করে। একটি দুই-অক্ষরের ccTLD ('টপ-লেভেল ডোমেন') মান হিসাবে নির্দিষ্ট করা একটি অঞ্চল কোড গ্রহণ করে। সমর্থিত অঞ্চলগুলির জন্য Google মানচিত্র প্ল্যাটফর্ম কভারেজের বিবরণ দেখুন৷
বৈশিষ্ট্য পরামিতি
-
map_id
( ঐচ্ছিক ) একটি নির্দিষ্ট মানচিত্রের জন্য শনাক্তকারী নির্দিষ্ট করে৷ মানচিত্র আইডি একটি মানচিত্রকে একটি নির্দিষ্ট শৈলী বা বৈশিষ্ট্যের সাথে সংযুক্ত করে এবং মানচিত্র আরম্ভ করার জন্য ব্যবহৃত API কী হিসাবে একই প্রকল্পের অন্তর্গত হতে হবে। আরও তথ্যের জন্য, মানচিত্র আইডি ব্যবহার করা দেখুন। -
markers
( ঐচ্ছিক ) নির্দিষ্ট স্থানে চিত্রের সাথে সংযুক্ত করার জন্য এক বা একাধিক মার্কারকে সংজ্ঞায়িত করে। এই প্যারামিটারটি পাইপ অক্ষর (|
) দ্বারা পৃথক করা পরামিতি সহ একটি একক মার্কার সংজ্ঞা নেয়। একাধিক মার্কার একইmarkers
প্যারামিটারের মধ্যে স্থাপন করা যেতে পারে যতক্ষণ না তারা একই শৈলী প্রদর্শন করে; আপনি অতিরিক্তmarkers
পরামিতি যোগ করে বিভিন্ন শৈলীর অতিরিক্ত মার্কার যোগ করতে পারেন। মনে রাখবেন যে আপনি যদি একটি মানচিত্রের জন্য মার্কার সরবরাহ করেন তবে আপনাকে (সাধারণত প্রয়োজনীয়)center
এবংzoom
পরামিতিগুলি নির্দিষ্ট করতে হবে না। আরও তথ্যের জন্য, মানচিত্র স্ট্যাটিক API মার্কার দেখুন। -
path
( ঐচ্ছিক ) নির্দিষ্ট স্থানে চিত্রের উপর ওভারলে করার জন্য দুই বা ততোধিক সংযুক্ত বিন্দুর একটি একক পথ সংজ্ঞায়িত করে। এই প্যারামিটারটি পাইপ অক্ষর (|
) দ্বারা বিভক্ত বিন্দু সংজ্ঞাগুলির একটি স্ট্রিং নেয় বা পাথের অবস্থান ঘোষণার মধ্যেenc:
উপসর্গ ব্যবহার করে একটি এনকোড করা পলিলাইন নেয়। আপনি অতিরিক্তpath
প্যারামিটার যোগ করে অতিরিক্ত পাথ সরবরাহ করতে পারেন। মনে রাখবেন যে আপনি যদি একটি মানচিত্রের জন্য একটি পথ সরবরাহ করেন তবে আপনাকে (সাধারণত প্রয়োজনীয়)center
এবংzoom
পরামিতিগুলি নির্দিষ্ট করতে হবে না। আরও তথ্যের জন্য, মানচিত্র স্ট্যাটিক API পাথ দেখুন। -
visible
( ঐচ্ছিক ) এক বা একাধিক অবস্থান নির্দিষ্ট করে যা মানচিত্রে দৃশ্যমান থাকা উচিত, যদিও কোনো চিহ্নিতকারী বা অন্যান্য সূচক প্রদর্শিত হবে না। মানচিত্র স্ট্যাটিক API এ নির্দিষ্ট বৈশিষ্ট্য বা মানচিত্রের অবস্থানগুলি দেখানো হয়েছে তা নিশ্চিত করতে এই প্যারামিটারটি ব্যবহার করুন৷ -
style
( ঐচ্ছিক ) মানচিত্রের একটি নির্দিষ্ট বৈশিষ্ট্য (রাস্তা, পার্ক এবং অন্যান্য বৈশিষ্ট্য) উপস্থাপনা পরিবর্তন করতে একটি কাস্টম শৈলী সংজ্ঞায়িত করে। এই প্যারামিটারটিfeature
এবংelement
আর্গুমেন্টগুলিকে শৈলীতে বৈশিষ্ট্যগুলি সনাক্ত করে এবং নির্বাচিত বৈশিষ্ট্যগুলিতে প্রয়োগ করার জন্য শৈলী অপারেশনগুলির একটি সেট নেয়। আপনি অতিরিক্তstyle
পরামিতি যোগ করে একাধিক শৈলী সরবরাহ করতে পারেন। আরও তথ্যের জন্য, স্টাইল করা মানচিত্রের নির্দেশিকা দেখুন।
কী এবং স্বাক্ষর পরামিতি
-
key
( প্রয়োজনীয় ) আপনাকে Google ক্লাউড কনসোলে আপনার অ্যাপ্লিকেশনের API ব্যবহার নিরীক্ষণ করার অনুমতি দেয় এবং নিশ্চিত করে যে Google প্রয়োজনে আপনার অ্যাপ্লিকেশন সম্পর্কে আপনার সাথে যোগাযোগ করতে পারে। আরও তথ্যের জন্য, মানচিত্র স্ট্যাটিক API এর সাথে API কী ব্যবহার করুন দেখুন। -
signature
( প্রস্তাবিত ) হল একটি ডিজিটাল স্বাক্ষর যা আপনার API কী ব্যবহার করে যেকোন সাইট অনুরোধ তৈরি করে তা যাচাই করার জন্য ব্যবহৃত হয়। একটি ডিজিটাল স্বাক্ষর ছাড়া অনুরোধ ব্যর্থ হতে পারে. আরও তথ্যের জন্য, একটি ডিজিটাল স্বাক্ষর ব্যবহার করুন দেখুন।
URL আকারের সীমাবদ্ধতা
মানচিত্র স্ট্যাটিক API URL গুলি আকারে 16384 অক্ষরের মধ্যে সীমাবদ্ধ৷ অনুশীলনে, আপনার সম্ভবত এর থেকে দীর্ঘ URL-এর প্রয়োজন হবে না, যদি না আপনি উচ্চ সংখ্যক মার্কার এবং পাথ সহ জটিল মানচিত্র তৈরি করেন।
প্যারামিটার ব্যবহার
মানচিত্র স্ট্যাটিক API ব্যবহার করা তুলনামূলকভাবে সহজ, কারণ এটি শুধুমাত্র একটি প্যারামিটারাইজড URL নিয়ে গঠিত। এই বিভাগটি ব্যাখ্যা করে কিভাবে এই প্যারামিটারগুলি ব্যবহার করে আপনার URL গুলি তৈরি করতে হয়৷
অবস্থান নির্দিষ্ট করা
মানচিত্র স্ট্যাটিক API অবশ্যই সঠিক অবস্থানে মানচিত্রকে ফোকাস করতে ( center
পরামিতি ব্যবহার করে) এবং/অথবা মানচিত্রের অবস্থানগুলিতে কোনো ঐচ্ছিক স্থানচিহ্ন ( markers
প্যারামিটার ব্যবহার করে) স্থাপন করতে, উভয়ই মানচিত্রের অবস্থানগুলিকে সঠিকভাবে সনাক্ত করতে সক্ষম হতে হবে৷ মানচিত্র স্ট্যাটিক API এই অবস্থানগুলি নির্দিষ্ট করতে সংখ্যা (অক্ষাংশ এবং দ্রাঘিমাংশের মান) বা স্ট্রিং (ঠিকানা) ব্যবহার করে। এই মানগুলি একটি জিওকোডেড অবস্থান সনাক্ত করে।
বেশ কিছু প্যারামিটার (যেমন markers
এবং path
প্যারামিটার) একাধিক অবস্থান নেয়। এই ক্ষেত্রে, অবস্থানগুলি পাইপ ( |
) অক্ষর দ্বারা পৃথক করা হয়।
অক্ষাংশ এবং দ্রাঘিমাংশ
অক্ষাংশ এবং দ্রাঘিমাংশগুলি একটি কমা দ্বারা পৃথক করা পাঠ্য স্ট্রিংয়ের মধ্যে সংখ্যা ব্যবহার করে সংজ্ঞায়িত করা হয় যার সূক্ষ্মতা 6 দশমিক স্থানে রয়েছে৷ উদাহরণস্বরূপ, "40.714728,-73.998672" একটি বৈধ জিওকোড মান৷ 6 দশমিক স্থান অতিক্রম নির্ভুলতা উপেক্ষা করা হয়.
দ্রাঘিমাংশের মানগুলি ইংল্যান্ডের গ্রিনিচ থেকে তাদের দূরত্বের উপর ভিত্তি করে তৈরি করা হয়, প্রধান মেরিডিয়ানের বাড়ি। যেহেতু গ্রিনউইচ 51.477222 অক্ষাংশে অবস্থিত, তাই আমরা গ্রিনিচের মানচিত্রটিকে কেন্দ্রীভূত করতে 51.477222,0
এর center
মান লিখতে পারি:
অক্ষাংশ এবং দ্রাঘিমাংশের মানগুলি অবশ্যই পৃথিবীর মুখের একটি বৈধ অবস্থানের সাথে সঙ্গতিপূর্ণ হবে৷ অক্ষাংশ -90
এবং 90
এর মধ্যে যে কোনও মান নিতে পারে যখন দ্রাঘিমাংশের মানগুলি -180
এবং 180
মধ্যে যে কোনও মান নিতে পারে। আপনি যদি একটি অবৈধ অক্ষাংশ বা দ্রাঘিমাংশের মান উল্লেখ করেন, আপনার অনুরোধটি একটি খারাপ অনুরোধ হিসাবে প্রত্যাখ্যান করা হবে৷
ঠিকানা
বেশিরভাগ মানুষ অক্ষাংশ এবং দ্রাঘিমাংশে কথা বলে না; তারা ঠিকানা ব্যবহার করে অবস্থান নির্দেশ করে। একটি ঠিকানাকে ভৌগলিক বিন্দুতে পরিণত করার প্রক্রিয়াটি জিওকোডিং নামে পরিচিত এবং আপনি বৈধ ঠিকানা প্রদান করলে মানচিত্র স্ট্যাটিক API পরিষেবা আপনার জন্য জিওকোডিং করতে পারে৷
যেকোনো প্যারামিটারে যেখানে আপনি একটি অক্ষাংশ/দ্রাঘিমাংশ প্রদান করতে পারেন, আপনি পরিবর্তে একটি ঠিকানা নির্দেশ করে একটি স্ট্রিং নির্দিষ্ট করতে পারেন। Google ঠিকানাটিকে জিওকোড করবে এবং মার্কার স্থাপন বা অবস্থান নির্দিষ্ট করার জন্য ব্যবহার করার জন্য একটি অক্ষাংশ/দ্রাঘিমাংশ মান সহ মানচিত্র স্ট্যাটিক API পরিষেবা প্রদান করবে। স্ট্রিংটি URL-এনকোড করা উচিত, তাই "City Hall, New York, NY" এর মতো ঠিকানাগুলিকে "City+Hall,New+York,NY" তে রূপান্তর করা উচিত, উদাহরণস্বরূপ।
নোট করুন যে ঠিকানাগুলি হয় সুনির্দিষ্ট অবস্থানগুলিকে প্রতিফলিত করতে পারে, যেমন রাস্তার ঠিকানা, পলিলাইন যেমন নামকৃত রুট, বা বহুভুজ এলাকা যেমন শহর, দেশ বা জাতীয় উদ্যান। পলিলিনিয়ার এবং বহুভুজ ফলাফলের জন্য, ম্যাপ স্ট্যাটিক API সার্ভার লাইন/এরিয়ার কেন্দ্র বিন্দুটিকে ঠিকানা কেন্দ্র হিসাবে ব্যবহার করবে। একটি ঠিকানা কীভাবে জিওকোড হতে পারে সে সম্পর্কে আপনার সন্দেহ থাকলে, আপনি এই জিওকোডিং ইউটিলিটি ব্যবহার করে ঠিকানাটি পরীক্ষা করতে পারেন।
নিম্নলিখিত উদাহরণটি বার্কলে, CA-এর জন্য একটি স্ট্যাটিক মানচিত্র চিত্র তৈরি করে:
https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
জুম মাত্রা
Google মানচিত্রের মানচিত্রে একটি পূর্ণসংখ্যা 'জুম স্তর' রয়েছে যা বর্তমান দৃশ্যের রেজোলিউশনকে সংজ্ঞায়িত করে। ডিফল্ট roadmap
ভিউয়ের মধ্যে 0
(সর্বনিম্ন জুম স্তর, যেখানে সমগ্র বিশ্ব এক মানচিত্রে দেখা যায়) এবং 21+
(রাস্তায় এবং পৃথক বিল্ডিং পর্যন্ত) এর মধ্যে জুম স্তরগুলি সম্ভব। বিল্ডিং রূপরেখা, যেখানে উপলব্ধ, সেখানে জুম স্তর 17
এর চারপাশে মানচিত্রে প্রদর্শিত হবে। এই মানটি এলাকা থেকে অঞ্চলে আলাদা হয় এবং ডেটা বিকশিত হওয়ার সাথে সাথে সময়ের সাথে পরিবর্তিত হতে পারে।
গুগল ম্যাপ পুরো পৃথিবীকে ঘিরে জুম লেভেল 0
সেট করে। প্রতিটি সফল জুম স্তর অনুভূমিক এবং উল্লম্ব উভয় মাত্রায় নির্ভুলতা দ্বিগুণ করে। এটি কীভাবে করা হয় সে সম্পর্কে আরও তথ্য Google মানচিত্র জাভাস্ক্রিপ্ট API ডকুমেন্টেশনে উপলব্ধ।
দ্রষ্টব্য: পৃথিবীর সমস্ত স্থানে সমস্ত জুম স্তর প্রদর্শিত হয় না৷ অবস্থানের উপর নির্ভর করে জুমের মাত্রা পরিবর্তিত হয়, কারণ পৃথিবীর কিছু অংশের ডেটা অন্যান্য অবস্থানের তুলনায় বেশি দানাদার।
আপনি যদি একটি জুম স্তরের জন্য একটি অনুরোধ পাঠান যেখানে কোনও মানচিত্র টাইল নেই, তাহলে মানচিত্র স্ট্যাটিক API পরিবর্তে একটি ফাঁকা চিত্র ফিরিয়ে দেবে৷
নিম্নলিখিত তালিকাটি আনুমানিক বিশদ স্তর দেখায় যা আপনি প্রতিটি জুম স্তরে দেখতে আশা করতে পারেন:
- 1: বিশ্ব
- 5: ল্যান্ডমাস/মহাদেশ
- 10: শহর
- 15: রাস্তা
- 20: বিল্ডিং
এই উদাহরণটি ম্যানহাটনের দুটি মানচিত্রকে একই center
মান কিন্তু জুম স্তরে যথাক্রমে 12 এবং 14-এ অনুরোধ করে:
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
ছবির মাপ
size
প্যারামিটার, center
সাথে একযোগে, একটি মানচিত্রের কভারেজ এলাকা সংজ্ঞায়িত করে। এটি পিক্সেলে মানচিত্রের আউটপুট আকারকেও সংজ্ঞায়িত করে, যখন scale
মান দিয়ে গুণ করা হয় (যা ডিফল্টরূপে 1
)।
এই টেবিলটি প্রতিটি scale
মানের size
প্যারামিটারের জন্য সর্বাধিক অনুমোদিত মানগুলি দেখায়।
scale=1 | scale=2 |
---|---|
640x640 | 640x640 (1280x1280 পিক্সেল ফেরত দেয়) |
এই উদাহরণটি জুম লেভেল 1 এ বিষুব রেখায় পৃথিবীর একটি "টুকরা" অনুরোধ করে:
https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=400x50&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
এই উদাহরণটি একই অঞ্চলকে কেন্দ্র করে 100 x 100 পিক্সেল আকারের একটি ছোট মানচিত্রের অনুরোধ করে৷ ছোট Google লোগোটি নোট করুন:
https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=100x100&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
স্কেল মান
মানচিত্র স্ট্যাটিক API-এর size
প্যারামিটার একটি মানচিত্রের আকারকে পিক্সেলে সংজ্ঞায়িত করে, যাতে size=200x200
সহ একটি মানচিত্র 200 পিক্সেল বাই 200 পিক্সেল হিসাবে ফিরে আসে। একটি LCD কম্পিউটার মনিটরে, যা সাধারণত প্রতি ইঞ্চিতে প্রায় 100 পিক্সেল (ppi) প্রদর্শন করে, একটি 200x200 মানচিত্র প্রতিটি মাত্রায় প্রায় 2 ইঞ্চি হবে।
যাইহোক, মোবাইল ডিভাইসে ক্রমবর্ধমানভাবে 300ppi-এর বেশি পিক্সেল ঘনত্ব সহ উচ্চ রেজোলিউশনের স্ক্রিনগুলি অন্তর্ভুক্ত করে, যা হয়:
- একটি 200x200 পিক্সেল চিত্রের আকার কমিয়ে একটি ইঞ্চি মাত্র 0.7 করুন, রেন্ডারিং লেবেল এবং আইকনগুলি পড়ার জন্য খুব ছোট; বা
- স্পষ্টতা উন্নত করতে চিত্রটিকে স্কেল (জুম) করুন, যার ফলে একটি অস্পষ্ট বা পিক্সেলেটেড চিত্র দেখা যায়।
খুব ছোট | খুব অস্পষ্ট |
---|---|
![]() | ![]() |
মোবাইল ডিভাইসগুলির জন্য বিকাশ করার সময়, আপনি উপরের সমস্যাগুলি সমাধান করে এমন উচ্চ-রেজোলিউশন মানচিত্র চিত্রগুলি ফেরত দিতে API এর scale
প্যারামিটার ব্যবহার করতে পারেন৷ মানচিত্রের কভারেজ এলাকা পরিবর্তন না করেই পিক্সেলে ছবির প্রকৃত আউটপুট আকার নির্ধারণ করতে scale
মানকে size
সাথে গুণ করা হয়। ডিফল্ট scale
মান 1; গৃহীত মান হল 1 এবং 2।
উদাহরণ স্বরূপ, 2 এর স্কেল মান একটি অনুরোধ হিসাবে একই মানচিত্র কভারেজ এলাকা ফেরত দেবে যেখানে কোনো স্কেল নির্দিষ্ট করা নেই, কিন্তু প্রতিটি মাত্রায় দ্বিগুণ পিক্সেল সহ। এর মধ্যে রাস্তা এবং লেবেল রয়েছে, যাতে সেগুলি উচ্চ রেজোলিউশন, ছোট আকারের স্ক্রিনে এবং সেইসাথে ব্রাউজার দ্বারা স্কেল করার সময় সুস্পষ্ট হয়৷
150x150 | 150x150&স্কেল=2 |
---|---|
![]() | ![]() |
CSS ব্যবহার করে উচ্চতা এবং প্রস্থ সেট সহ একটি img
বা div
ট্যাগে ঢোকানো হলে এই ধরনের একটি ছবি ডেস্কটপ ব্রাউজারগুলিতেও ভাল পারফর্ম করবে। ব্রাউজার মানের ক্ষতি ছাড়াই চিত্রটিকে সঠিক আকারে ছোট করবে।
এই টেবিল তিনটি ভিন্ন ইমেজ অনুরোধ দেখায়.
- প্রথমটি একটি 100x100 চিত্রের জন্য, কোনো স্কেল মান নির্দিষ্ট করা নেই৷ এটি ডেস্কটপে সঠিকভাবে প্রদর্শিত হয়, কিন্তু মোবাইল ডিভাইসে পড়ার জন্য খুব ছোট।
- দ্বিতীয়টি মানচিত্রের আকারকে দ্বিগুণ করে। ডেস্কটপে, CSS এটিকে নির্দিষ্ট 100x100
img
এলিমেন্টে ফিট করে, কিন্তু ইমেজ কমানোর সময়, রাস্তা এবং লেবেলগুলি খুব ছোট হয়ে যায়। মোবাইল ডিভাইসে, চিত্রটি সঠিক আকারের, কিন্তু আবার, রাস্তা এবং লেবেলগুলি অপাঠ্য৷ - তৃতীয় অনুরোধটি হল
scale=2
সহ 100x100 মানচিত্র। চিত্রটি 200px বিস্তারিত সহ ফেরত দেওয়া হয়; ডেস্কটপ এটিকে নিখুঁতভাবে স্কেল করে, যাতে এটি আসল 100x100 অনুরোধ থেকে আলাদা করা যায় না, যখন মোবাইল ব্রাউজার API দ্বারা প্রত্যাবর্তিত অতিরিক্ত রেজোলিউশন থেকে উপকৃত হয়।
ইমেজ অনুরোধ | |||
---|---|---|---|
ডিভাইস | 100x100 | 200x200 | 100x100&scale=2 |
ডেস্কটপ ( height="100px" সহ এবংwidth="100px" এর উপরimg ট্যাগ) | ![]() | ![]() | ![]() |
উচ্চ রেজোলিউশন (সিমুলেটেড) | ![]() | ![]() | ![]() |
মোবাইল এবং উচ্চ রেজোলিউশন প্রদর্শনের জন্য বিকাশ সম্পর্কে আরও তথ্যের জন্য, নিম্নলিখিত পড়ার সুপারিশ করা হয়:
- অ্যান্ড্রয়েড বিকাশকারী ডকুমেন্টেশনে একাধিক স্ক্রিন সমর্থন করে ।
- হাই ডিপিআই ওয়েব সাইট তৈরির জন্য Webkit.org-এর সুপারিশ।
- iOS ডেভেলপার লাইব্রেরিতে উচ্চ-রেজোলিউশন স্ক্রীন সমর্থন করে ।
ইমেজ ফরম্যাট
ছবিগুলি বিভিন্ন সাধারণ ওয়েব গ্রাফিক্স ফর্ম্যাটে ফেরত দেওয়া যেতে পারে: GIF , JPEG এবং PNG । format
প্যারামিটার নিম্নলিখিত মানগুলির মধ্যে একটি নেয়:
-
png8
বাpng
(ডিফল্ট) 8-বিট PNG ফর্ম্যাট নির্দিষ্ট করে। -
png32
32-বিট PNG বিন্যাস নির্দিষ্ট করে। -
gif
GIF বিন্যাস নির্দিষ্ট করে। -
jpg
JPEG কম্প্রেশন বিন্যাস নির্দিষ্ট করে। -
jpg-baseline
একটি অ-প্রগতিশীল JPEG কম্প্রেশন বিন্যাস নির্দিষ্ট করে।
এই উদাহরণগুলি gif
এবং png
ফর্ম্যাটে ম্যাপের অনুরোধ করে:
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=gif&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=png&&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
jpg
এবং jpg-baseline
সাধারণত সবচেয়ে ছোট ইমেজ সাইজ প্রদান করে, যদিও তারা "ক্ষতিকর" কম্প্রেশনের মাধ্যমে তা করে যা ইমেজকে অবনমিত করতে পারে। gif
, png8
এবং png32
ক্ষতিহীন কম্প্রেশন প্রদান করে।
বেশিরভাগ JPEG ইমেজ প্রগতিশীল, যার অর্থ হল তারা একটি মোটা ইমেজ আগে লোড করে এবং আরও ডেটা আসার সাথে সাথে ছবির রেজোলিউশনকে পরিমার্জন করে। এটি ওয়েবপৃষ্ঠাগুলিতে ছবিগুলিকে দ্রুত লোড করার অনুমতি দেয় এবং বর্তমানে এটি JPEG-এর সবচেয়ে ব্যাপক ব্যবহার। যাইহোক, JPEG-এর কিছু ব্যবহারের জন্য অ-প্রগতিশীল (বেসলাইন) চিত্র প্রয়োজন। এই ধরনের ক্ষেত্রে, আপনি jpg-baseline
বিন্যাস ব্যবহার করতে চাইতে পারেন, যা অ-প্রগতিশীল।
মানচিত্র প্রকার
মানচিত্র স্ট্যাটিক API নীচে তালিকাভুক্ত বিভিন্ন বিন্যাসে মানচিত্র তৈরি করে:
-
roadmap
(ডিফল্ট) একটি আদর্শ রোডম্যাপ চিত্র নির্দিষ্ট করে, যেমনটি সাধারণত Google মানচিত্র ওয়েবসাইটে দেখানো হয়। যদি কোনোmaptype
মান নির্দিষ্ট করা না থাকে, মানচিত্র স্ট্যাটিক API ডিফল্টরূপেroadmap
টাইলস পরিবেশন করে। -
satellite
একটি স্যাটেলাইট ইমেজ নির্দিষ্ট করে। -
terrain
একটি শারীরিক ত্রাণ মানচিত্র চিত্রকে নির্দিষ্ট করে, ভূখণ্ড এবং গাছপালা দেখায়। -
hybrid
স্যাটেলাইট এবং রোডম্যাপ চিত্রের একটি হাইব্রিড নির্দিষ্ট করে, স্যাটেলাইট ছবিতে প্রধান রাস্তা এবং স্থানের নামগুলির একটি স্বচ্ছ স্তর দেখায়।
আপনি এই কোড উদাহরণে রোডম্যাপ এবং ভূখণ্ডের প্রকারের মধ্যে পার্থক্য দেখতে পারেন।
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=roadmap&key=YOUR_API_KEY&signature=YOUR_SIGNATURE https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=terrain&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
হাইব্রিড মানচিত্র একটি সমন্বয় মানচিত্র তৈরি করতে উপগ্রহ চিত্র এবং বিশিষ্ট রোডম্যাপ বৈশিষ্ট্য ব্যবহার করে। নিম্নলিখিত উদাহরণগুলি উপগ্রহ এবং হাইব্রিড মানচিত্রের প্রকারগুলি দেখায়:
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=satellite&key=YOUR_API_KEY&signature=YOUR_SIGNATURE https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=hybrid&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
স্টাইল করা মানচিত্র
আপনার নিজস্ব শৈলী প্রয়োগ করে আদর্শ Google মানচিত্রের উপস্থাপনা কাস্টমাইজ করুন। স্টাইল করা মানচিত্রের নির্দেশিকা দেখুন।
চিহ্নিতকারী
markers
প্যারামিটার অবস্থানের একটি সেটে এক বা একাধিক মার্কার (মানচিত্র পিন) এর একটি সেট সংজ্ঞায়িত করে। একটি একক markers
ঘোষণার মধ্যে সংজ্ঞায়িত প্রতিটি মার্কারকে একই ভিজ্যুয়াল শৈলী প্রদর্শন করতে হবে; আপনি যদি বিভিন্ন শৈলী সহ মার্কার প্রদর্শন করতে চান, তাহলে আপনাকে পৃথক শৈলী তথ্য সহ একাধিক markers
পরামিতি সরবরাহ করতে হবে।
markers
প্যারামিটার নিম্নলিখিত বিন্যাসের মান অ্যাসাইনমেন্ট ( মার্কার বর্ণনাকারী ) এর সেট নেয়:
markers= markerStyles | markerLocation1 | markerLocation2 |...
ইত্যাদি
মার্কার স্টাইলগুলির সেটটি markers
ঘোষণার শুরুতে ঘোষণা করা হয় এবং এতে পাইপ অক্ষর ( |
) দ্বারা পৃথক করা শূন্য বা একাধিক শৈলী বর্ণনাকারী থাকে, তারপরে এক বা একাধিক অবস্থানের একটি সেটও পাইপ অক্ষর ( |
) দ্বারা পৃথক করা হয়।
যেহেতু শৈলীর তথ্য এবং অবস্থানের তথ্য উভয়ই পাইপ অক্ষরের মাধ্যমে সীমাবদ্ধ করা হয়েছে, শৈলীর তথ্য যেকোন মার্কার বর্ণনাকারীতে প্রথমে উপস্থিত হওয়া আবশ্যক। মানচিত্র স্ট্যাটিক API সার্ভার একবার মার্কার বর্ণনাকারীতে একটি অবস্থানের সম্মুখীন হলে, অন্যান্য সমস্ত মার্কার পরামিতিগুলিকেও অবস্থান হিসাবে ধরে নেওয়া হয়।
মার্কার শৈলী
মার্কার শৈলী বর্ণনাকারীর সেটটি পাইপ ( |
) অক্ষর দ্বারা পৃথক করা মূল্য নির্ধারণের একটি সিরিজ। এই শৈলী বর্ণনাকারী এই মার্কার বর্ণনাকারীর মধ্যে মার্কারগুলি প্রদর্শন করার সময় ব্যবহার করার জন্য চাক্ষুষ বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে। এই শৈলী বর্ণনাকারীতে নিম্নলিখিত কী/মান অ্যাসাইনমেন্ট রয়েছে:
-
size:
(ঐচ্ছিক) সেট{tiny, mid, small}
থেকে চিহ্নিতকারীর আকার নির্দিষ্ট করে। যদি কোনsize
প্যারামিটার সেট না থাকে, মার্কারটি তার ডিফল্ট (স্বাভাবিক) আকারে প্রদর্শিত হবে। color:
(ঐচ্ছিক) একটি 24-বিট রঙ নির্দিষ্ট করে (উদাহরণ:color=0xFFFFCC
) বা সেট থেকে একটি পূর্বনির্ধারিত রঙ{black, brown, green, purple, yellow, blue, gray, orange, red, white}
মনে রাখবেন যে স্বচ্ছতা (32-বিট হেক্স রঙের মান ব্যবহার করে নির্দিষ্ট) মার্কারগুলিতে সমর্থিত নয়, যদিও সেগুলি পাথগুলির জন্য সমর্থিত।
-
label :
(ঐচ্ছিক) সেট {AZ, 0-9} থেকে একটি একক বড় হাতের বর্ণসংখ্যার অক্ষর নির্দিষ্ট করে৷ (এপিআই-এর এই সংস্করণে বড় হাতের অক্ষরের জন্য প্রয়োজনীয়তা নতুন।) মনে রাখবেন যে ডিফল্ট এবংmid
আকারের মার্কারই একমাত্র মার্কার যা একটিalphanumeric-character
পরামিতি প্রদর্শন করতে সক্ষম।tiny
এবংsmall
মার্কার একটি বর্ণসংখ্যা-অক্ষর প্রদর্শন করতে সক্ষম নয়।
মার্কার স্কেলিং
পিক্সেলে মার্কারের প্রকৃত আউটপুট আকার তৈরি করতে scale
মানকে মার্কার চিত্রের আকারের সাথে গুণ করা হয়। ডিফল্ট স্কেল মান 1; গৃহীত মান হল 1, 2, এবং 4।
স্কেলিং প্রয়োগ করার পরে চিত্রগুলিতে পিক্সেল আকারের সীমা প্রযোজ্য। উদাহরণস্বরূপ, যদি মার্কারটি scale:2
এ সেট করা থাকে, তাহলে মার্কারটি 4096 পিক্সেলের সর্বাধিক আকারের চেয়ে বড় হতে পারে, যতক্ষণ না এটি স্কেলিং করার পরে 4096 পিক্সেলের কম হয়ে যায়। উচ্চ-রেজোলিউশন মানচিত্র প্রদর্শন করার সময় মানচিত্র স্কেলিং এর সাথে মার্কার স্কেলিং ব্যবহার করুন।
চিহ্নিতকারী অবস্থান
প্রতিটি মার্কার বর্ণনাকারীতে অবশ্যই এক বা একাধিক অবস্থানের একটি সেট থাকতে হবে যা মানচিত্রে চিহ্নিতকারীকে কোথায় রাখতে হবে তা নির্ধারণ করে। এই অবস্থানগুলি হয় অক্ষাংশ/দ্রাঘিমাংশের মান হিসাবে বা ঠিকানা হিসাবে নির্দিষ্ট করা যেতে পারে। এই অবস্থানগুলি পাইপ অক্ষর ( |
) ব্যবহার করে পৃথক করা হয়।
দ্রষ্টব্য : আপনি যদি জিওকোডিং প্রয়োজন এমন একটি পদ্ধতি ব্যবহার করে মার্কার অবস্থানগুলি নির্দিষ্ট করতে বেছে নেন, যেমন মানব-পাঠযোগ্য ঠিকানা স্ট্রিং বা পলিলাইন, অনুরোধটি সর্বাধিক 15টি চিহ্নিতকারীর মধ্যে সীমাবদ্ধ। এই সীমাটি শুধুমাত্র মার্কার অবস্থানগুলির জন্য প্রযোজ্য যেগুলির জন্য জিওকোডিং প্রয়োজন৷ এটি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সাথে নির্দিষ্ট মার্কার অবস্থানগুলিতে প্রযোজ্য নয়৷
অবস্থানের পরামিতি মানচিত্রে চিহ্নিতকারীর অবস্থান নির্ধারণ করে। যদি অবস্থানটি মানচিত্রের বাইরে থাকে, তবে center
এবং zoom
পরামিতি সরবরাহ করা হলে সেই মার্কারটি নির্মিত চিত্রটিতে প্রদর্শিত হবে না। যাইহোক, যদি এই প্যারামিটারগুলি সরবরাহ করা না হয়, তাহলে মানচিত্র স্ট্যাটিক API সার্ভার স্বয়ংক্রিয়ভাবে একটি চিত্র তৈরি করবে যাতে সরবরাহকৃত মার্কার রয়েছে৷ ( ইমপ্লিসিট পজিশনিং দেখুন।)
একটি নমুনা মার্কার ঘোষণা এখানে দেখানো হয়েছে. মনে রাখবেন যে আমরা শৈলীর একটি সেট এবং তিনটি অবস্থান সংজ্ঞায়িত করি:
https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&size=400x400& markers=color:blue%7Clabel:S%7C11211%7C11206%7C11222&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
বিভিন্ন শৈলী সহ মার্কার সংজ্ঞায়িত করতে, আমাদের একাধিক markers
পরামিতি সরবরাহ করতে হবে। markers
প্যারামিটারের এই সেটটি তিনটি চিহ্নিতকারীকে সংজ্ঞায়িত করে: একটি নীল মার্কার 62.107733-এ "S" লেবেলযুক্ত, -145.5419, "ডেল্টা জংশন, AK" এ একটি ক্ষুদ্র সবুজ মার্কার এবং "Tok, AK" এ "C" লেবেলযুক্ত একটি মাঝারি আকারের হলুদ মার্কার। " এই মার্কারগুলি এই উদাহরণে দেখানো হয়েছে:
https://maps.googleapis.com/maps/api/staticmap?center=63.259591,-144.667969&zoom=6&size=400x400 &markers=color:blue%7Clabel:S%7C62.107733,-145.541936&markers=size:tiny%7Ccolor:green%7CDelta+Junction,AK &markers=size:mid%7Ccolor:0xFFFF00%7Clabel:C%7CTok,AK"&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
কাস্টম আইকন
Google এর মার্কার আইকনগুলি ব্যবহার করার পরিবর্তে, আপনি পরিবর্তে আপনার নিজস্ব কাস্টম আইকনগুলি ব্যবহার করতে পারবেন৷ markers
প্যারামিটারে icon
বর্ণনাকারী ব্যবহার করে কাস্টম আইকনগুলি নির্দিষ্ট করা হয়। যেমন:
markers=icon: URLofIcon | markerLocation
একটি URL ব্যবহার করে icon
নির্দিষ্ট করুন (যা URL-এনকোড করা উচিত)। আপনি https://goo.gl
এর মতো URL-সংক্ষিপ্তকরণ পরিষেবাগুলির দ্বারা তৈরি URLগুলি ব্যবহার করতে পারেন৷ বেশিরভাগ ইউআরএল-সংক্ষিপ্তকরণ পরিষেবার স্বয়ংক্রিয়ভাবে ইউআরএল এনকোড করার সুবিধা রয়েছে।
আপনি কাস্টম আইকনের জন্য একটি অ্যাঙ্কর পয়েন্ট নির্দিষ্ট করতে পারেন। নোঙ্গর পয়েন্ট নির্দিষ্ট markers
অবস্থানের সাথে আইকন কিভাবে স্থাপন করা হয় তা সেট করে। ডিফল্টরূপে, একটি কাস্টম আইকনের অ্যাঙ্কর পয়েন্ট হল আইকন ছবির নীচের কেন্দ্রে৷ আপনি আপনার icon
সাথে একত্রে anchor
বর্ণনাকারী ব্যবহার করে একটি ভিন্ন অ্যাঙ্কর পয়েন্ট নির্দিষ্ট করতে পারেন। anchor
আইকনের একটি x,y বিন্দু হিসাবে সেট করুন (যেমন 10,5
), বা নিম্নলিখিত মানগুলির মধ্যে একটি ব্যবহার করে পূর্বনির্ধারিত প্রান্তিককরণ হিসাবে: top
, bottom
, left
, right
, center
, topleft
, topright
, bottomleft
বা bottomright
. যেমন:
markers=anchor:bottomright|icon: URLofIcon | markerLocation1 | markerLocation2
আপনি প্রতি অনুরোধে পাঁচটি পর্যন্ত অনন্য কাস্টম আইকন ব্যবহার করতে পারেন। এই সীমাবদ্ধতার মানে এই নয় যে আপনি আপনার মানচিত্রে শুধুমাত্র 5টি চিহ্নিত স্থানে সীমাবদ্ধ। প্রতিটি অনন্য আইকন আপনার মানচিত্রে একাধিক markers
অবস্থানের সাথে ব্যবহার করা যেতে পারে।
আইকন বিন্যাস:
- আইকন চিত্রগুলি PNG, JPEG বা GIF ফর্ম্যাটে হতে পারে, যদিও PNG সুপারিশ করা হয়৷
- আইকনগুলি সর্বাধিক 4096 পিক্সেল আকারের হতে পারে (বর্গাকার চিত্রগুলির জন্য 64x64)।
কাস্টম আইকন উদাহরণ
উদাহরণ 1 কাস্টম আইকন তৈরি করে এবং অ্যাঙ্কর ব্যবহার করে আইকনগুলিকে অবস্থান করে।
https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on &style=feature:water%7Celement:geometry%7Cvisibility:on &style=feature:landscape%7Celement:geometry%7Cvisibility:on &markers=anchor:32,10%7Cicon:https://goo.gl/5y3S82%7CCanberra+ACT &markers=anchor:topleft%7Cicon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC &markers=anchor:topright%7Cicon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY &signature=YOUR_SIGNATURE
উদাহরণ 2 উদাহরণ 1 হিসাবে একই কাস্টম আইকন তৈরি করে, কিন্তু নীচের কেন্দ্রের ডিফল্ট অ্যাঙ্করের উপর নির্ভর করে অ্যাঙ্কর ব্যবহার করে আইকনের অবস্থানগুলি সেট করে না।
https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on &style=feature:water%7Celement:geometry%7Cvisibility:on &style=feature:landscape%7Celement:geometry%7Cvisibility:on &markers=icon:https://goo.gl/5y3S82%7CCanberra+ACT &markers=icon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC &markers=icon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
মানচিত্র স্ট্যাটিক API পাথ
path
প্যারামিটার মানচিত্র চিত্রে ওভারলে করার জন্য একটি পাথ দ্বারা সংযুক্ত এক বা একাধিক অবস্থানের একটি সেট সংজ্ঞায়িত করে৷ path
প্যারামিটারটি নিম্নলিখিত বিন্যাসের মান অ্যাসাইনমেন্টের ( পাথ বর্ণনাকারী ) সেট নেয়:
path= pathStyles | pathLocation1 | pathLocation2 |...
ইত্যাদি
নোট করুন যে উভয় পাথ পয়েন্ট পাইপ অক্ষর ( |
) ব্যবহার করে একে অপরের থেকে পৃথক করা হয়েছে। যেহেতু শৈলী তথ্য এবং পয়েন্ট তথ্য উভয়ই পাইপ অক্ষরের মাধ্যমে সীমাবদ্ধ করা হয়েছে, শৈলী তথ্য যেকোন পথ বর্ণনাকারীতে প্রথমে উপস্থিত হওয়া আবশ্যক। একবার মানচিত্র স্ট্যাটিক API সার্ভার পাথ বর্ণনাকারীতে একটি অবস্থানের মুখোমুখি হলে, অন্যান্য সমস্ত পাথ প্যারামিটারগুলিকেও অবস্থান হিসাবে ধরে নেওয়া হয়।
পাথ শৈলী
পাথ শৈলী বর্ণনাকারীর সেটটি পাইপ ( |
) অক্ষর দ্বারা পৃথক করা মূল্য নির্ধারণের একটি সিরিজ। এই শৈলী বর্ণনাকারী পাথ প্রদর্শন করার সময় ব্যবহার করার জন্য চাক্ষুষ বৈশিষ্ট্য সংজ্ঞায়িত করে। এই শৈলী বর্ণনাকারীতে নিম্নলিখিত কী/মান অ্যাসাইনমেন্ট রয়েছে:
-
weight:
(ঐচ্ছিক) পিক্সেলে পথের পুরুত্ব নির্দিষ্ট করে। যদি কোনweight
প্যারামিটার সেট করা না থাকে, পাথটি তার ডিফল্ট বেধে (5 পিক্সেল) প্রদর্শিত হবে। color:
(ঐচ্ছিক) একটি 24-বিট (উদাহরণ:color=0xFFFFCC
) বা 32-বিট হেক্সাডেসিমেল মান হিসাবে নির্দিষ্ট করে (উদাহরণ:color=0xFFFFCCFF
), বা সেট থেকে{black, brown, green, purple, yellow, blue, gray, orange, red, white}
।যখন একটি 32-বিট হেক্স মান নির্দিষ্ট করা হয়, শেষ দুটি অক্ষর 8-বিট আলফা স্বচ্ছতার মান নির্দিষ্ট করে। এই মান
00
(সম্পূর্ণ স্বচ্ছ) এবংFF
(সম্পূর্ণ অস্বচ্ছ) এর মধ্যে পরিবর্তিত হয়। মনে রাখবেন যে স্বচ্ছতাগুলি পাথগুলিতে সমর্থিত, যদিও সেগুলি মার্কারগুলির জন্য সমর্থিত নয়৷-
fillcolor :
(ঐচ্ছিক) উভয়ই নির্দেশ করে যে পথটি একটি বহুভুজ এলাকাকে চিহ্নিত করে এবং সেই এলাকার মধ্যে একটি ওভারলে হিসাবে ব্যবহার করার জন্য ভরাট রঙ নির্দিষ্ট করে। নিম্নলিখিত অবস্থানগুলির সেট একটি "বন্ধ" লুপ হতে হবে না; মানচিত্র স্ট্যাটিক API সার্ভার স্বয়ংক্রিয়ভাবে প্রথম এবং শেষ পয়েন্টে যোগদান করবে। উল্লেখ্য, যাইহোক, আপনি নির্দিষ্টভাবে একই প্রারম্ভ এবং শেষ অবস্থান প্রদান না করা পর্যন্ত ভরাট এলাকার বাইরের অংশে যে কোনো স্ট্রোক বন্ধ করা হবে না। -
geodesic :
(ঐচ্ছিক) নির্দেশ করে যে অনুরোধ করা পথটিকে একটি জিওডেসিক লাইন হিসাবে ব্যাখ্যা করা উচিত যা পৃথিবীর বক্রতা অনুসরণ করে। মিথ্যা হলে, পাথটি স্ক্রীন স্পেসে একটি সরল রেখা হিসাবে রেন্ডার করা হয়। ডিফল্ট থেকে মিথ্যা.
কিছু উদাহরণ পাথ সংজ্ঞা:
- পাতলা নীল রেখা, 50% অস্বচ্ছতা:
path=color:0x0000ff80|weight:1
- কঠিন লাল রেখা:
path=color:0xff0000ff|weight:5
- কঠিন পুরু সাদা লাইন:
path=color:0xffffffff|weight:10
এই পথ শৈলী ঐচ্ছিক. যদি ডিফল্ট অ্যাট্রিবিউট পছন্দ হয়, আপনি পাথ অ্যাট্রিবিউটের সংজ্ঞা এড়িয়ে যেতে পারেন; সেই ক্ষেত্রে, প্রথম ঘোষিত বিন্দু (অবস্থান) এর পরিবর্তে পাথ বর্ণনাকারীর প্রথম "আর্গুমেন্ট" থাকবে।
পাথ পয়েন্ট
একটি পাথ আঁকার জন্য, path
প্যারামিটারটি অবশ্যই দুই বা ততোধিক পয়েন্ট অতিক্রম করতে হবে। মানচিত্র স্ট্যাটিক API তারপর নির্দিষ্ট ক্রমে সেই বিন্দুগুলির সাথে পাথকে সংযুক্ত করবে। |
পাথপয়েন্ট | (পাইপ) চরিত্র।
নিম্নলিখিত উদাহরণটি ইউনিয়ন স্কয়ার NY থেকে টাইমস স্কোয়ার, NY পর্যন্ত ডিফল্ট 50% অপাসিটি সহ একটি নীল পথকে সংজ্ঞায়িত করে৷
path
প্যারামিটারের সুনির্দিষ্ট বৈশিষ্ট্যগুলি হল:
path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397
নিম্নলিখিত উদাহরণটি 100% অস্বচ্ছতার সাথে একটি কঠিন লাল রেখা সংজ্ঞায়িত করার পরিবর্তে একই পথকে সংজ্ঞায়িত করে:
এই path
প্যারামিটারের সুনির্দিষ্ট বৈশিষ্ট্য হল:
path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397
পরবর্তী উদাহরণটি ম্যানহাটনের মধ্যে একটি বহুভুজ এলাকাকে সংজ্ঞায়িত করে, অবস্থান হিসাবে ছেদগুলির একটি সিরিজ অতিক্রম করেছে:
এই path
প্যারামিটারের সুনির্দিষ্ট বৈশিষ্ট্য হল:
path=color:0x00000000|weight:5|fillcolor:0xFFFF0033|8th+Avenue+%26+34th+St,New+York,NY|\ 8th+Avenue+%26+42nd+St,New+York,NY|Park+Ave+%26+42nd+St,New+York,NY,NY|\ Park+Ave+%26+34th+St,New+York,NY,NY
মনে রাখবেন যে আমরা পথটিকেই অদৃশ্য এবং বহুভুজ এলাকাটিকে 15% অস্বচ্ছতার জন্য সেট করেছি।
এনকোডেড পলিলাইন
অবস্থানের একটি সিরিজের পরিবর্তে, আপনি path
অবস্থান ঘোষণার মধ্যে enc:
উপসর্গ ব্যবহার করে একটি এনকোডেড পলিলাইন হিসাবে একটি পথ ঘোষণা করতে পারেন।
নিম্নলিখিত উদাহরণে ডসন ক্রিক, BC থেকে ডেল্টা জংশন, AK পর্যন্ত একটি এনকোডেড পলিলাইন সহ আলাস্কা হাইওয়ের গতিপথের রূপরেখা দেওয়া হয়েছে:
https://maps.googleapis.com/maps/api/staticmap ?size=400x400¢er=59.900503,-135.478011&zoom=4 &path=weight:3%7Ccolor:orange%7Cenc:_fisIp~u%7CU}%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA}f[roaAynd@%7CvXxiAt{ZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k{g@i`]o%7CF}vXaj\h`]ovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh`]v%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez\_{Km_`@~re@ew^rcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr{ZlwBrvdAmtHrmT{rOt{Zz}E%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@``NrfQpcHrb^k%7CDh_z@nwB%7Ckb@a{R%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY}t]huf@e%7CFria@o}GfezAkdW%7C}[ocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C`l@uoJrvdAgq@fppAsjGhg`@%7ChQpg{Ai_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C}[mv`@t_NitSfjp@c}Mhg`@sbChyYq}e@rwg@atFff}@ghN~zKybk@fl}A}cPftcAite@tmT__Lha@u~DrfQi}MhkSqyWivIumCria@ciO_tHifm@fl}A{rc@fbjAqvg@rrqAcjCf%7Ci@mqJtb^s%7C@fbjA{wDfs`BmvEfqs@umWt_Nwn^pen@qiBr`xAcvMr{Zidg@dtjDkbM%7Cd_@ &key=YOUR_API_KEY&signature=YOUR_SIGNATURE
স্ট্যান্ডার্ড পাথের মতো, এনকোড করা পলিলাইন পাথগুলিও বহুভুজ এলাকা সীমাবদ্ধ করতে পারে যদি একটি fillcolor
আর্গুমেন্ট path
প্যারামিটারে পাস করা হয়।
নিম্নলিখিত উদাহরণটি ব্রুকলিন, এনওয়াই-এর জন্য একটি বহুভুজ এলাকাকে রূপরেখা দেয়:
https://maps.googleapis.com/maps/api/staticmap ?size=400x400¢er=40.653279,-73.959816&zoom=11 &path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:}zswFtikbMjJzZ%7CRdPfZ}DxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz@bIx{A%7CPfYlvApz@bl@tcAdTpGpVwQtX}i@%7CGen@lCeAda@bjA%60q@v}@rfAbjA%7CEwBpbAd_@he@hDbu@uIzWcWtZoTdImTdIwu@tDaOXw_@fc@st@~VgQ%7C[uPzNtA%60LlEvHiYyLs^nPhCpG}SzCNwHpz@cEvXg@bWdG%60]lL~MdTmEnCwJ[iJhOae@nCm[%60Aq]qE_pAaNiyBuDurAuB }}Ay%60@%7CEKv_@?%7C[qGji@lAhYyH%60@Xiw@tBerAs@q]jHohAYkSmW?aNoaAbR}LnPqNtMtIbRyRuDef@eT_z@mW_Nm%7CB~j@zC~hAyUyJ_U{Z??cPvg@}s@sHsc@_z@cj@kp@YePoNyYyb@_iAyb@gBw^bOokArcA}GwJuzBre@i\tf@sZnd@oElb@hStW{]vv@??kz@~vAcj@zKa%60Atf@uQj_Aee@pU_UrcA &key=YOUR_API_KEY&signature=YOUR_SIGNATURE
ভিউপোর্ট
চিত্রগুলি visible
প্যারামিটার ব্যবহার করে দৃশ্যমান অবস্থানগুলি নির্দিষ্ট করে একটি ভিউপোর্ট নির্দিষ্ট করতে পারে৷ visible
প্যারামিটার মানচিত্র স্ট্যাটিক API পরিষেবাকে এমন একটি মানচিত্র তৈরি করার নির্দেশ দেয় যাতে বিদ্যমান অবস্থানগুলি দৃশ্যমান থাকে। (এই প্যারামিটারটি একটি দৃশ্যমান অঞ্চলকেও সংজ্ঞায়িত করার জন্য বিদ্যমান মার্কার বা পাথগুলির সাথে মিলিত হতে পারে।) এইভাবে একটি ভিউপোর্ট সংজ্ঞায়িত করা একটি সঠিক জুম স্তর নির্দিষ্ট করার প্রয়োজনীয়তাকে বাধা দেয়।
পরবর্তী উদাহরণে Boston, MA কেন্দ্রিক একটি মানচিত্রের অনুরোধ করা হয়েছে যেখানে কেমব্রিজ, MA-তে MIT এবং হার্ভার্ড স্কোয়ার উভয়ই রয়েছে:
https://maps.googleapis.com/maps/api/staticmap?center=Boston,MA &visible=77+Massachusetts+Ave,Cambridge,MA%7CHarvard+Square,Cambridge,MA&size=512x512&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
মানচিত্রের অন্তর্নিহিত অবস্থান
সাধারণত, আপনার তৈরি করা মানচিত্রের অবস্থান এবং জুম স্তর নির্ধারণ করতে আপনাকে center
এবং zoom
URL প্যারামিটারগুলি নির্দিষ্ট করতে হবে। যাইহোক, আপনি যদি markers
, path
বা visible
পরামিতি সরবরাহ করেন, তাহলে আপনি এর পরিবর্তে মানচিত্র স্ট্যাটিক এপিআইকে সঠিক কেন্দ্র এবং জুম স্তর নির্ণয় করতে দিতে পারেন, এই উপাদানগুলির অবস্থানের মূল্যায়নের উপর ভিত্তি করে।
যদি দুই বা ততোধিক উপাদান সরবরাহ করা হয়, মানচিত্র স্ট্যাটিক API একটি সঠিক কেন্দ্র এবং জুম স্তর নির্ধারণ করবে, এতে থাকা উপাদানগুলির জন্য উদার মার্জিন প্রদান করবে। এই উদাহরণটি সান ফ্রান্সিসকো, ওকল্যান্ড এবং সান জোসে, CA সম্বলিত একটি মানচিত্র প্রদর্শন করে:
https://maps.googleapis.com/maps/api/staticmap?size=512x512&maptype=roadmap\ &markers=size:mid%7Ccolor:red%7CSan+Francisco,CA%7COakland,CA%7CSan+Jose,CA&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
বড় ইমেজ মাপ
আপনার যদি 640 x 640 পিক্সেল (বা 2 এর স্কেল মান সহ 1280 x 1280 পিক্সেল) এর চেয়ে বড় আকারের চিত্রের প্রয়োজন হয়, তাহলে অনুগ্রহ করে সহায়তা দলের সাথে যোগাযোগ করুন এবং নিম্নলিখিত তথ্য সরবরাহ করুন:
- আপনার ব্যবহারের ক্ষেত্রে এবং কেন আপনার বড় আকারের ছবি দরকার।
- আপনি অন্য Google মানচিত্র প্ল্যাটফর্ম API (মানচিত্র জাভাস্ক্রিপ্ট এপিআই, মানচিত্র এম্বেড এপিআই, অ্যান্ড্রয়েডের জন্য মানচিত্র SDK, বা iOS এর জন্য মানচিত্র SDK) ব্যবহার করার কথা বিবেচনা করছেন কিনা এবং কেন সেগুলি আপনার চাহিদা পূরণ করে না৷
- আপনি কীভাবে বড় আকারের ছবি ব্যবহার করবেন তার স্ক্রিনশট, উপহাস বা নমুনা।
- বড় আকারের ছবির জন্য আপনার আনুমানিক মাসিক ব্যবহার।
আপনার দেওয়া তথ্যের ভিত্তিতে আমরা আপনার অনুরোধ পর্যালোচনা করব এবং আপনার ব্যবহারের ক্ষেত্রে Google মানচিত্র প্ল্যাটফর্ম পরিষেবার শর্তাবলী মেনে চলছে কিনা তা নির্ধারণ করব।
আমরা যে সর্বোচ্চ আকার দিতে পারি তা হল 2048 x 2048 পিক্সেল।
সমস্যা সমাধান এবং সমর্থন
মানচিত্র স্ট্যাটিক API ব্যবহার সম্পর্কে আরও তথ্যের জন্য, সমর্থন পৃষ্ঠাটি দেখুন।
কিছু ভুল হলে মানচিত্র স্ট্যাটিক API একটি ত্রুটি বা সতর্কতা জারি করতে পারে। আপনি যদি মানচিত্র থেকে কিছু অনুপস্থিত লক্ষ্য করেন তবে বিশেষ করে সতর্কতার জন্য পরীক্ষা করা উচিত। একটি নতুন অ্যাপ্লিকেশন চালু করার আগে সতর্কতাগুলি পরীক্ষা করাও একটি ভাল ধারণা৷ নোট করুন যে সতর্কতাগুলি অবিলম্বে স্পষ্ট নাও হতে পারে কারণ সেগুলি HTTP হেডারে উপস্থিত হয়৷ আরও তথ্যের জন্য, ত্রুটি এবং সতর্কতা নির্দেশিকা দেখুন।