ভূমিকা
মানচিত্র স্ট্যাটিক 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") বা একটি স্ট্রিং ঠিকানা (যেমন "সিটি হল, নিউ ইয়র্ক, নিউ ইয়র্ক") হিসাবে একটি অবস্থান নেয় পৃথিবী. আরও তথ্যের জন্য, অবস্থান দেখুন। -
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 হেডারে উপস্থিত হয়৷ আরও তথ্যের জন্য, ত্রুটি এবং সতর্কতা নির্দেশিকা দেখুন।
,ভূমিকা
মানচিত্র স্ট্যাটিক API একটি URL এর মাধ্যমে একটি HTTP অনুরোধের প্রতিক্রিয়া হিসাবে একটি চিত্র (হয় GIF, PNG বা JPEG) প্রদান করে৷ প্রতিটি অনুরোধের জন্য, আপনি মানচিত্রের অবস্থান, চিত্রের আকার, জুম স্তর, মানচিত্রের ধরন এবং মানচিত্রের অবস্থানগুলিতে ঐচ্ছিক মার্কার স্থাপন করতে পারেন৷ আপনি অতিরিক্তভাবে আলফানিউমেরিক অক্ষর ব্যবহার করে আপনার মার্কারগুলিকে লেবেল করতে পারেন।
একটি মানচিত্র স্ট্যাটিক এপিআই চিত্রটি <img>
ট্যাগের src
বৈশিষ্ট্যের মধ্যে এম্বেড করা আছে, বা অন্যান্য প্রোগ্রামিং ভাষায় এর সমতুল্য।
এই দস্তাবেজটি মানচিত্রের স্ট্যাটিক এপিআই ইউআরএল এবং উপলভ্য পরামিতিগুলির প্রয়োজনীয় ফর্ম্যাটটি বর্ণনা করে। এটি আপনার ইউআরএলগুলি নির্দিষ্ট করার জন্য কিছু টিপস এবং কৌশলগুলিও নির্দেশ করে।
তুমি শুরু করার আগে
এই দস্তাবেজটি ওয়েবসাইট এবং মোবাইল বিকাশকারীদের জন্য তৈরি করা হয়েছে যারা কোনও ওয়েবপৃষ্ঠা বা মোবাইল অ্যাপ্লিকেশনটিতে মানচিত্র স্ট্যাটিক এপিআই চিত্রগুলি অন্তর্ভুক্ত করতে চান। এটি উপলভ্য পরামিতিগুলিতে এপিআই এবং রেফারেন্স উপাদানগুলি ব্যবহার করার একটি ভূমিকা সরবরাহ করে।
আপনি মানচিত্র স্ট্যাটিক এপিআই দিয়ে বিকাশ শুরু করার আগে, প্রমাণীকরণের প্রয়োজনীয়তাগুলি পর্যালোচনা করুন (আপনার একটি এপিআই কী দরকার) এবং এপিআই ব্যবহার এবং বিলিং তথ্য (আপনার প্রকল্পে আপনাকে বিলিং সক্ষম করতে হবে)।
URL প্যারামিটার
একটি মানচিত্র স্ট্যাটিক এপিআই ইউআরএল অবশ্যই নিম্নলিখিত ফর্মের হতে হবে:
https://maps.googleapis.com/maps/api/staticmap?parameters
যদি আপনার ওয়েবসাইটটি এইচটিটিপিএসের মাধ্যমে অ্যাক্সেস করা হয় তবে ব্রাউজার সুরক্ষা সতর্কতাগুলি এড়ানোর জন্য আপনাকে অবশ্যই এইচটিটিপিএসের উপরে মানচিত্র স্ট্যাটিক এপিআই চিত্রগুলি লোড করতে হবে। আপনার অনুরোধগুলিতে সংবেদনশীল ব্যবহারকারীর তথ্য যেমন কোনও ব্যবহারকারীর অবস্থান অন্তর্ভুক্ত থাকে তবে এইচটিটিপিএসও সুপারিশ করা হয়:
https://maps.googleapis.com/maps/api/staticmap?parameters
এইচটিটিপি বা এইচটিটিপিএস ব্যবহার করুন না কেন, নির্দিষ্ট URL পরামিতিগুলির প্রয়োজন হয় যখন কিছু al চ্ছিক। ইউআরএলগুলিতে যেমন স্ট্যান্ডার্ড, সমস্ত পরামিতিগুলি এম্পারস্যান্ড ( &
) চরিত্রটি ব্যবহার করে পৃথক করা হয়। প্যারামিটারগুলির তালিকা এবং তাদের সম্ভাব্য মানগুলি এই নথিতে গণনা করা হয়।
মানচিত্র স্ট্যাটিক এপিআই নিম্নলিখিত ইউআরএল প্যারামিটারগুলি ব্যবহার করে মানচিত্রের চিত্রগুলি সংজ্ঞায়িত করে:
অবস্থান পরামিতি
-
center
(যদি চিহ্নিতকারীরা উপস্থিত না থাকে তবে প্রয়োজনীয় ) মানচিত্রের কেন্দ্রটি সংজ্ঞায়িত করে, মানচিত্রের সমস্ত প্রান্ত থেকে সমান। এই প্যারামিটারটি একটি কমা-বিচ্ছিন্ন {অক্ষাংশ, দ্রাঘিমাংশ} জুটি (যেমন "40.714728, -73.998672") বা একটি স্ট্রিং ঠিকানা (যেমন "সিটি হল, নিউ ইয়র্ক, এনওয়াই") হিসাবে একটি অবস্থান গ্রহণ করে পৃথিবী. আরও তথ্যের জন্য, অবস্থানগুলি দেখুন। -
zoom
(যদি চিহ্নিতকারীরা উপস্থিত না থাকে তবে প্রয়োজনীয় ) মানচিত্রের জুম স্তরটি সংজ্ঞায়িত করে, যা মানচিত্রের ম্যাগনিফিকেশন স্তর নির্ধারণ করে। এই প্যারামিটারটি পছন্দসই অঞ্চলের জুম স্তরের সাথে সম্পর্কিত একটি সংখ্যাসূচক মান নেয়। আরও তথ্যের জন্য, জুম স্তরগুলি দেখুন।
মানচিত্র পরামিতি
-
size
( প্রয়োজনীয় ) মানচিত্রের চিত্রের আয়তক্ষেত্রাকার মাত্রাগুলি সংজ্ঞায়িত করে। এই প্যারামিটারটি ফর্ম{horizontal_value} x {vertical_value}
এর একটি স্ট্রিং নেয়} উদাহরণস্বরূপ,500x400
একটি মানচিত্র 500 পিক্সেল প্রশস্ত 400 পিক্সেল উচ্চ দ্বারা সংজ্ঞায়িত করে। প্রস্থে 180 পিক্সেলের চেয়ে কম মানচিত্রগুলি হ্রাস-আকারের গুগল লোগো প্রদর্শন করবে। এই প্যারামিটারটিscale
প্যারামিটার দ্বারা প্রভাবিত হয়; চূড়ান্ত আউটপুট আকার আকার এবং স্কেল মানগুলির পণ্য। -
scale
( al চ্ছিক ) ফিরে আসা পিক্সেলের সংখ্যা প্রভাবিত করে।scale=2
একই কভারেজ অঞ্চল এবং বিশদের স্তর ধরে রাখার সময়scale=1
এর চেয়ে দ্বিগুণ পিক্সেল ফেরত দেয় (অর্থাত্ মানচিত্রের বিষয়বস্তু পরিবর্তন হয় না)। উচ্চ-রেজোলিউশন ডিসপ্লেগুলির জন্য বিকাশ করার সময় এটি কার্যকর। ডিফল্ট মান হল1
। স্বীকৃত মানগুলি1
এবং2
হয়। আরও তথ্যের জন্য স্কেল মান দেখুন। -
format
( al চ্ছিক ) ফলাফলের চিত্রের ফর্ম্যাটটি সংজ্ঞায়িত করে। ডিফল্টরূপে, মানচিত্র স্ট্যাটিক এপিআই পিএনজি চিত্র তৈরি করে। জিআইএফ, জেপিইজি এবং পিএনজি প্রকার সহ বেশ কয়েকটি সম্ভাব্য ফর্ম্যাট রয়েছে। আপনি কোন ফর্ম্যাটটি ব্যবহার করেন তা নির্ভর করে আপনি কীভাবে চিত্রটি উপস্থাপন করতে চান। জেপিইজি সাধারণত বৃহত্তর সংক্ষেপণ সরবরাহ করে, যখন জিআইএফ এবং পিএনজি আরও বেশি বিশদ সরবরাহ করে। আরও তথ্যের জন্য, চিত্রের ফর্ম্যাটগুলি দেখুন। -
maptype
( al চ্ছিক ) নির্মাণের জন্য মানচিত্রের ধরণটি সংজ্ঞায়িত করে।roadmap
,satellite
,hybrid
এবংterrain
সহ বেশ কয়েকটি সম্ভাব্য ম্যাপটাইপ মান রয়েছে। আরও তথ্যের জন্য, মানচিত্রগুলি স্ট্যাটিক এপিআই ম্যাপটাইপস দেখুন। -
language
( al চ্ছিক ) মানচিত্রের টাইলগুলিতে লেবেল প্রদর্শনের জন্য ব্যবহারের জন্য ভাষাটি সংজ্ঞায়িত করে। নোট করুন যে এই প্যারামিটারটি কেবল কিছু দেশের টাইলগুলির জন্য সমর্থিত; যদি অনুরোধ করা নির্দিষ্ট ভাষাটি টাইল সেটটির জন্য সমর্থিত না হয় তবে সেই টাইলসেটের জন্য ডিফল্ট ভাষা ব্যবহার করা হবে। -
region
( al চ্ছিক ) ভূ-রাজনৈতিক সংবেদনশীলতার উপর ভিত্তি করে প্রদর্শনের জন্য উপযুক্ত সীমানাগুলি সংজ্ঞায়িত করে। দ্বি-চরিত্রের সিসিটিএলডি ('শীর্ষ-স্তরের ডোমেন') মান হিসাবে নির্দিষ্ট একটি অঞ্চল কোড গ্রহণ করে। সমর্থিত অঞ্চলগুলির জন্য গুগল ম্যাপস প্ল্যাটফর্মের কভারেজের বিশদটি দেখুন।
বৈশিষ্ট্য পরামিতি
-
map_id
( al চ্ছিক ) একটি নির্দিষ্ট মানচিত্রের জন্য সনাক্তকারী নির্দিষ্ট করে। মানচিত্রের আইডি একটি নির্দিষ্ট স্টাইল বা বৈশিষ্ট্যের সাথে একটি মানচিত্রের সাথে যুক্ত করে এবং অবশ্যই মানচিত্রটি আরম্ভ করতে ব্যবহৃত এপিআই কী হিসাবে একই প্রকল্পের অন্তর্ভুক্ত। আরও তথ্যের জন্য, এমএপি আইডি ব্যবহার করে দেখুন। -
markers
( al চ্ছিক ) নির্দিষ্ট স্থানে চিত্রের সাথে সংযুক্ত করতে এক বা একাধিক চিহ্নিতকারীকে সংজ্ঞায়িত করে। এই প্যারামিটারটি পাইপ চরিত্র (|
) দ্বারা পৃথক করা পরামিতিগুলির সাথে একটি একক চিহ্নিতকারী সংজ্ঞা নেয়। একাধিক চিহ্নিতকারী একই স্টাইলটি প্রদর্শন না করে একইmarkers
প্যারামিটারের মধ্যে স্থাপন করা যেতে পারে; আপনি অতিরিক্ত চিহ্নিতকারী পরামিতি যুক্ত করে পৃথক শৈলীর অতিরিক্তmarkers
যুক্ত করতে পারেন। মনে রাখবেন যে আপনি যদি কোনও মানচিত্রের জন্য চিহ্নিতকারী সরবরাহ করেন তবে আপনাকে (সাধারণত প্রয়োজনীয়)center
এবংzoom
পরামিতি নির্দিষ্ট করার দরকার নেই। আরও তথ্যের জন্য, মানচিত্রগুলি স্ট্যাটিক এপিআই চিহ্নিতকারীগুলি দেখুন। -
path
( al চ্ছিক ) নির্দিষ্ট স্থানে চিত্রটিতে ওভারলে করার জন্য দুটি বা ততোধিক সংযুক্ত পয়েন্টগুলির একক পথকে সংজ্ঞায়িত করে। এই প্যারামিটারটি পাইপ চরিত্র (|
) দ্বারা পৃথক করা পয়েন্ট সংজ্ঞাগুলির একটি স্ট্রিং নেয়, বা একটি এনকোডেড পললাইন ব্যবহার করেenc:
পথের অবস্থান ঘোষণার মধ্যে উপসর্গ। আপনি অতিরিক্তpath
পরামিতি যুক্ত করে অতিরিক্ত পাথ সরবরাহ করতে পারেন। মনে রাখবেন যে আপনি যদি কোনও মানচিত্রের জন্য কোনও পথ সরবরাহ করেন তবে আপনাকে (সাধারণত প্রয়োজনীয়)center
এবংzoom
পরামিতি নির্দিষ্ট করার দরকার নেই। আরও তথ্যের জন্য, মানচিত্রগুলি স্ট্যাটিক এপিআই পাথগুলি দেখুন। -
visible
( al চ্ছিক ) এক বা একাধিক অবস্থান নির্দিষ্ট করে যা মানচিত্রে দৃশ্যমান থাকা উচিত, যদিও কোনও চিহ্নিতকারী বা অন্যান্য সূচক প্রদর্শিত হবে না। মানচিত্রের স্ট্যাটিক এপিআই -তে প্রদর্শিত হয়েছে এমন নির্দিষ্ট বৈশিষ্ট্য বা মানচিত্রের অবস্থানগুলি নিশ্চিত করতে এই প্যারামিটারটি ব্যবহার করুন। -
style
( al চ্ছিক ) মানচিত্রের একটি নির্দিষ্ট বৈশিষ্ট্য (রাস্তা, পার্ক এবং অন্যান্য বৈশিষ্ট্য) উপস্থাপনা পরিবর্তন করতে একটি কাস্টম শৈলী সংজ্ঞায়িত করে। এই প্যারামিটারটি স্টাইলের বৈশিষ্ট্যগুলি চিহ্নিত করেfeature
এবংelement
যুক্তিগুলি এবং নির্বাচিত বৈশিষ্ট্যগুলিতে প্রয়োগ করার জন্য স্টাইল অপারেশনগুলির একটি সেট নেয়। আপনি অতিরিক্তstyle
পরামিতি যুক্ত করে একাধিক স্টাইল সরবরাহ করতে পারেন। আরও তথ্যের জন্য, স্টাইলযুক্ত মানচিত্রের গাইড দেখুন।
কী এবং স্বাক্ষর পরামিতি
-
key
( প্রয়োজনীয় ) আপনাকে গুগল ক্লাউড কনসোলে আপনার অ্যাপ্লিকেশনটির এপিআই ব্যবহার পর্যবেক্ষণ করতে দেয় এবং নিশ্চিত করে যে গুগল আপনার প্রয়োজনে আপনার অ্যাপ্লিকেশন সম্পর্কে আপনার সাথে যোগাযোগ করতে পারে। আরও তথ্যের জন্য, মানচিত্র স্ট্যাটিক এপিআই সহ এপিআই কীগুলি ব্যবহার করুন দেখুন। -
signature
( প্রস্তাবিত ) হ'ল একটি ডিজিটাল স্বাক্ষর যা আপনার এপিআই কী ব্যবহার করে যে কোনও সাইট উত্পন্ন অনুরোধগুলি এটি করার জন্য অনুমোদিত তা যাচাই করতে ব্যবহৃত হয়। ডিজিটাল স্বাক্ষর ছাড়াই অনুরোধগুলি ব্যর্থ হতে পারে। আরও তথ্যের জন্য, একটি ডিজিটাল স্বাক্ষর ব্যবহার করুন দেখুন।
ইউআরএল আকারের সীমাবদ্ধতা
মানচিত্র স্ট্যাটিক এপিআই ইউআরএলগুলি আকারে 16384 অক্ষরে সীমাবদ্ধ। অনুশীলনে, আপনার সম্ভবত এর চেয়ে বেশি আর ইউআরএলগুলির প্রয়োজন হবে না, যদি না আপনি উচ্চ সংখ্যক চিহ্নিতকারী এবং পাথ সহ জটিল মানচিত্র উত্পাদন করেন।
প্যারামিটার ব্যবহার
মানচিত্রের স্ট্যাটিক এপিআই ব্যবহার করা তুলনামূলকভাবে সহজ, কারণ এটি কেবলমাত্র প্যারামিটারাইজড ইউআরএল নিয়ে গঠিত। এই বিভাগটি কীভাবে আপনার ইউআরএলগুলি তৈরি করতে এই পরামিতিগুলি ব্যবহার করবেন তা ব্যাখ্যা করে।
অবস্থান নির্দিষ্ট করা
মানচিত্রের স্ট্যাটিক এপিআই অবশ্যই মানচিত্রের অবস্থানগুলি সঠিকভাবে সনাক্ত করতে সক্ষম হতে হবে, উভয়ই মানচিত্রকে সঠিক স্থানে ফোকাস করতে ( center
প্যারামিটার ব্যবহার করে) এবং/অথবা মানচিত্রের অবস্থানগুলিতে কোনও al চ্ছিক প্লেসমার্ক ( markers
প্যারামিটার ব্যবহার করে) স্থাপন করতে সক্ষম হতে হবে। মানচিত্র স্ট্যাটিক এপিআই এই অবস্থানগুলি নির্দিষ্ট করতে সংখ্যা (অক্ষাংশ এবং দ্রাঘিমাংশ মান) বা স্ট্রিং (ঠিকানা) ব্যবহার করে। এই মানগুলি একটি জিওকোডেড অবস্থান সনাক্ত করে।
বেশ কয়েকটি পরামিতি (যেমন markers
এবং path
পরামিতি) একাধিক অবস্থান নেয়। এই ক্ষেত্রে, অবস্থানগুলি পাইপ ( |
) চরিত্র দ্বারা পৃথক করা হয়।
অক্ষাংশ এবং দ্রাঘিমাংশ
অক্ষাংশ এবং দ্রাঘিমাংশগুলি কমা-বিচ্ছিন্ন পাঠ্য স্ট্রিংয়ের মধ্যে সংখ্যা ব্যবহার করে সংজ্ঞায়িত করা হয় যা 6 দশমিক স্থানে যথার্থতা রয়েছে। উদাহরণস্বরূপ, "40.714728, -73.998672" একটি বৈধ জিওকোড মান। 6 দশমিক স্থানের বাইরে যথার্থতা উপেক্ষা করা হয়।
দ্রাঘিমাংশের মানগুলি ইংল্যান্ডের গ্রিনিচ, প্রাইম মেরিডিয়ানের বাড়ি থেকে তাদের দূরত্বের উপর ভিত্তি করে। গ্রিনউইচ যেহেতু 51.477222 অক্ষাংশে অবস্থিত, তাই আমরা গ্রিনউইচের মানচিত্রটি কেন্দ্র করতে 51.477222,0
এর center
মান প্রবেশ করতে পারি:
অক্ষাংশ এবং দ্রাঘিমাংশ মানগুলি অবশ্যই পৃথিবীর মুখের একটি বৈধ অবস্থানের সাথে সামঞ্জস্য করতে হবে। অক্ষাংশগুলি -90
এবং 90
এর মধ্যে কোনও মান নিতে পারে যখন দ্রাঘিমাংশ মানগুলি -180
এবং 180
এর মধ্যে কোনও মান নিতে পারে। আপনি যদি কোনও অবৈধ অক্ষাংশ বা দ্রাঘিমাংশের মান নির্দিষ্ট করেন তবে আপনার অনুরোধটি খারাপ অনুরোধ হিসাবে প্রত্যাখ্যান করা হবে।
ঠিকানা
বেশিরভাগ লোক অক্ষাংশ এবং দ্রাঘিমাংশে কথা বলে না; তারা ঠিকানা ব্যবহার করে অবস্থানগুলি বোঝায়। কোনও ঠিকানাটিকে ভৌগলিক পয়েন্টে পরিণত করার প্রক্রিয়াটি জিওকোডিং হিসাবে পরিচিত এবং মানচিত্রের স্ট্যাটিক এপিআই পরিষেবা যদি আপনি বৈধ ঠিকানা সরবরাহ করেন তবে আপনার জন্য জিওকোডিং সম্পাদন করতে পারে।
যে কোনও প্যারামিটারে যেখানে আপনি একটি অক্ষাংশ/দ্রাঘিমাংশ সরবরাহ করতে পারেন, আপনি পরিবর্তে কোনও ঠিকানা নির্দেশ করে একটি স্ট্রিং নির্দিষ্ট করতে পারেন। গুগল ঠিকানাটি জিওকোড করবে এবং ম্যাপস স্ট্যাটিক এপিআই পরিষেবাটিকে চিহ্নিতকারী স্থাপন বা অবস্থান নির্দিষ্ট করার ক্ষেত্রে ব্যবহার করার জন্য একটি অক্ষাংশ/দ্রাঘিমাংশ মান সহ মানচিত্রের স্ট্যাটিক এপিআই পরিষেবা সরবরাহ করবে। স্ট্রিংটি ইউআরএল-এনকোড করা উচিত, সুতরাং "সিটি হল, নিউ ইয়র্ক, এনওয়াই" এর মতো ঠিকানাগুলি উদাহরণস্বরূপ "সিটি+হল, নিউ+ইয়র্ক, এনওয়াই" তে রূপান্তরিত করা উচিত।
দ্রষ্টব্য যে ঠিকানাগুলি উভয়ই সুনির্দিষ্ট অবস্থানগুলি যেমন রাস্তার ঠিকানাগুলি, নামযুক্ত রুটের মতো পলিনগুলি বা শহর, দেশ বা জাতীয় উদ্যানের মতো বহুভুজ অঞ্চলগুলি প্রতিফলিত করতে পারে। পলিলিনিয়ার এবং বহুভুজ ফলাফলের জন্য, মানচিত্র স্ট্যাটিক এপিআই সার্ভারটি লাইন/অঞ্চলটির কেন্দ্র পয়েন্টটি ঠিকানা কেন্দ্র হিসাবে ব্যবহার করবে। কোনও ঠিকানা কীভাবে জিওকোড হতে পারে সে সম্পর্কে আপনার যদি সন্দেহ থাকে তবে আপনি এই জিওকোডিং ইউটিলিটিটি ব্যবহার করে ঠিকানাটি পরীক্ষা করতে পারেন।
নিম্নলিখিত উদাহরণটি বার্কলে, সিএর জন্য একটি স্ট্যাটিক মানচিত্রের চিত্র উত্পন্ন করে:
https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
জুম স্তর
গুগল মানচিত্রে মানচিত্রে একটি পূর্ণসংখ্যা 'জুম স্তর' রয়েছে যা বর্তমান দৃশ্যের রেজোলিউশনকে সংজ্ঞায়িত করে। 0
(সর্বনিম্ন জুম স্তর, যেখানে পুরো বিশ্বকে একটি মানচিত্রে দেখা যায়) এর মধ্যে জুম স্তর এবং 21+
(নীচে রাস্তায় এবং পৃথক বিল্ডিংগুলিতে) ডিফল্ট roadmap
দৃশ্যের মধ্যে সম্ভব। বিল্ডিংয়ের রূপরেখা, যেখানে পাওয়া যায়, জুম স্তর 17
এর চারপাশে মানচিত্রে উপস্থিত হয়। এই মানটি অঞ্চল থেকে পৃথক হয় এবং ডেটা বিকশিত হওয়ার সাথে সাথে সময়ের সাথে সাথে পরিবর্তিত হতে পারে।
গুগল ম্যাপগুলি পুরো পৃথিবীকে ঘিরে রাখতে জুম স্তর 0
সেট করে। প্রতিটি সফল জুম স্তর অনুভূমিক এবং উল্লম্ব উভয় মাত্রায় যথার্থতা দ্বিগুণ করে। এটি কীভাবে করা হয় সে সম্পর্কে আরও তথ্য গুগল ম্যাপস জাভাস্ক্রিপ্ট এপিআই ডকুমেন্টেশনে উপলব্ধ।
দ্রষ্টব্য: সমস্ত জুম স্তর পৃথিবীর সমস্ত স্থানে উপস্থিত হয় না। জুমের স্তরগুলি অবস্থানের উপর নির্ভর করে পরিবর্তিত হয়, কারণ বিশ্বের কিছু অংশের ডেটা অন্যান্য অবস্থানের চেয়ে বেশি দানাদার।
আপনি যদি কোনও জুম স্তরের জন্য কোনও অনুরোধ প্রেরণ করেন যেখানে কোনও মানচিত্রের টাইলস নেই, তবে মানচিত্রের স্ট্যাটিক এপিআই পরিবর্তে একটি ফাঁকা চিত্র ফিরিয়ে দেবে।
নিম্নলিখিত তালিকাটি প্রতিটি জুম স্তরে আপনি দেখতে আশা করতে পারেন তার আনুমানিক স্তরটি দেখায়:
- 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
চিত্রের আকার
center
সাথে একত্রে size
প্যারামিটারটি কোনও মানচিত্রের কভারেজ অঞ্চলকে সংজ্ঞায়িত করে। এটি পিক্সেলগুলিতে মানচিত্রের আউটপুট আকারকেও সংজ্ঞায়িত করে, যখন 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 পিক্সেল আকারের একটি ছোট মানচিত্রের জন্য অনুরোধ করে। ছোট গুগল লোগোটি নোট করুন:
https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=100x100&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
স্কেল মান
মানচিত্রের স্ট্যাটিক এপিআইয়ের size
প্যারামিটারটি পিক্সেলগুলিতে একটি মানচিত্রের আকার নির্ধারণ করে, যাতে size=200x200
সহ একটি মানচিত্র 200 পিক্সেল দ্বারা 200 পিক্সেল হিসাবে ফিরে আসে। একটি এলসিডি কম্পিউটার মনিটরে, যা সাধারণত প্রতি ইঞ্চি (পিপিআই) প্রায় 100 পিক্সেল প্রদর্শন করে, একটি 200x200 মানচিত্র প্রতিটি মাত্রায় প্রায় 2 ইঞ্চি হবে।
যাইহোক, মোবাইল ডিভাইসগুলি ক্রমবর্ধমানভাবে 300ppi এর বেশি পিক্সেল ঘনত্ব সহ উচ্চ রেজোলিউশন স্ক্রিনগুলি অন্তর্ভুক্ত করে, যা হয়:
- 200x200 পিক্সেল চিত্রের আকারটি একটি ইঞ্চির মাত্র 0.7 এ হ্রাস করুন, রেন্ডারিং লেবেল এবং আইকনগুলি পড়ার জন্য খুব ছোট; বা
- স্কেল (জুম) চিত্রটি সুস্পষ্টতা উন্নত করার জন্য, ফলস্বরূপ একটি অস্পষ্ট বা পিক্সেলেটেড চিত্রের ফলস্বরূপ।
খুব ছোট | খুব অস্পষ্ট |
---|---|
মোবাইল ডিভাইসের জন্য বিকাশ করার সময়, আপনি উপরের সমস্যাগুলি সমাধান করে এমন উচ্চ-রেজোলিউশন মানচিত্রের চিত্রগুলি ফিরিয়ে দিতে এপিআইয়ের scale
প্যারামিটারটি ব্যবহার করতে পারেন। মানচিত্রের কভারেজ অঞ্চল পরিবর্তন না করে পিক্সেলগুলিতে চিত্রের প্রকৃত আউটপুট আকার নির্ধারণ করতে scale
মানটি size
সাথে গুণিত হয়। ডিফল্ট scale
মান 1; স্বীকৃত মানগুলি 1 এবং 2 হয়।
উদাহরণস্বরূপ, 2 এর একটি স্কেল মান একই মানচিত্রের কভারেজ অঞ্চলটি কোনও স্কেল নির্দিষ্ট না করে অনুরোধ হিসাবে ফিরিয়ে দেবে, তবে প্রতিটি মাত্রায় দ্বিগুণ পিক্সেল সহ। এর মধ্যে রাস্তা এবং লেবেল অন্তর্ভুক্ত রয়েছে, যাতে তারা উচ্চ রেজোলিউশন, ছোট আকারের স্ক্রিনগুলির পাশাপাশি ব্রাউজার দ্বারা স্কেল করা হয়।
150x150 | 150x150 & স্কেল = 2 |
---|---|
সিএসএস ব্যবহার করে উচ্চতা এবং প্রস্থ সেট সহ কোনও img
বা div
ট্যাগে প্রবেশ করলে এই জাতীয় চিত্রটি ডেস্কটপ ব্রাউজারগুলিতেও ভাল পারফর্ম করবে। ব্রাউজারটি মানের ক্ষতি ছাড়াই চিত্রটিকে সঠিক আকারে ডাউনসাইজ করবে।
এই টেবিলটি তিনটি পৃথক চিত্রের অনুরোধ দেখায়।
- প্রথমটি 100x100 চিত্রের জন্য, কোনও স্কেল মান নির্দিষ্ট করা হয়নি। এটি ডেস্কটপে সঠিকভাবে প্রদর্শিত হয় তবে মোবাইল ডিভাইসে পড়তে খুব ছোট।
- দ্বিতীয়টি মানচিত্রের আকার দ্বিগুণ করে। ডেস্কটপে, সিএসএস এটিকে নির্দিষ্ট 100x100
img
উপাদানগুলিতে ফিট করে তবে চিত্রটি ডাউনসাইজ করার ক্ষেত্রে, রাস্তাগুলি এবং লেবেলগুলি খুব ছোট হয়ে যায়। মোবাইল ডিভাইসে, চিত্রটি সঠিক আকার, তবে আবার রাস্তা এবং লেবেলগুলি অযৌক্তিক। - তৃতীয় অনুরোধটি
scale=2
সহ 100x100 মানচিত্রের জন্য। চিত্রটি 200px বিশদ দিয়ে ফিরে আসে; ডেস্কটপ এটিকে পুরোপুরি স্কেল করে, যাতে এটি মূল 100x100 অনুরোধ থেকে পৃথক পৃথক হয়, যখন মোবাইল ব্রাউজারটি এপিআই দ্বারা ফিরে আসা অতিরিক্ত রেজোলিউশন থেকে উপকৃত হয়।
ইমেজ অনুরোধ | |||
---|---|---|---|
যন্ত্র | 100x100 | 200x200 | 100x100&scale=2 |
ডেস্কটপ ( height="100px" এবংwidth="100px" img ট্যাগ) | |||
উচ্চ রেজল্যুশন (সিমুলেটেড) |
মোবাইল এবং উচ্চ রেজোলিউশন প্রদর্শনগুলির জন্য বিকাশ সম্পর্কে আরও তথ্যের জন্য, নিম্নলিখিত পাঠটি প্রস্তাবিত:
- অ্যান্ড্রয়েড বিকাশকারী ডকুমেন্টেশনে একাধিক স্ক্রিন সমর্থন করে ।
- উচ্চ ডিপিআই ওয়েব সাইটগুলি বিকাশের জন্য ওয়েবকিট.অর্গের সুপারিশগুলি।
- আইওএস বিকাশকারী লাইব্রেরিতে উচ্চ-রেজোলিউশন স্ক্রিনগুলিকে সমর্থন করে ।
ইমেজ ফরম্যাট
চিত্রগুলি বেশ কয়েকটি সাধারণ ওয়েব গ্রাফিক্স ফর্ম্যাটে ফিরে আসতে পারে: জিআইএফ , জেপিজি এবং পিএনজি । format
প্যারামিটারটি নিম্নলিখিত মানগুলির একটি নেয়:
-
png8
বাpng
(ডিফল্ট) 8-বিট পিএনজি ফর্ম্যাট নির্দিষ্ট করে। -
png32
32-বিট পিএনজি ফর্ম্যাটটি নির্দিষ্ট করে। -
gif
জিআইএফ ফর্ম্যাট নির্দিষ্ট করে। -
jpg
জেপিইজি সংক্ষেপণ বিন্যাস নির্দিষ্ট করে। -
jpg-baseline
একটি অ-প্রগতিশীল জেপিইজি সংক্ষেপণ ফর্ম্যাট নির্দিষ্ট করে।
এই উদাহরণগুলি 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
ক্ষতিহীন সংক্ষেপণ সরবরাহ করে।
বেশিরভাগ জেপিইজি চিত্রগুলি প্রগতিশীল, যার অর্থ তারা আগে একটি মোটা চিত্র লোড করে এবং আরও ডেটা আসার সাথে সাথে চিত্রের রেজোলিউশনটি পরিমার্জন করে। এটি চিত্রগুলি ওয়েবপৃষ্ঠায় দ্রুত লোড করার অনুমতি দেয় এবং বর্তমানে জেপিইজি -র সর্বাধিক বিস্তৃত ব্যবহার। তবে, জেপিইজি-র কিছু ব্যবহারের জন্য অ-প্রগতিশীল (বেসলাইন) চিত্রগুলির প্রয়োজন। এই জাতীয় ক্ষেত্রে, আপনি jpg-baseline
ফর্ম্যাটটি ব্যবহার করতে চাইতে পারেন, যা অ-প্রগতিশীল।
মানচিত্রের ধরণ
মানচিত্র স্ট্যাটিক এপিআই নীচে তালিকাভুক্ত বিভিন্ন ফর্ম্যাটে মানচিত্র তৈরি করে:
-
roadmap
(ডিফল্ট) একটি স্ট্যান্ডার্ড রোডম্যাপ চিত্র নির্দিষ্ট করে, যেমনটি সাধারণত গুগল ম্যাপস ওয়েবসাইটে প্রদর্শিত হয়। যদি কোনওmaptype
মান নির্দিষ্ট না করা হয়, মানচিত্র স্ট্যাটিক এপিআই ডিফল্টরূপে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
স্টাইলযুক্ত মানচিত্র
আপনার নিজস্ব শৈলী প্রয়োগ করে স্ট্যান্ডার্ড গুগল মানচিত্রের উপস্থাপনাটি কাস্টমাইজ করুন। স্টাইলযুক্ত মানচিত্রের গাইড দেখুন।
চিহ্নিতকারী
markers
প্যারামিটারটি অবস্থানের একটি সেটে এক বা একাধিক চিহ্নিতকারী (মানচিত্রের পিন) এর একটি সেট সংজ্ঞায়িত করে। একক markers
ঘোষণার মধ্যে সংজ্ঞায়িত প্রতিটি চিহ্নিতকারীকে অবশ্যই একই ভিজ্যুয়াল স্টাইল প্রদর্শন করতে হবে; আপনি যদি বিভিন্ন শৈলীর সাথে চিহ্নিতকারীগুলি প্রদর্শন করতে চান তবে আপনাকে পৃথক স্টাইলের তথ্য সহ একাধিক markers
পরামিতি সরবরাহ করতে হবে।
markers
প্যারামিটারটি নিম্নলিখিত ফর্ম্যাটটির মান অ্যাসাইনমেন্ট ( চিহ্নিতকারী বর্ণনাকারী ) সেট করে:
markers= markerStyles | markerLocation1 | markerLocation2 |...
ইত্যাদি
মার্কারস্টিলসের সেটটি markers
ঘোষণার শুরুতে ঘোষণা করা হয় এবং পাইপ চরিত্র ( |
) দ্বারা পৃথক শূন্য বা একাধিক স্টাইলের বর্ণনাকারী সমন্বিত থাকে, তারপরে পাইপ চরিত্র ( |
) দ্বারা পৃথক করা এক বা একাধিক অবস্থানের একটি সেট থাকে।
যেহেতু উভয় স্টাইলের তথ্য এবং অবস্থানের তথ্য পাইপ চরিত্রের মাধ্যমে সীমিত করা হয়েছে, স্টাইলের তথ্য অবশ্যই কোনও চিহ্নিতকারী বর্ণনাকারীর মধ্যে উপস্থিত থাকতে হবে। একবার মানচিত্র স্ট্যাটিক এপিআই সার্ভারটি চিহ্নিতকারী বর্ণনাকারীর কোনও অবস্থানের মুখোমুখি হয়ে গেলে, অন্যান্য সমস্ত চিহ্নিতকারী পরামিতিগুলিও অবস্থান হিসাবে ধরে নেওয়া হয়।
চিহ্নিতকারী শৈলী
মার্কার স্টাইলের বর্ণনাকারীদের সেটটি পাইপ ( |
) চরিত্র দ্বারা পৃথক করা মান অ্যাসাইনমেন্টগুলির একটি সিরিজ। এই স্টাইলের বর্ণনাকারী এই চিহ্নিতকারী বর্ণনাকারীর মধ্যে চিহ্নিতকারীগুলি প্রদর্শন করার সময় ব্যবহারের জন্য ভিজ্যুয়াল বৈশিষ্ট্যগুলি সংজ্ঞায়িত করে। এই স্টাইলের বর্ণনাতে নিম্নলিখিত কী/মান কার্যভার রয়েছে:
-
size:
(al চ্ছিক) সেট{tiny, mid, small}
থেকে চিহ্নিতকারীটির আকার নির্দিষ্ট করে} যদি কোনওsize
প্যারামিটার সেট না থাকে তবে চিহ্নিতকারীটি তার ডিফল্ট (স্বাভাবিক) আকারে উপস্থিত হবে। color:
(al চ্ছিক) একটি 24-বিট রঙ নির্দিষ্ট করে (উদাহরণ:color=0xFFFFCC
) বা সেট থেকে একটি পূর্বনির্ধারিত রঙ{black, brown, green, purple, yellow, blue, gray, orange, red, white}
নোট করুন যে ট্রান্সপারেন্সিগুলি (32-বিট হেক্স রঙের মান ব্যবহার করে নির্দিষ্ট করা) চিহ্নিতকারীগুলিতে সমর্থিত নয়, যদিও সেগুলি পাথের জন্য সমর্থিত।
-
label :
(al চ্ছিক) সেট {এজেড, 0-9} থেকে একটি একক বড় হাতের আলফানিউমেরিক চরিত্র নির্দিষ্ট করে} (বড় হাতের অক্ষরগুলির জন্য প্রয়োজনীয়তা এপিআইয়ের এই সংস্করণে নতুন)) নোট করুন যে ডিফল্ট এবংmid
আকারের চিহ্নিতকারীরা একমাত্র চিহ্নিতকারী যা একটিalphanumeric-character
প্যারামিটার প্রদর্শন করতে সক্ষম।tiny
এবংsmall
চিহ্নিতকারীগুলি একটি আলফানিউমেরিক-চরিত্র প্রদর্শন করতে সক্ষম নয়।
চিহ্নিতকারী স্কেলিং
পিক্সেলগুলিতে চিহ্নিতকারীটির প্রকৃত আউটপুট আকার উত্পাদন করতে scale
মানটি চিহ্নিতকারী চিত্রের আকারের সাথে গুণিত হয়। ডিফল্ট স্কেল মান 1; স্বীকৃত মানগুলি 1, 2 এবং 4 হয়।
স্কেলিং প্রয়োগের পরে চিত্রগুলিতে পিক্সেল আকারের সীমা প্রযোজ্য। উদাহরণস্বরূপ, যদি চিহ্নিতকারীটি scale:2
এ সেট করা থাকে তবে চিহ্নিতকারীটি 4096 পিক্সেলের সর্বাধিক আকারের চেয়ে বড় হতে পারে, যতক্ষণ না এটি স্কেলিংয়ের পরে 4096 পিক্সেলের চেয়ে কম হ্রাস পায়। উচ্চ-রেজোলিউশন মানচিত্র প্রদর্শন করার সময় মানচিত্রের স্কেলিংয়ের সাথে একত্রে মার্কার স্কেলিং ব্যবহার করুন।
চিহ্নিতকারী অবস্থান
প্রতিটি চিহ্নিতকারী বর্ণনাকারীর অবশ্যই মানচিত্রে চিহ্নিতকারীটি কোথায় রাখতে হবে তা নির্ধারণ করে এক বা একাধিক অবস্থানের একটি সেট থাকতে হবে। এই অবস্থানগুলি হয় অক্ষাংশ/দ্রাঘিমাংশ মান হিসাবে বা ঠিকানা হিসাবে নির্দিষ্ট করা যেতে পারে। এই অবস্থানগুলি পাইপ চরিত্র ( |
) ব্যবহার করে পৃথক করা হয়।
দ্রষ্টব্য : আপনি যদি জিওকোডিংয়ের প্রয়োজন এমন একটি পদ্ধতি ব্যবহার করে চিহ্নিতকারী অবস্থানগুলি নির্দিষ্ট করে বেছে নেন, যেমন মানব-পঠনযোগ্য ঠিকানা স্ট্রিং বা পলিনাইনগুলি, অনুরোধটি সর্বোচ্চ 15 চিহ্নিতকারীদের মধ্যে সীমাবদ্ধ। এই সীমাটি কেবলমাত্র চিহ্নিতকারী অবস্থানগুলিতে প্রযোজ্য যা জিওকোডিংয়ের প্রয়োজন। এটি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সাথে নির্দিষ্ট চিহ্নিতকারী অবস্থানের ক্ষেত্রে প্রযোজ্য নয়।
অবস্থানের পরামিতিগুলি মানচিত্রে চিহ্নিতকারীটির অবস্থান নির্ধারণ করে। যদি অবস্থানটি মানচিত্রের বাইরে থাকে তবে সেই চিহ্নিতকারীটি নির্মিত চিত্রটিতে উপস্থিত হবে না তবে সরবরাহ করা হয় যে center
এবং zoom
পরামিতি সরবরাহ করা হয়। তবে, যদি এই পরামিতিগুলি সরবরাহ না করা হয় তবে মানচিত্র স্ট্যাটিক এপিআই সার্ভার স্বয়ংক্রিয়ভাবে একটি চিত্র তৈরি করবে যাতে সরবরাহিত চিহ্নিতকারী রয়েছে। ( অন্তর্নিহিত অবস্থান দেখুন।)
একটি নমুনা চিহ্নিতকারী ঘোষণা এখানে দেখানো হয়েছে। নোট করুন যে আমরা স্টাইলের একটি সেট এবং তিনটি অবস্থান সংজ্ঞায়িত করি:
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, -145.5419, "ডেল্টা জংশন, একে" এর একটি ছোট সবুজ চিহ্নিতকারী, এবং একটি মাঝারি আকারের হলুদ চিহ্নিতকারী "সি" লেবেলযুক্ত "টোক, আক, আক, আক, আক, আক, আক, আক, আক, আক, আক, আক, আক, আক, আক, আক, এক " এই চিহ্নিতকারীগুলি এই উদাহরণে দেখানো হয়েছে:
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
কাস্টম আইকন
গুগলের চিহ্নিতকারী আইকনগুলি ব্যবহার করার পরিবর্তে, আপনি পরিবর্তে নিজের কাস্টম আইকনগুলি ব্যবহার করতে পারেন। কাস্টম আইকনগুলি markers
প্যারামিটারে icon
বর্ণনাকারী ব্যবহার করে নির্দিষ্ট করা হয়। উদাহরণ স্বরূপ:
markers=icon: URLofIcon | markerLocation
একটি ইউআরএল ব্যবহার করে icon
নির্দিষ্ট করুন (যা ইউআরএল-এনকোড করা উচিত)। আপনি URL- সংক্ষিপ্তকরণ পরিষেবা যেমন https://goo.gl
দ্বারা নির্মিত ইউআরএল ব্যবহার করতে পারেন। বেশিরভাগ ইউআরএল-সংক্ষিপ্তকরণ পরিষেবাগুলিতে স্বয়ংক্রিয়ভাবে এনকোডিংয়ের ইউআরএলগুলির সুবিধা রয়েছে।
আপনি কাস্টম আইকনের জন্য একটি অ্যাঙ্কর পয়েন্ট নির্দিষ্ট করতে পারেন। অ্যাঙ্কর পয়েন্টটি নির্দিষ্ট markers
অবস্থানের সাথে কীভাবে আইকনটি স্থাপন করা হয় তা সেট করে। ডিফল্টরূপে, কাস্টম আইকনের অ্যাঙ্কর পয়েন্টটি আইকন চিত্রের নীচের কেন্দ্র। আপনি আপনার icon
সাথে একত্রে anchor
বর্ণনাকারী ব্যবহার করে একটি আলাদা অ্যাঙ্কর পয়েন্ট নির্দিষ্ট করতে পারেন। আইকনটির এক্স, ওয়াই পয়েন্ট হিসাবে anchor
সেট করুন (যেমন 10,5
), বা নিম্নলিখিত মানগুলির মধ্যে একটি ব্যবহার করে পূর্বনির্ধারিত প্রান্তিককরণ হিসাবে: top
, bottom
, left
, right
, center
, topleft
, topright
, বা bottomright
bottomleft
. উদাহরণ স্বরূপ:
markers=anchor:bottomright|icon: URLofIcon | markerLocation1 | markerLocation2
আপনি অনুরোধ অনুযায়ী পাঁচটি অনন্য কাস্টম আইকন ব্যবহার করতে পারেন। এই সীমাবদ্ধতার অর্থ এই নয় যে আপনি আপনার মানচিত্রে কেবল 5 টি চিহ্নিত স্থানে সীমাবদ্ধ। প্রতিটি অনন্য আইকনটি আপনার মানচিত্রে একাধিক markers
অবস্থানের সাথে ব্যবহার করা যেতে পারে।
আইকন বিন্যাস:
- আইকন চিত্রগুলি পিএনজি, জেপিইজি বা জিআইএফ ফর্ম্যাটে থাকতে পারে, যদিও পিএনজি প্রস্তাবিত।
- আইকনগুলি 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
স্ট্যাটিক এপিআই পাথ মানচিত্র
path
প্যারামিটারটি মানচিত্রের চিত্রটিতে ওভারলে করার পথ দ্বারা সংযুক্ত এক বা একাধিক অবস্থানের একটি সেটকে সংজ্ঞায়িত করে। path
প্যারামিটারটি নিম্নলিখিত ফর্ম্যাটটির মান অ্যাসাইনমেন্ট ( পাথ বর্ণনাকারী ) সেট করে:
path= pathStyles | pathLocation1 | pathLocation2 |...
ইত্যাদি
নোট করুন যে উভয় পাথ পয়েন্টগুলি পাইপ চরিত্র ( |
) ব্যবহার করে একে অপরের থেকে পৃথক করা হয়েছে। যেহেতু উভয় স্টাইলের তথ্য এবং পয়েন্ট তথ্য পাইপ চরিত্রের মাধ্যমে সীমিত করা হয়েছে, স্টাইলের তথ্য অবশ্যই কোনও পথ বর্ণনাকারীর মধ্যে উপস্থিত থাকতে হবে। মানচিত্রের স্ট্যাটিক এপিআই সার্ভারটি একবার পাথ বর্ণনাকারীর কোনও অবস্থানের মুখোমুখি হয়ে গেলে, অন্যান্য সমস্ত পথের পরামিতিগুলিও অবস্থান হিসাবে ধরে নেওয়া হয়।
পথ শৈলী
পাথ স্টাইলের বর্ণনাকারীদের সেটটি পাইপ ( |
) চরিত্র দ্বারা পৃথক করা মান অ্যাসাইনমেন্টগুলির একটি সিরিজ। এই স্টাইলের বর্ণনাকারী পথটি প্রদর্শন করার সময় ব্যবহারের জন্য ভিজ্যুয়াল বৈশিষ্ট্যগুলি সংজ্ঞায়িত করে। এই স্টাইলের বর্ণনাতে নিম্নলিখিত কী/মান কার্যভার রয়েছে:
-
weight:
(al চ্ছিক) পিক্সেলের পথের বেধ নির্দিষ্ট করে। যদি কোনওweight
প্যারামিটার সেট না করা হয় তবে পথটি তার ডিফল্ট বেধে প্রদর্শিত হবে (5 পিক্সেল)। color:
(al চ্ছিক) 24-বিট (উদাহরণ:color=0xFFFFCC
) বা 32-বিট হেক্সাডেসিমাল মান (উদাহরণ:color=0xFFFFCCFF
) হিসাবে একটি রঙ নির্দিষ্ট করে, বা সেট থেকে{black, brown, green, purple, yellow, blue, gray, orange, red, white}
যখন একটি 32-বিট হেক্স মান নির্দিষ্ট করা হয়, শেষ দুটি অক্ষর 8-বিট আলফা স্বচ্ছতার মান নির্দিষ্ট করে। এই মানটি
00
(সম্পূর্ণ স্বচ্ছ) এবংFF
(সম্পূর্ণ অস্বচ্ছ) এর মধ্যে পরিবর্তিত হয়। নোট করুন যে ট্রান্সপারেন্সিগুলি পথগুলিতে সমর্থিত, যদিও তারা চিহ্নিতকারীদের জন্য সমর্থিত নয়।-
fillcolor :
(al চ্ছিক) উভয়কেই ইঙ্গিত করে যে পথটি বহুভুজ অঞ্চল থেকে চিহ্নিত করে এবং সেই অঞ্চলের মধ্যে ওভারলে হিসাবে ব্যবহার করার জন্য ফিল রঙটি নির্দিষ্ট করে। নিম্নলিখিত অবস্থানের সেটগুলির সেটটি "বদ্ধ" লুপ হওয়ার দরকার নেই; মানচিত্র স্ট্যাটিক এপিআই সার্ভার স্বয়ংক্রিয়ভাবে প্রথম এবং শেষ পয়েন্টগুলিতে যোগদান করবে। তবে নোট করুন যে, আপনি যদি বিশেষভাবে একই শুরু এবং শেষের অবস্থান সরবরাহ করেন তবে ভরাট অঞ্চলের বাইরের কোনও স্ট্রোক বন্ধ হবে না। -
geodesic :
(al চ্ছিক) ইঙ্গিত দেয় যে অনুরোধ করা পথটি জিওডেসিক লাইন হিসাবে ব্যাখ্যা করা উচিত যা পৃথিবীর বক্রতা অনুসরণ করে। যখন মিথ্যা হয়, পথটি স্ক্রিন স্পেসে একটি সরল রেখা হিসাবে রেন্ডার করা হয়। ডিফল্ট থেকে মিথ্যা.
কিছু উদাহরণ পাথ সংজ্ঞা:
- পাতলা নীল রেখা, 50% অস্বচ্ছতা:
path=color:0x0000ff80|weight:1
- সলিড রেড লাইন:
path=color:0xff0000ff|weight:5
- সলিড ঘন সাদা রেখা:
path=color:0xffffffff|weight:10
এই পাথ শৈলী al চ্ছিক। যদি ডিফল্ট বৈশিষ্ট্যগুলি পছন্দসই হয় তবে আপনি পথের বৈশিষ্ট্যগুলি সংজ্ঞায়িত করতে পারেন; সেক্ষেত্রে পাথ বর্ণনাকারীর প্রথম "আর্গুমেন্ট" প্রথম ঘোষিত পয়েন্ট (অবস্থান) এর পরিবর্তে গঠিত হবে।
পাথ পয়েন্ট
কোনও পথ আঁকতে, path
প্যারামিটারটি অবশ্যই দুই বা ততোধিক পয়েন্ট পাস করতে হবে। মানচিত্র স্ট্যাটিক এপিআই তারপরে নির্দিষ্ট ক্রমে সেই পয়েন্টগুলি বরাবর পথটি সংযুক্ত করবে। |
পাথপয়েন্টটি | (পাইপ) চরিত্র।
নিম্নলিখিত উদাহরণটি ইউনিয়ন স্কয়ার এনওয়াই থেকে টাইমস স্কয়ার, এনওয়াই পর্যন্ত ডিফল্ট 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% অস্বচ্ছতা রাখার জন্য সেট করেছি।
এনকোডেড পলিলিন
ধারাবাহিক অবস্থানের পরিবর্তে, আপনি পরিবর্তে কোনও এনকোডেড পললাইন হিসাবে একটি পথ ঘোষণা করতে পারেন enc:
উপসর্গটি path
অবস্থান ঘোষণার মধ্যে।
নিম্নলিখিত উদাহরণটি ডসন ক্রিক, বিসি থেকে ডেল্টা জংশন পর্যন্ত আলাস্কা হাইওয়ের কোর্সের রূপরেখা, একটি এনকোডেড পললাইন সহ একে একে:
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
প্যারামিটারটি মানচিত্রের স্ট্যাটিক এপিআই পরিষেবাটিকে এমন একটি মানচিত্র তৈরি করতে নির্দেশ দেয় যাতে বিদ্যমান অবস্থানগুলি দৃশ্যমান থাকে। (এই প্যারামিটারটি একটি দৃশ্যমান অঞ্চলকেও সংজ্ঞায়িত করতে বিদ্যমান চিহ্নিতকারী বা পাথগুলির সাথে একত্রিত হতে পারে)) এই পদ্ধতিতে একটি ভিউপোর্ট সংজ্ঞায়িত করা একটি সঠিক জুম স্তর নির্দিষ্ট করার প্রয়োজনীয়তাটিকে অবলম্বন করে।
পরবর্তী উদাহরণটি বোস্টনকে কেন্দ্র করে একটি মানচিত্রের অনুরোধ করেছে, এমএ কেমব্রিজের এমআইটি এবং হার্ভার্ড স্কয়ার উভয়ই রয়েছে: এমএ:
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
ইউআরএল প্যারামিটারগুলি নির্দিষ্ট করতে হবে। তবে, আপনি যদি markers
, path
বা visible
পরামিতি সরবরাহ করেন তবে আপনি পরিবর্তে মানচিত্রগুলি স্ট্যাটিক এপিআইকে এই উপাদানগুলির অবস্থানের মূল্যায়নের ভিত্তিতে সঠিক কেন্দ্র এবং জুম স্তরটি সুস্পষ্টভাবে নির্ধারণ করতে পারেন।
যদি দুটি বা ততোধিক উপাদান সরবরাহ করে তবে মানচিত্রের স্ট্যাটিক এপিআই একটি সঠিক কেন্দ্র এবং জুম স্তর নির্ধারণ করবে, যা অন্তর্ভুক্ত উপাদানগুলির জন্য উদার মার্জিন সরবরাহ করবে। এই উদাহরণটি সান ফ্রান্সিসকো, ওকল্যান্ড এবং সান জোসে, সিএ সম্বলিত একটি মানচিত্র প্রদর্শন করে:
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 পিক্সেল (বা 1280 x 1280 পিক্সেল 2 এর স্কেল মান সহ 2 এর চেয়ে বড় আকারের চিত্রগুলির প্রয়োজন হয় তবে দয়া করে সমর্থন দলের সাথে যোগাযোগ করুন এবং নিম্নলিখিত তথ্য সরবরাহ করুন:
- আপনার ব্যবহারের ক্ষেত্রে এবং কেন আপনার বড় আকারের চিত্রগুলির প্রয়োজন।
- আপনি অন্যান্য গুগল ম্যাপস প্ল্যাটফর্ম এপিআই (মানচিত্র জাভাস্ক্রিপ্ট এপিআই, এমএপিএস এমপিআই এপিআই, অ্যান্ড্রয়েডের জন্য মানচিত্র এসডিকে, বা আইওএসের জন্য মানচিত্র এসডিকে) ব্যবহার করার বিষয়টি বিবেচনা করেছেন কিনা এবং কেন তারা আপনার প্রয়োজনগুলি পূরণ করে না।
- আপনি কীভাবে বড় আকারের চিত্র ব্যবহার করবেন তার স্ক্রিনশট, উপহাসের বা নমুনাগুলি।
- বড় আকারের চিত্রগুলির জন্য আপনার আনুমানিক মাসিক ব্যবহার।
আপনার প্রদত্ত তথ্যের ভিত্তিতে আমরা আপনার অনুরোধটি পর্যালোচনা করব এবং আপনার ব্যবহারের ক্ষেত্রে গুগল ম্যাপস প্ল্যাটফর্মের পরিষেবার শর্তাদি মেনে চলে কিনা তা নির্ধারণ করব।
আমরা যে সর্বাধিক আকার সরবরাহ করতে পারি তা হ'ল 2048 x 2048 পিক্সেল।
সমস্যা সমাধান এবং সমর্থন
মানচিত্র স্ট্যাটিক এপিআই ব্যবহার করার বিষয়ে আরও তথ্যের জন্য, সমর্থন পৃষ্ঠাটি একবার দেখুন।
মানচিত্রের স্ট্যাটিক এপিআই যখন কোনও ভুল হয়ে যায় তখন কোনও ত্রুটি বা সতর্কতা জারি করতে পারে। আপনি যদি লক্ষ্য করেন যে মানচিত্র থেকে কিছু অনুপস্থিত রয়েছে তা যদি আপনি লক্ষ্য করেন তবে আপনার বিশেষত সতর্কতাগুলি পরীক্ষা করা উচিত। নতুন অ্যাপ্লিকেশন চালু করার আগে সতর্কতাগুলি পরীক্ষা করাও ভাল ধারণা। নোট করুন যে সতর্কতাগুলি তাত্ক্ষণিকভাবে স্পষ্ট না হতে পারে কারণ তারা এইচটিটিপি শিরোনামে উপস্থিত হয়। আরও তথ্যের জন্য, ত্রুটি এবং সতর্কতার জন্য গাইড দেখুন।