জিওকোডিং সংক্রান্ত প্রায়শই জিজ্ঞাসিত প্রশ্ন

এই প্রায়শই জিজ্ঞাসিত প্রশ্নাবলীতে Geocoding API সম্পর্কিত নির্দিষ্ট প্রশ্ন অন্তর্ভুক্ত রয়েছে। সব Google Maps Platform-এর ক্ষেত্রে সাধারণ প্রশ্নগুলির জন্য Google Maps Platform সংক্রান্ত প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন। এছাড়াও, জিওকোডিং অ্যাড্রেসের ক্ষেত্রে পেশাদার পদ্ধতি দেখুন।

সমস্যার সমাধান

সমস্যার সমাধান

আমি এমন কোয়েরি পাচ্ছি যেগুলি জিওকোডার ব্যবহার করে ZERO_RESULTS রিটার্ন করে। কী হচ্ছে?

জিওকোডারে, অস্পষ্ট, অসম্পূর্ণ এবং খারাপভাবে ফর্ম্যাট করা কোয়েরি, যেমন ভুল বানান বা অস্তিত্বহীন ঠিকানা, ZERO_RESULTS তৈরি করার প্রবণতা রয়েছে। ঠিকানা খুঁজে পাওয়া না গেলে, আংশিক ফলাফলের (যেমন, ঠিকানার পরিবর্তে শুধু শহরতলি দেখানো) পরিবর্তে ZERO_RESULTS দেখানোই শ্রেয়।

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

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

আমার দ্রুত উত্তর প্রয়োজন এবং আমার অ্যাপ্লিকেশনের জন্য জিওকোডার খুব ধীরে কাজ করে। আরও দ্রুত উত্তর পাওয়ার জন্য আমি কী ব্যবহার করতে পারি?

আমরা সাজেস্ট করি যে, যেসব অ্যাপ্লিকেশন ব্যবহারকারীর ইনপুটের উত্তর দেয় এবং সেই কারণে অত্যন্ত লেটেন্সি-সংবেদনশীল, সেগুলি অ্যাড্রেস জিওকোডিংয়ের পরিবর্তে Places API-তে প্লেস অটোকমপ্লিট ফিচার ব্যবহার করে (এটি JavaScript, Android বা iOS-এও উপলভ্য)। ইন্ট্যার‍্যাক্টিভ ব্যবহারের জন্য 'জায়গা অটোমেটিক সম্পূর্ণ করা' অপ্টিমাইজ করা হয়েছে এবং সেই কারণে এর লেটেন্সি খুবই কম।

Geocoding API-তে ঠিকানা জিওকোডিং সম্পূর্ণ, দ্ব্যর্থহীন, ভালভাবে ফর্ম্যাট করা ঠিকানা, যেমন অনলাইন ফর্মে লেখা ডেলিভারি ঠিকানা ইত্যাদির সাথে ব্যবহারের জন্য অপ্টিমাইজ করা হয়েছে এবং তাই প্লেস অটোকমপ্লিটের চেয়ে বেশি লেটেন্সি আছে। ফরওয়ার্ড জিওকোডারের কভারেজ বেশি এবং এটি আরও ভালো কোয়ালিটির ফলাফল প্রদান করে, তবে এতে কিছুটা বেশি লেটেন্সি থাকে।

আমি কীভাবে Directions API (Legacy) এবং Distance Matrix API (Legacy)-এর লেটেন্সি কমাতে পারি?

ঠিকানার পরিবর্তে, ওয়েপয়েন্ট, গন্তব্য ও শুরুর জায়গা নির্দিষ্ট করতে প্লেস আইডি ব্যবহার করুন। Places API-তে জায়গা অটোমেটিক সম্পূর্ণ করা ফিচার বা Maps JavaScript API-তে Places লাইব্রেরি থেকে জায়গার আইডি সবচেয়ে ভালভাবে পাওয়া যায়। এছাড়াও, placeIdOnly বিকল্প সম্পর্কিত তথ্য দেখুন, যা প্লেস অটোমেটিক সম্পূর্ণ করার খরচ কমাতে ব্যবহার করা যেতে পারে।

