Maps Embed API কুইকস্টার্ট

HTTP অনুরোধের মাধ্যমে আপনার ওয়েব পেজে ইন্টার‍্যাক্টিভ ম্যাপ বা Street View প্যানোরামা যোগ করুন—কাস্টম JavaScript-এর প্রয়োজন নেই।

খরচ

Maps Embed API-এর সব অনুরোধ কোনও চার্জ ছাড়াই উপলভ্য এবং আনলিমিটেড ব্যবহার করা যায়। তবে, সব অনুরোধের জন্য এখনও একটি সঠিক Google Cloud API কী প্রয়োজন। আরও তথ্যের জন্য, ব্যবহার ও বিলিং দেখুন।

শুরু করার আগে

আপনার ওয়েব পেজে এম্বেড করা ম্যাপ তৈরি করতে, নিম্নলিখিত প্রয়োজনীয় সেট-আপের ধাপগুলি সম্পূর্ণ করুন:

ধাপ ১: আপনার প্রোজেক্ট সেট-আপ করুন

কনসোল

1. Google Cloud কনসোলে, প্রোজেক্ট সিলেক্টর পৃষ্ঠায়, নতুন Cloud প্রোজেক্ট তৈরি করা শুরু করতে প্রোজেক্ট তৈরি করুন বিকল্পে ক্লিক করুন।

   প্রোজেক্ট সিলেক্টর পৃষ্ঠায় যান

2. আপনার ক্লাউড প্রোজেক্টের জন্য বিলিং চালু করা আছে কিনা তা নিশ্চিত করুন। আপনার প্রোজেক্টের জন্য বিলিং চালু করা আছে কিনা তা কনফার্ম করুন।

   মনে রাখবেন: Cloud প্রোজেক্ট সেট-আপ করার জন্য আপনাকে বিলিং অ্যাকাউন্ট সেট-আপ করতে হলেও, Embed API-এর প্রকৃত ব্যবহার কোনও চার্জ ছাড়াই উপলভ্য।

   Google Cloud-এ $০.০০ চার্জের ট্রায়াল অফার করা হয়। ৯০ দিনের শেষে অথবা অ্যাকাউন্টে $৩০০ মূল্যের চার্জ জমা হওয়ার পরে, যেটি আগে হবে, তখন ট্রায়ালের মেয়াদ শেষ হয়ে যাবে। যেকোনও সময় বাতিল করুন। আরও তথ্যের জন্য, বিলিং অ্যাকাউন্ট ক্রেডিট এবং বিলিং দেখুন।

Cloud SDK

gcloud projects create "PROJECT"

Google Cloud SDK, Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:

• gcloud projects create

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

ধাপ ২: API বা SDK চালু করা

Google Maps Platform ব্যবহার করতে, আপনার প্রোজেক্টের সাথে যে API বা SDK ব্যবহার করার পরিকল্পনা করছেন তা চালু করতে হবে।

কনসোল

Maps Embed API চালু করুন

Cloud SDK

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

Google Cloud SDK, Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:

• gcloud services enable
• gcloud services disable

ধাপ ৩: API key পাওয়া

এই ধাপে শুধু API key তৈরি করার প্রসেস দেখানো হয়। আপনি প্রোডাকশনে API key ব্যবহার করলে, আমরা আপনাকে API key-এর ব্যবহার সীমিত করার জন্য জোরালো সাজেশন দিই। আপনি প্রোডাক্ট-নির্দিষ্ট API কী ব্যবহার করা পৃষ্ঠায় আরও তথ্য পেতে পারেন।

API কী হল একটি অনন্য শনাক্তকারী যা ব্যবহার এবং বিলিংয়ের উদ্দেশ্যে আপনার প্রোজেক্টের সাথে সম্পর্কিত অনুরোধগুলি যাচাই করে। আপনার প্রোজেক্টের সাথে অন্তত একটি API কী যুক্ত থাকতে হবে। নতুন 'কী' তৈরি করতে অথবা আগে থেকে থাকা 'কী'-তে API বা SDK যোগ করতে, এইসব নির্দেশাবলী অনুসরণ করুন।

কনসোল

1. Google Maps Platform > কী ও ক্রেডেনশিয়াল পৃষ্ঠায় যান।

   'কী' ও ক্রেডেনশিয়াল পৃষ্ঠায় যান

2. প্রম্পট করা হলে, আপনার প্রোজেক্ট বেছে নিন।

3. নিম্নলিখিতগুলির মধ্যে থেকে যেকোনও একটি করুন:

   • নতুন 'কী' তৈরি করুন:

     1. ক্রেডেনশিয়াল তৈরি করুন > API key বিকল্পে ক্লিক করুন।
     2. API key তৈরি করুন প্যানেলে, API সংক্রান্ত বিধিনিষেধ বেছে নিন তালিকা খুলুন।
     3. এই 'কী'-এর প্রয়োজন নেই এমন যেকোনও API মুছে দিন এবং নিশ্চিত করুন যে Maps Embed API বেছে নেওয়া আছে।
     4. তৈরি করুন বিকল্পে ক্লিক করুন। প্যানেলে আপনার নতুন API কী দেখা যাবে।

   • আগে থেকে থাকা 'কী' ব্যবহার করুন:

     1. 'কী'-এর নামে ক্লিক করুন।
     2. API সংক্রান্ত বিধিনিষেধ বেছে নিন তালিকা থেকে, Maps Embed API বেছে নিন।
     3. সেভ করুন বিকল্পে ক্লিক করুন।

   এখানে API বেছে নিলে তা চালু হয় না। Maps Embed API এর API লাইব্রেরি পৃষ্ঠায় চালু করা আছে কিনা তা নিশ্চিত করুন।

4. পরে কী স্ট্রিং দেখতে, কী ও ক্রেডেনশিয়াল পৃষ্ঠায় যান এবং কী-এর জন্য কী দেখুন বিকল্পে ক্লিক করুন।

কনসোলটি যদি এই ধাপগুলির থেকে আলাদা দেখায়, তাহলে Google Cloud ডকুমেন্টেশনে একটি API কী তৈরি করুন এবং API বিধিনিষেধ যোগ করুন দেখুন।

Cloud SDK

নিচের কমান্ডে PROJECT_ID-এর জায়গায় আপনার প্রোজেক্ট আইডি লিখুন।

• নতুন 'কী' তৈরি করুন: নিম্নলিখিত কমান্ড রান করুন এবং DISPLAY_NAME-এর জায়গায় 'কী'-এর নাম লিখুন।

  gcloud services api-keys create \
      --project="PROJECT_ID" \
      --display-name="DISPLAY_NAME" \
      --api-target=service=maps-embed-backend.googleapis.com

  Google Cloud SDK, Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:

  • gcloud services api-keys create

• আগে থেকে থাকা 'কী' ব্যবহার করুন: নিম্নলিখিত কমান্ড রান করুন এবং KEY_ID-এর জায়গায় 'কী'-এর আইডি লিখুন। --append ফ্ল্যাগ সেইসব API রাখে যেগুলি 'কী' আগে থেকেই অনুমোদন করে। এটি না থাকলে, কমান্ডটি সেগুলি পরিবর্তন করে।

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=maps-embed-backend.googleapis.com

  Google Cloud SDK, Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:

  • gcloud services api-keys update
  • gcloud services api-keys list

  'কী' আইডি হল 'কী' স্ট্রিং বা ডিসপ্লে নাম নয়। এটি খুঁজতে, gcloud services api-keys list --project="PROJECT_ID" রান করুন। আইডি হল name ফিল্ডের শেষ অংশ: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID।

কী স্ট্রিং দেখতে, gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" রান করুন।

iframe তৈরি করা হচ্ছে

নিম্নলিখিত বিকল্পগুলিতে ক্লিক করুন এবং আপনার ওয়েবপেজের জন্য একটি iframe তৈরি করতে একটি লোকেশন এবং API কী যোগ করুন। অতিরিক্ত প্যারামিটার ও বিকল্পের জন্য, ম্যাপ এম্বেড করা দেখুন।

আপনার iframe পরীক্ষা করা হচ্ছে

HTML ব্রাউজার উইন্ডোতে আপনার iframe দেখতে:

1. আপনার ডিফল্ট টেক্সট এডিটর খুলুন। আপনার ডিভাইসে ডিফল্ট হিসেবে TextEdit বা Microsoft Windows Notepad-এর মতো টেক্সট এডিটর ইনস্টল করা থাকতে হবে।
2. একটি HTML ফাইল তৈরি করে সেটির নাম index.html রাখুন।

3. উপরে আপনার তৈরি করা iframe-এর সাথে নিম্নলিখিত কোড যোগ করুন:

   <html>
     <!-- Replace this code comment with your iframe. -->
   </html>
   

4. আপনার index.html HTML ফাইল সেভ করুন।

5. আপনার ডেস্কটপ থেকে ব্রাউজারে টেনে এনে HTML ফাইলটি ওয়েব ব্রাউজারে লোড করুন; বিকল্প হিসেবে, বেশিরভাগ অপারেটিং সিস্টেমে ফাইলে ডবল ক্লিক করলে কাজ হয়।

অভিনন্দন! আপনি Maps Embed API ব্যবহার করে একটি ম্যাপ সেট-আপ ও তৈরি করেছেন।

পরিষ্কার করা হচ্ছে

আপনি Google Cloud প্রোজেক্ট মুছে দিতে পারেন যাতে সেই প্রোজেক্টের মধ্যে ব্যবহার করা সমস্ত রিসোর্সের জন্য বিলিং বন্ধ করা যায়।

সতর্কতা: প্রোজেক্ট মুছে দিলে নিম্নলিখিত প্রভাব পড়ে:

• প্রোজেক্টের সবকিছু মুছে ফেলা হয়েছে। এই টিউটোরিয়ালের জন্য আপনি আগে থেকে থাকা কোনও প্রোজেক্ট ব্যবহার করে থাকলে, সেটি মুছে দিলে, প্রোজেক্টে আপনার করা অন্যান্য কাজও মুছে যাবে।
• কাস্টম প্রোজেক্ট আইডি হারিয়ে গেছে। এই প্রোজেক্ট তৈরি করার সময়, আপনি হয়ত একটি কাস্টম প্রোজেক্ট আইডি তৈরি করেছেন যা আপনি ভবিষ্যতে ব্যবহার করতে চান। প্রোজেক্ট আইডি ব্যবহার করে এমন URL, যেমন appspot.com URL, সংরক্ষণ করতে, পুরো প্রোজেক্ট মুছে ফেলার পরিবর্তে প্রোজেক্টের মধ্যে বেছে নেওয়া রিসোর্স মুছে ফেলুন।

1. Google Cloud কনসোলে, রিসোর্স ম্যানেজ করুন পৃষ্ঠায় যান:

   রিসোর্স ম্যানেজ করুন পৃষ্ঠায় যান

2. আপনি যে প্রোজেক্টটি মুছে ফেলার পরিকল্পনা করছেন সেটি যদি কোনও সংস্থার সাথে অ্যাটাচ করা থাকে, তাহলে পৃষ্ঠার উপরে সংস্থার তালিকা বেছে নিন এবং বড় করুন।
3. প্রোজেক্টের তালিকা থেকে, আপনি যে প্রোজেক্ট মুছতে চান সেটি বেছে নিন এবং মুছুন বিকল্পে ক্লিক করুন।
4. ডায়ালগে প্রোজেক্ট আইডি টাইপ করুন এবং প্রোজেক্ট মুছে দিতে বন্ধ করুন বিকল্পে ক্লিক করুন।

পরবর্তী ধাপ

• আপনার Google Cloud প্রোজেক্ট সেট-আপ করে Maps Embed API-এর সাহায্যে ডেভেলপ করা শুরু করুন:

  Cloud Console-এ সেট-আপ করুন

• আপনার iframe-এ যোগ করতে পারবেন এমন অতিরিক্ত প্যারামিটার ও বিকল্পের তালিকা দেখতে:

  ম্যাপ এম্বেড করা

• JavaScript API-এর মাধ্যমে আপনার Maps প্রোজেক্টের মেয়াদ বাড়ান:

  Maps JavaScript API