API কী ব্যবহার করুন

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

এই গাইডটি দেখায় কিভাবে Google Maps প্ল্যাটফর্মের জন্য আপনার API কী তৈরি, সীমাবদ্ধ এবং ব্যবহার করতে হয়।

তুমি শুরু করার আগে

আপনি মানচিত্র জাভাস্ক্রিপ্ট API ব্যবহার শুরু করার আগে, আপনার একটি বিলিং অ্যাকাউন্ট এবং মানচিত্র জাভাস্ক্রিপ্ট API সক্ষম সহ একটি প্রকল্প প্রয়োজন৷ আরও জানতে, ক্লাউড কনসোলে সেট আপ দেখুন।

API কী তৈরি করুন

API কী একটি অনন্য শনাক্তকারী যা ব্যবহার এবং বিলিং উদ্দেশ্যে আপনার প্রকল্পের সাথে যুক্ত অনুরোধগুলিকে প্রমাণীকরণ করে৷ আপনার প্রোজেক্টের সাথে যুক্ত অন্তত একটি API কী থাকতে হবে।

একটি API কী তৈরি করতে:

কনসোল

  1. Google মানচিত্র প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠাতে যান।

    শংসাপত্র পৃষ্ঠায় যান

  2. শংসাপত্র পৃষ্ঠায়, শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
    API কী তৈরি ডায়ালগ আপনার নতুন তৈরি API কী প্রদর্শন করে।
  3. Close এ ক্লিক করুন।
    নতুন API কী API কী-এর অধীনে শংসাপত্র পৃষ্ঠায় তালিকাভুক্ত করা হয়েছে।
    (এটি উত্পাদনে ব্যবহার করার আগে API কী সীমাবদ্ধ করতে মনে রাখবেন।)

ক্লাউড SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

API কী সীমাবদ্ধ করুন

Google দৃঢ়ভাবে সুপারিশ করে যে আপনি আপনার এপিআই কীগুলির ব্যবহার সীমিত করে শুধুমাত্র আপনার অ্যাপ্লিকেশনের জন্য প্রয়োজনীয় API গুলিকে সীমাবদ্ধ করুন৷ এপিআই কীগুলিকে সীমাবদ্ধ করা আপনার অ্যাপ্লিকেশানটিকে অনাকাঙ্ক্ষিত অনুরোধ থেকে রক্ষা করে নিরাপত্তা যোগ করে। আরও তথ্যের জন্য, API নিরাপত্তার সর্বোত্তম অনুশীলন দেখুন।

একটি API কী সীমাবদ্ধ করতে:

কনসোল

  1. Google মানচিত্র প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠাতে যান।

    শংসাপত্র পৃষ্ঠায় যান

  2. আপনি একটি সীমাবদ্ধতা সেট করতে চান এমন API কী নির্বাচন করুন। API কী প্রপার্টি পৃষ্ঠাটি প্রদর্শিত হবে।
  3. কী সীমাবদ্ধতার অধীনে, নিম্নলিখিত সীমাবদ্ধতাগুলি সেট করুন:
    • আবেদন বিধিনিষেধ:
      1. আপনার সরবরাহ করা ওয়েবসাইটগুলির তালিকা থেকে অনুরোধগুলি গ্রহণ করতে, অ্যাপ্লিকেশন সীমাবদ্ধতার তালিকা থেকে HTTP রেফারার (ওয়েব সাইট) নির্বাচন করুন।
      2. এক বা একাধিক রেফারার ওয়েবসাইট নির্দিষ্ট করুন। আপনি সমস্ত সাবডোমেন অনুমোদন করতে ওয়াইল্ডকার্ড অক্ষর ব্যবহার করতে পারেন (উদাহরণস্বরূপ, HTTPS-এর মাধ্যমে অ্যাক্সেস করা হলে https://*.google.com .google.com এ শেষ হওয়া সমস্ত সাইট গ্রহণ করে)। https:// এবং http:// রেফারার স্কিম যেমন- আছে নির্দিষ্ট করুন। অন্যান্য URL প্রোটোকলের জন্য, আপনাকে অবশ্যই একটি বিশেষ উপস্থাপনা ব্যবহার করতে হবে। উদাহরণস্বরূপ, file:///path/to/ __file_url__//path/to/* হিসাবে ফর্ম্যাট করুন। ওয়েবসাইটগুলি সক্ষম করার পরে, এটি আপনার প্রত্যাশার সাথে মেলে তা নিশ্চিত করতে আপনার ব্যবহার নিরীক্ষণ করতে ভুলবেন না। নিম্নলিখিত প্রোটোকলগুলি সমর্থিত: about:// , app:// , applewebdata:// , asset:// , chrome:// , content:// , file:// , ftp:// , ionic:// , local:// , ms-appx:// , ms-appx-web:// , ms-local-stream:// , prism:// , qrc:// , res:// , saphtmlp:// .
    • API সীমাবদ্ধতা:
      1. সীমাবদ্ধ কী ক্লিক করুন।
      2. নির্বাচন করুন APIs ড্রপডাউন থেকে মানচিত্র JavaScript API নির্বাচন করুন। মানচিত্র জাভাস্ক্রিপ্ট API তালিকাভুক্ত না হলে, আপনাকে এটি সক্ষম করতে হবে।
      3. যদি আপনার প্রকল্প স্থান লাইব্রেরি ব্যবহার করে, এছাড়াও স্থান API নির্বাচন করুন। একইভাবে, যদি আপনার প্রোজেক্ট JavaScript API ( নির্দেশ পরিষেবা , দূরত্ব ম্যাট্রিক্স পরিষেবা , এলিভেশন পরিষেবা , এবং/অথবা জিওকোডিং পরিষেবা ) এ অন্যান্য পরিষেবা ব্যবহার করে, তাহলে আপনাকে অবশ্যই এই তালিকায় সংশ্লিষ্ট API সক্রিয় করতে হবে এবং নির্বাচন করতে হবে৷
  4. আপনার পরিবর্তনগুলি চূড়ান্ত করতে, সংরক্ষণ করুন ক্লিক করুন।

ক্লাউড SDK

বিদ্যমান কী তালিকাভুক্ত করুন।

gcloud services api-keys list --project="PROJECT"

বিদ্যমান কী-তে বিদ্যমান বিধিনিষেধ সাফ করুন।

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

বিদ্যমান কীতে নতুন সীমাবদ্ধতা সেট করুন।

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="maps-backend.googleapis.com"
    --allowed-referrers="referer"

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

আপনার অনুরোধে API কী যোগ করুন

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

<script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "weekly",
    // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
    // Add other bootstrap parameters as needed, using camel case.
  });
</script>