Directions API (Legacy) বা Distance Matrix API (Legacy) -তে কোনও প্লেস আইডি বা latlng-এর পরিবর্তে কোনও অ্যাড্রেস স্ট্রিং দিয়ে কোয়েরি করা হলে, সেগুলি সেই অ্যাড্রেসকে দিকনির্দেশ গণনা করার আগে প্লেস আইডিতে কনভার্ট করার জন্য Geocoding API-এর মতো একই ব্যাকএন্ড ব্যবহার করে। ঠিকানা জিওকোডিংয়ের চেয়ে 'প্লেস অটোকমপ্লিট' ফিচার দ্রুত কাজ করে। যেসব অ্যাপ্লিকেশন Directions API (Legacy) বা Distance Matrix API (Legacy) ব্যবহার করে, সেগুলির ক্ষেত্রে খুব বেশি লেটেন্সি-সংবেদনশীল পরিস্থিতিতে, যেমন ব্যবহারকারীর ইনপুটের উত্তর দেওয়ার সময়, আমরা সাজেস্ট করি যে আপনি Place Autocomplete ব্যবহার করে সেইসব ঠিকানার সাথে সম্পর্কিত প্লেস আইডি পান এবং Directions API (Legacy) বা Distance Matrix API (Legacy)-তে প্লেস আইডি পাস করুন। এই পদ্ধতি লেটেন্সি উল্লেখযোগ্যভাবে কমায়। দিকনির্দেশ সহ Place Autocomplete কীভাবে ব্যবহার করতে হয় তার উদাহরণ দেখতে আমাদের ডকুমেন্টেশন দেখুন।

জিওকোডারে কোনও সমস্যা থাকলে আমি কীভাবে অভিযোগ করব?

ফরওয়ার্ড জিওকোডার পরিষেবার জন্য আপনার কোনও বাগ রিপোর্ট বা ফিচার সংক্রান্ত অনুরোধ থাকলে, আমাদের সর্বজনীন সমস্যা ট্র্যাকার ব্যবহার করে আমাদের জানান।

আমার ব্যবহারের ক্ষেত্রে জিওকোডার ভালো ফলাফল দিচ্ছে না। কী ধরনের সাহায্য পাওয়া যাবে?

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

কম্পোনেন্ট ফিল্টারিং ব্যবহার করে জিওকোডার থেকে কীভাবে সেরা ফলাফল পাব?

জিওকোডারে, কম্পোনেন্ট ফিল্টারিং শুধুমাত্র postal_code এবং country বিধিনিষেধ প্রয়োগ করে। আপনার প্রয়োজনীয় ফলাফলের উপর নির্ভর করে, কীভাবে সবচেয়ে ভালোভাবে কম্পোনেন্ট ফিল্টারিং ব্যবহার করতে হয় তা নিম্নলিখিত উদাহরণ থেকে বুঝতে পারবেন। নমুনা অনুরোধের URL-এ, নিশ্চিত করুন যে আপনি `YOUR_API_KEY`-এর জায়গায় আপনার আসল API key লিখেছেন।

  • নির্দিষ্ট দেশে পিন কোড সীমাবদ্ধ করতে, ISO 3166-2 দেশের কোড ব্যবহার করে দেশের সীমাবদ্ধতা উল্লেখ করতে ভুলবেন না। যেমন: components=country:CH|postal_code:8000 "8000 Zürich, Switzerland" রিটার্ন করে। 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • কোনও নির্দিষ্ট দেশের জন্য কোয়েরি সীমাবদ্ধ করতে, নিশ্চিত করুন যে আপনি ISO 3166-2 দেশের কোড ব্যবহার করে দেশের উপর বিধিনিষেধ নির্দিষ্ট করেছেন। দেশ নাম ও অন্যান্য সংক্ষিপ্ত রূপ দেশ কোডের মতো একই ফলাফল নাও দিতে পারে।

    উদাহরণ:

    • components=country:FRA|locality:gallus-এর জন্য জিওকোডিং জার্মানির ফ্রাঙ্কফুর্ট অ্যাম মেনের গ্যালুসের সাবলোকালিটি রিটার্ন করে। কারণ, ফ্রান্সের (FRA) ৩-অক্ষরের কান্ট্রি কোড কাজ করে না, তাই যেকোনও দেশের ফলাফল দেখানো হয় এবং ফ্রাঙ্কফুর্টের ফলাফল ফ্রান্সের যেকোনও ফলাফলের চেয়ে বেশি প্রাসঙ্গিক। 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • Geocoding API অস্পষ্ট কোয়েরির জন্য একাধিক ফলাফল নাও দেখাতে পারে। এই ধরনের কোয়েরির উত্তর জায়গা অটোমেটিক সম্পূর্ণ করার মাধ্যমে আরও ভালোভাবে দেওয়া যায়।

    উদাহরণ:

    • components=country:US|locality:madrid-এর জন্য জিওকোডিং "Madrid, NM 87010, USA" রিটার্ন করে, কিন্তু মার্কিন যুক্তরাষ্ট্রে "Madrid" নামের অন্য কোনও শহর রিটার্ন করে না। 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • input=madrid&components=country:us&types=(regions)-এর জন্য জায়গা অটোমেটিক সম্পূর্ণ করা ব্যবহার করে এবং location ও radius ব্যবহার করে ভিউপোর্ট নির্দিষ্ট করে লোকেশন সংক্রান্ত ফলাফলকে পক্ষপাতদুষ্ট করে, "মাদ্রিদ" নামের মার্কিন যুক্তরাষ্ট্রের বিভিন্ন শহর সহ একটি উত্তর তৈরি করে। 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY