এই ডকুমেন্টে Navigation Connect ব্যবহার শুরু করার জন্য প্রয়োজনীয় ধাপগুলি বর্ণনা করা হয়েছে।
পূর্বশর্ত
এই নির্দেশিকা থেকে জানতে পারবেন যে কীভাবে আপনার Google Cloud অ্যাকাউন্ট এবং বিলিং চালু থাকা Google Cloud প্রোজেক্ট সেট-আপ করবেন। এছাড়াও, Navigation Connect API ব্যবহার করার জন্য আপনাকে কীভাবে চার্জ করা হবে সেই সম্পর্কেও আপনাকে জানতে হবে।
- নেভিগেশন কানেক্ট ব্যবহার ও বিলিং-এ গিয়ে ব্যবহারের জন্য বিলিং ও খরচ পর্যালোচনা করুন।
-
আপনার একটি Google Cloud অ্যাকাউন্ট আছে কিনা তা যাচাই করুন।
Google Cloud কনসোলে সাইন-ইন করুন -
আপনার কাছে বিলিং চালু করা আছে এমন একটি Google Cloud প্রোজেক্ট আছে কিনা তা যাচাই করুন।
বিলিং পৃষ্ঠায় যান- বিলিং পৃষ্ঠা খুলতে আপনার প্রোজেক্ট বেছে নিন।
-
বিলিং পৃষ্ঠায়:
- বেছে নেওয়া প্রোজেক্টের জন্য বিলিং আগে থেকেই চালু করা থাকলে এবং আপনার কাছে শুধুমাত্র একটি বিলিং অ্যাকাউন্ট থাকলে, বিলিং পৃষ্ঠা খুলে যাবে।
- আপনার একাধিক বিলিং অ্যাকাউন্ট থাকলে, প্রোজেক্টের সাথে যুক্ত বিলিং অ্যাকাউন্ট সম্পর্কে বিবরণ দেখতে লিঙ্ক করা বিলিং অ্যাকাউন্টে যান বিকল্প বেছে নিন।
- বিলিং অ্যাকাউন্ট থাকলে কিন্তু প্রোজেক্টের সাথে যুক্ত না থাকলে, আপনাকে প্রোজেক্টের সাথে বিলিং অ্যাকাউন্ট লিঙ্ক করতে বলা হবে।
- কোনও বিলিং অ্যাকাউন্ট না থাকলে অথবা আপনি নতুন বিলিং অ্যাকাউন্ট তৈরি করতে চাইলে, নতুন বিলিং অ্যাকাউন্ট তৈরি করতে বিলিং অ্যাকাউন্ট ম্যানেজ করুন বিকল্প বেছে নিন। আরও তথ্যের জন্য, নতুন সেল্ফ-সার্ভ ক্লাউড বিলিং অ্যাকাউন্ট তৈরি করুন দেখুন।
API চালু করে আপনার অ্যাপ যাচাই করা
এই নির্দেশিকায় Navigation Connect API চালু করা এবং Google Cloud কনসোলে আপনার অ্যাপ যাচাই করার প্রসেস বর্ণনা করা হয়েছে, যার মাধ্যমে আপনার অ্যাপ Google Maps ও Waze-এর সাথে নিরাপদে ইন্টারফেস করতে পারে। Navigation Connect API ব্যবহার করতে আপনাকে এই প্রসেস সম্পূর্ণ করতে হবে।
১. Navigation Connect API চালু করা
আপনার Google Cloud প্রোজেক্টে Navigation Connect API চালু করতে,
Google Cloud কনসোল বা
gcloud কমান্ড ব্যবহার করুন।
API চালু করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
কনসোল
Google Cloud কনসোলে প্রোডাক্ট পৃষ্ঠা খুলুন:
Navigation Connect API চালু করাচালু করুন বোতামে ক্লিক করুন।
gcloud
gcloud services enable \ --project "PROJECT" \ "navigationconnect.googleapis.com"
Google Cloud SDK, Cloud SDK ইনস্টলেশন এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:
২. অ্যাপ যাচাইকরণ প্রসেস শুরু করুন
API চালু করার পরে, Navigation Connect API অ্যাক্টিভেট করতে আপনাকে অবশ্যই অ্যাপ যাচাই করতে হবে। শুধুমাত্র API চালু করলেই অ্যাক্সেস পাওয়া যায় না; Navigation Connect API ব্যবহার করার আগে আপনাকে ব্যবসা ও অ্যাপের বিবরণ পর্যালোচনার জন্য জমা দিতে হবে।
যাচাইকরণ পদ্ধতি শুরু করতে, নিম্নলিখিত যেকোনও একটি পদ্ধতি ব্যবহার করুন:
-
API Marketplace:
- API Marketplace-এ, Navigation Connect API কার্ড খুঁজুন।
- যাচাইকরণ ফ্লো শুরু করতে নীল রঙের যাচাইকরণ প্রয়োজন আইকনে ক্লিক করুন।
-
Google Cloud কনসোলে কী ও ক্রেডেনশিয়াল:
- Google Cloud কনসোলে, কী ও ক্রেডেনশিয়াল পৃষ্ঠায় যান।
- নেভিগেশন কানেক্ট কী ও ক্রেডেনশিয়াল বিকল্পে ক্লিক করুন।
- ব্যানারে, যাচাইকরণ শুরু করুন বিকল্পে ক্লিক করুন।
৩. অ্যাপ, ডেটা সংগ্রহ ও গোপনীয়তা সংক্রান্ত বিবরণ দিন
অ্যাপ যাচাইকরণের জন্য আপনাকে যেসব বিবরণ দিতে হবে তা নিম্নলিখিত সারণীতে বর্ণনা করা হয়েছে:
| ফিল্ড | বিবরণ |
|---|---|
| অ্যাপের বিবরণ Google Maps এবং Waze-এ আপনার অ্যাপ যাতে সঠিকভাবে দেখা যায় তা নিশ্চিত করতে নিম্নলিখিত বিবরণ প্রদান করুন। |
|
| ব্যবসা বা অ্যাপের নাম | Google Maps এবং Waze-এ ব্যবহারকারীদের দেখানোর জন্য নাম লিখুন। |
| অ্যাপ্লিকেশন আইডেন্টিফায়ার | আপনার Android প্যাকেজের নাম বা iOS বান্ডেল আইডি লিখুন। |
| iOS ইউনিভার্সাল লিঙ্ক | iOS ইউনিভার্সাল লিঙ্ক দিন যা ব্যবহারকারীদের আপনার অ্যাপে ফিরে আসতে দেয় (শুধুমাত্র Waze-এ উপলভ্য)। |
| অ্যাপের লোগো (শুধু Waze) | (ঐচ্ছিক) নেভিগেশন সেশন চলাকালীন Waze-এ আপনার অ্যাপের লোগো দেখানোর জন্য একটি PNG বা JPG লোগো (৩২x৩২ থেকে ১২৮x১২৮ পিক্সেল) আপলোড করুন। |
| ডেটা সংগ্রহ ও গোপনীয়তা সংক্রান্ত বিবরণ স্বচ্ছতা, ড্রাইভারের বিশ্বাস ও ডেটার নিরাপত্তা নিশ্চিত করতে নিম্নলিখিত বিবরণ লিখুন। |
|
| গোপনীয়তা নীতির লিঙ্ক | আপনার অ্যাপের গোপনীয়তা নীতির URL দিন। এই লিঙ্কটি সম্মতি সংক্রান্ত স্ক্রিনে দেখা যায়। |
| অতিরিক্ত ডেটা কন্ট্রোলার (ঐচ্ছিক) | ISV-এর মতো যেকোনও থার্ড-পার্টি ডেটা ম্যানেজারের জন্য ব্যবসার নাম এবং গোপনীয়তা নীতির লিঙ্ক প্রদান করুন। এইসব বিবরণ সম্মতি সংক্রান্ত স্ক্রিনে দেখা যায়। |
| ডেটা সংক্রান্ত সম্মতি | আপনার অ্যাপ মার্কিন যুক্তরাষ্ট্রে কাজ করলে, স্থানীয় রেগুলেশন মেনে চলার জন্য এই অ্যাপ মার্কিন যুক্তরাষ্ট্রে ট্রিপের জন্য ব্যবহার করা হবে চেকবক্স বেছে নিন। |
৪. পর্যালোচনা করুন ও জমা দিন
যাচাইকরণের জন্য আপনার অ্যাপ জমা দেওয়ার আগে, আপনার দেওয়া তথ্যের সারসংক্ষেপ পর্যালোচনা করুন।
-
আপনার অ্যাপের নাম, প্ল্যাটফর্ম, আইডি ও লিঙ্ক ভালভাবে পর্যালোচনা করুন।
- সব তথ্য সঠিক চেকবক্স বেছে নিন।
- জমা দিন বিকল্পে ক্লিক করুন।
যাচাইকরণের জন্য আপনার অ্যাপ জমা দেওয়ার পরে, পর্যালোচনা পর্ব শুরু হয়।
- সময়সীমা: যাচাইকরণে সাধারণত ১-৩ কর্মদিবস সময় লাগে।
- বিজ্ঞপ্তি: যাচাইকরণের স্ট্যাটাস পরিবর্তন হলে আপনি একটি ইমেল পাবেন। এছাড়াও, আপনার পেমেন্ট প্রোফাইল আইডি বা Android ডেভেলপার আইডি চেয়ে আপনাকে ইমেল পাঠানো হবে। আপনার Android ডেভেলপার আইডি প্রয়োজন হলে, ডেভেলপার অ্যাকাউন্ট তৈরি করা দেখুন।
- স্ট্যাটাস ট্র্যাকিং: Google Cloud কনসোলের কী ও ক্রেডেনশিয়াল পৃষ্ঠায় আপনার অগ্রগতি মনিটর করুন।
- সহায়তা: প্রোডাকশন প্রভাবিত না করে অনুমোদনের পরে আপনার কনফিগারেশন আপডেট করতে, একটি সহায়তা টিকিট তৈরি করুন।
যাচাই করা হয়ে গেলে, আপনার অ্যাপ Navigation Connect API ব্যবহার করার জন্য অনুমোদিত হয়, যাতে ট্রিপ টোকেন তৈরি করা যায়। এই টোকেন নেভিগেশন সেশনে অ্যাক্সেস অনুমোদন করে এবং আপনাকে Google Maps ও Waze থেকে ট্রিপের বিবরণ পেতে দেয়।
অননুমোদিত ব্যবহার আটকাতে Google Maps Platform প্রোডাক্টের API কলে OAuth টোকেন অন্তর্ভুক্ত করতে হয়।
OAuth টোকেন তৈরি করা
Navigation Connect যাচাইকরণের জন্য OAuth 2.0 সমর্থন করে। Google সাধারণ OAuth 2.0 পরিস্থিতি সমর্থন করে, যেমন একটি ওয়েব সার্ভারের জন্য পরিস্থিতি।
আপনার ডেভেলপমেন্ট এনভায়রনমেন্টে কীভাবে Navigation Connect কলে OAuth টোকেন পাস করবেন তা এই ডকুমেন্টে বর্ণনা করা হয়েছে। প্রোডাকশন এনভায়রনমেন্টে OAuth ব্যবহার করার ব্যাপারে আরও তথ্য পেতে, Google-এ যাচাইকরণ পদ্ধতি দেখুন।
আপনি সার্ভারে API অনুরোধ করে সরাসরি Google Maps API কল করতে পারেন অথবা আপনার কোড সহজ করতে ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে পারেন। Google Maps, Go, Java, Node.js ও Python-এর জন্য ক্লায়েন্ট লাইব্রেরি প্রদান করে। আরও তথ্যের জন্য, Navigation Connect ক্লায়েন্ট লাইব্রেরি দেখুন।
OAuth ওভারভিউ
আপনার ডিপ্লয়মেন্ট এনভায়রনমেন্টের উপর নির্ভর করে আপনি বিভিন্ন উপায়ে OAuth-এর মাধ্যমে অ্যাক্সেস টোকেন তৈরি ও ম্যানেজ করতে পারবেন।
আপনার অ্যাপ্লিকেশন এবং Google পরিষেবার মধ্যে সার্ভার-টু-সার্ভার ইন্টার্যাকশনের জন্য আপনি OAuth 2.0 ব্যবহার করতে পারেন। এই পরিস্থিতিতে, আপনি এমন একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করেন যা কোনও স্বতন্ত্র ব্যবহারকারীর পরিবর্তে আপনার অ্যাপ্লিকেশনের সাথে যুক্ত। আপনি ব্যবহারকারীদের সরাসরি যুক্ত না করেই পরিষেবা অ্যাকাউন্ট ব্যবহার করে API অনুরোধ করতে পারেন। যাচাইকরণ পদ্ধতি সম্পর্কে আরও জানতে, Google-এ যাচাইকরণ পদ্ধতি দেখুন।
বিকল্প হিসেবে, আপনি Android বা iOS মোবাইল অ্যাপে Navigation Connect ইন্টিগ্রেট করতে পারেন। বিভিন্ন ডেপ্লয়মেন্ট এনভায়রনমেন্টের জন্য OAuth ব্যবহার করা ও অ্যাক্সেস টোকেন ম্যানেজ করা সম্পর্কে আরও তথ্য পেতে, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।
OAuth স্কোপ
Navigation Connect-এর সাথে OAuth ব্যবহার করতে, আপনাকে OAuth টোকেনে নিম্নলিখিত স্কোপ অ্যাসাইন করতে হবে:
https://www.googleapis.com/auth/cloud-platform
যেমন: আপনার লোকাল ডেভেলপমেন্ট এনভায়রনমেন্টে REST API কল করে দেখুন
আপনার কাছে টোকেন জেনারেট করার মতো পরিবেশ না থাকলে এবং আপনি OAuth টোকেন দিয়ে Navigation Connect ব্যবহার করে দেখতে চাইলে, এই বিভাগে উল্লেখ করা পদ্ধতি অনুসরণ করুন।
এই উদাহরণে দেখানো হয়েছে যে কল করার জন্য কীভাবে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC)-এর মাধ্যমে প্রদান করা OAuth টোকেন ব্যবহার করতে হয়। ক্লায়েন্ট লাইব্রেরির মাধ্যমে Google API কল করার জন্য ADC ব্যবহার করা সম্পর্কে আরও তথ্যের জন্য, ক্লায়েন্ট লাইব্রেরি ব্যবহার করে যাচাইকরণ করুন দেখুন।
নিম্নলিখিত REST পদ্ধতি শুধুমাত্র ডেভেলপমেন্ট বা পরীক্ষার জন্য ব্যবহার করুন, প্রোডাকশনের জন্য নয়।
পূর্বশর্ত
ADC ব্যবহার করে REST অনুরোধ করার আগে, ADC-তে ক্রেডেনশিয়াল প্রদান করতে gcloud CLI ব্যবহার করুন:
gcloudCLI ইনস্টল ও ইনিশিয়ালাইজ করুন। আরও তথ্যের জন্য, gcloud CLI ইনস্টল করুন দেখুন।gcloudCLI-এর মাধ্যমে যাচাই করুন:gcloud auth application-default login
ADC-এর ব্যবহার করা লোকাল ক্রেডেনশিয়াল ফাইলে আপনার ক্রেডেনশিয়াল সেভ করতে সাইন-ইন করার প্রসেস সম্পূর্ণ করুন।
আরও তথ্যের জন্য, লোকাল ডেভেলপমেন্ট এনভায়রনমেন্টের জন্য ADC সেট-আপ করুন দেখুন।
REST অনুরোধ করা
এই উদাহরণে, আপনি দুটি রিকোয়েস্ট হেডার পাস করেন:
নিম্নলিখিত কমান্ড ব্যবহার করে টোকেন জেনারেট করুন এবং
Authorizationহেডারে OAuth টোকেন পাস করুন:gcloud auth application-default print-access-tokenফেরত দেওয়া টোকেনের স্কোপ হল
https://www.googleapis.com/auth/cloud-platform।আপনার Google Cloud প্রোজেক্টের আইডি বা নাম পাস করুন, যার বিলিং
X-Goog-User-Projectহেডারে চালু করা আছে।
OAuth টোকেন ব্যবহার করে Navigation Connect কল করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
নিম্নলিখিত কোড স্যাম্পেলে, প্লেসহোল্ডারগুলি আপনার ভ্যালু দিয়ে পরিবর্তন করুন:
- PROJECT_ID: আপনার Google Cloud প্রোজেক্ট আইডি
- ANDROID_APP_ID: আপনার অ্যাপের Android প্যাকেজের নাম, যদি প্রযোজ্য হয়
- IOS_APP_ID: প্রযোজ্য হলে, আপনার অ্যাপের iOS বান্ডেল আইডি
#!/bin/bash trip_id="$(uuidgen)" access_token="$(gcloud auth application-default print-access-token)" curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \ -H "Authorization: Bearer ${access_token}" \ -H "Content-Type: application/json" \ -d '{ "androidAppId": "ANDROID_APP_ID", "iosAppId": "IOS_APP_ID", }'
curlকমান্ড কপি করতে, কোড স্যাম্পেলে কপি করুন বিকল্পে ক্লিক করুন।টার্মিনাল উইন্ডোতে কমান্ড পেস্ট করে রান করুন।
রেসপন্স একটি JSON অবজেক্ট:
{ "name": "projects/PROJECT_NUMBER/trips/TRIP_ID", "authToken": { "token": "BASE64_ENCODED_TRIP_TOKEN", "expireTime": "2026-03-06T11:09:47.476942Z" }, "state": "NEW", "execution": { "traveledDistanceMeters": 0, "stopAddedInRoute": false }, "createTime": "2026-03-05T23:09:50.768959Z", "updateTime": "2026-03-05T23:09:50.768959Z", }
এই উত্তরে নিম্নলিখিত ভ্যালু অন্তর্ভুক্ত:
- PROJECT_NUMBER: প্রোজেক্টের জন্য অনন্য লং-ইন্টিজার শনাক্তকারী
- TRIP_ID: আপনার ব্যাকএন্ডের মাধ্যমে জেনারেট করা UUIDv4 ট্রিপ আইডি
- BASE64_ENCODED_TRIP_TOKEN: Google Maps বা Waze-এ ট্র্যাক করা ধাপে ধাপে নেভিগেশন শুরু করার জন্য
createTripপদ্ধতি যে যাচাই করা টোকেন রিটার্ন করে
সমস্যার সমাধান
আপনার অনুরোধে যদি এমন কোনও ত্রুটি মেসেজ আসে যাতে বলা হয় যে এই API-তে এন্ড-ইউজার ক্রেডেনশিয়াল কাজ করে না, তাহলে আপনার ADC সেট-আপের সমস্যার সমাধান করুন।
এর পরে কী করতে হবে
এরপর, আপনার ব্যাকএন্ড ইনফ্রাস্ট্রাকচার, Google Maps এবং Waze-এর মধ্যে সুরক্ষিত, সার্ভার-টু-সার্ভার কমিউনিকেশন সাপোর্ট করার জন্য Navigation Connect API-এর জন্য আপনার পরিষেবা অ্যাকাউন্ট কনফিগার করুন।
আপনার পরিষেবা অ্যাকাউন্ট সেট-আপ করা