রিভার্স জিওকোডিং (ঠিকানা লুকআপ) অনুরোধ এবং প্রতিক্রিয়া

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ডেভেলপাররা

জিওকোডিং বলতে সাধারণত মানুষের পাঠযোগ্য কোনো ঠিকানাকে মানচিত্রের কোনো অবস্থানে রূপান্তর করাকে বোঝায়। এর বিপরীত প্রক্রিয়া, অর্থাৎ মানচিত্রের কোনো অবস্থানকে মানুষের পাঠযোগ্য ঠিকানায় রূপান্তর করাকে রিভার্স জিওকোডিং বলা হয়।

বিপরীত ভূ-কোডিং অনুরোধ

প্রয়োজনীয় প্যারামিটার

  • latlng — যে স্থানের নিকটতম, সহজে পঠনযোগ্য ঠিকানা আপনি চান, সেই স্থানের অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক।
  • key — আপনার অ্যাপ্লিকেশনের API কী। এই কী কোটা ব্যবস্থাপনার উদ্দেশ্যে আপনার অ্যাপ্লিকেশনকে শনাক্ত করে। কীভাবে একটি কী পাবেন তা জানুন।

ঐচ্ছিক পরামিতি

এগুলো হলো ঐচ্ছিক প্যারামিটার যা আপনি একটি রিভার্স জিওকোডিং অনুরোধে অন্তর্ভুক্ত করতে পারেন:

  • language — যে ভাষায় ফলাফল ফেরত দেওয়া হবে।
    • সমর্থিত ভাষাগুলোর তালিকা দেখুন। গুগল প্রায়শই সমর্থিত ভাষাগুলো হালনাগাদ করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
    • যদি language সরবরাহ করা না হয়, তাহলে জিওকোডার Accept-Language হেডারে নির্দিষ্ট করা পছন্দের ভাষা, অথবা যে ডোমেইন থেকে অনুরোধটি পাঠানো হয়েছে তার স্থানীয় ভাষা ব্যবহার করার চেষ্টা করে।
    • জিওকোডার এমন একটি রাস্তার ঠিকানা দেওয়ার জন্য যথাসাধ্য চেষ্টা করে যা ব্যবহারকারী এবং স্থানীয় বাসিন্দা উভয়ের কাছেই পাঠযোগ্য। সেই লক্ষ্য অর্জনের জন্য, এটি পছন্দের ভাষাটি অনুসরণ করে রাস্তার ঠিকানাগুলো স্থানীয় ভাষায় ফেরত দেয় এবং প্রয়োজনে ব্যবহারকারীর পাঠযোগ্য লিপিতে তা প্রতিবর্ণীকরণ করে। অন্য সব ঠিকানা পছন্দের ভাষাতেই ফেরত দেওয়া হয়। ঠিকানার সমস্ত উপাদান একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদান থেকে বেছে নেওয়া হয়।
    • পছন্দের ভাষায় কোনো নাম পাওয়া না গেলে, জিওকোডার সবচেয়ে কাছাকাছি মিল থাকা নামটি ব্যবহার করে।
  • region — অঞ্চলের কোড, যা একটি ccTLD ("টপ-লেভেল ডোমেইন") দুই-অক্ষরের মান হিসাবে নির্দিষ্ট করা হয়। এই প্যারামিটারটি প্রযোজ্য আইনের উপর ভিত্তি করে ফলাফলকেও প্রভাবিত করতে পারে।
  • result_type — এক বা একাধিক ঠিকানার প্রকারের একটি ফিল্টার, যা একটি পাইপ ( | ) দ্বারা পৃথক করা থাকে। যদি প্যারামিটারটিতে একাধিক ঠিকানার প্রকার থাকে, তাহলে API সেই সমস্ত ঠিকানা ফেরত দেয় যা যেকোনো একটি প্রকারের সাথে মেলে। প্রক্রিয়াকরণ সম্পর্কে একটি দ্রষ্টব্য: result_type প্যারামিটারটি অনুসন্ধানকে নির্দিষ্ট ঠিকানার প্রকার(গুলি)তে সীমাবদ্ধ করে না। বরং, result_type একটি অনুসন্ধান-পরবর্তী ফিল্টার হিসাবে কাজ করে: API নির্দিষ্ট latlng জন্য সমস্ত ফলাফল সংগ্রহ করে, তারপর সেই ফলাফলগুলি বাদ দেয় যা নির্দিষ্ট ঠিকানার প্রকার(গুলি)র সাথে মেলে না। নিম্নলিখিত মানগুলি সমর্থিত:

    ঠিকানার প্রকারভেদ এবং ঠিকানার উপাদানের প্রকারভেদ

    রেসপন্সের GeocodeResult বডিতে থাকা types অ্যারেটি ঠিকানার ধরন নির্দেশ করে। ঠিকানার ধরনের উদাহরণ হলো রাস্তার ঠিকানা, দেশ বা রাজনৈতিক সত্তা। GeocodeResult বডির AddressComponents ফিল্ডে থাকা types অ্যারেটি ঠিকানার প্রতিটি অংশের ধরন নির্দেশ করে। এর উদাহরণ হলো রাস্তার নম্বর বা দেশ।

    ঠিকানার একাধিক প্রকার থাকতে পারে। এই প্রকারগুলোকে 'ট্যাগ' হিসেবে বিবেচনা করা যেতে পারে। উদাহরণস্বরূপ, অনেক শহরকে political এবং locality প্রকার দিয়ে ট্যাগ করা হয়।

    অ্যাড্রেস টাইপ এবং অ্যাড্রেস কম্পোনেন্ট টাইপ উভয় অ্যারেতেই নিম্নলিখিত টাইপগুলো সমর্থিত এবং ফেরত দেওয়া হয়:

    ঠিকানার ধরণ বর্ণনা
    street_address একটি সঠিক রাস্তার ঠিকানা।
    route একটি নামযুক্ত রুট (যেমন "ইউএস ১০১")।
    intersection একটি প্রধান সংযোগস্থল, যা সাধারণত দুটি প্রধান সড়কের হয়ে থাকে।
    political একটি রাজনৈতিক সত্তা। সাধারণত, এই প্রকারটি কোনো বেসামরিক প্রশাসনের একটি সমষ্টিকে বোঝায়।
    country জাতীয় রাজনৈতিক সত্তা, এবং এটি সাধারণত জিওকোডার দ্বারা প্রত্যাবর্তিত সর্বোচ্চ ক্রমের প্রকার।
    administrative_area_level_1 দেশ স্তরের নিচের একটি প্রথম-স্তরের বেসামরিক সত্তা। মার্কিন যুক্তরাষ্ট্রের মধ্যে, এই প্রশাসনিক স্তরগুলো হলো রাজ্য। সব দেশে এই প্রশাসনিক স্তরগুলো দেখা যায় না। বেশিরভাগ ক্ষেত্রে, administrative_area_level_1 সংক্ষিপ্ত নামগুলো ISO 3166-2 উপবিভাগ এবং অন্যান্য বহুল প্রচলিত তালিকার সাথে ঘনিষ্ঠভাবে মিলে যাবে; তবে এটি নিশ্চিত নয়, কারণ আমাদের জিওকোডিং ফলাফল বিভিন্ন ধরনের সংকেত এবং অবস্থান তথ্যের উপর ভিত্তি করে তৈরি হয়।
    administrative_area_level_2 দেশ পর্যায়ের নিচের একটি দ্বিতীয়-স্তরের বেসামরিক সত্তা। মার্কিন যুক্তরাষ্ট্রের মধ্যে, এই প্রশাসনিক স্তরগুলো হলো কাউন্টি। সব দেশে এই প্রশাসনিক স্তরগুলো দেখা যায় না।
    administrative_area_level_3 দেশ পর্যায়ের নিম্নতর একটি তৃতীয়-স্তরের বেসামরিক সত্তা। এই প্রকারটি একটি ক্ষুদ্র বেসামরিক বিভাগকে নির্দেশ করে। সকল রাষ্ট্রে এই প্রশাসনিক স্তরগুলো দেখা যায় না।
    administrative_area_level_4 দেশ পর্যায়ের নিচে চতুর্থ-স্তরের একটি বেসামরিক সত্তা। এই প্রকারটি একটি ক্ষুদ্র বেসামরিক বিভাগকে নির্দেশ করে। সব দেশে এই প্রশাসনিক স্তরগুলো দেখা যায় না।
    administrative_area_level_5 দেশ পর্যায়ের নিচে পঞ্চম স্তরের একটি বেসামরিক সত্তা। এই প্রকারটি একটি ক্ষুদ্র বেসামরিক বিভাগকে নির্দেশ করে। সব দেশে এই প্রশাসনিক স্তরগুলো দেখা যায় না।
    administrative_area_level_6 দেশ পর্যায়ের নিচে ষষ্ঠ-স্তরের একটি বেসামরিক সত্তা। এই প্রকারটি একটি ক্ষুদ্র বেসামরিক বিভাগকে নির্দেশ করে। সব দেশে এই প্রশাসনিক স্তরগুলো দেখা যায় না।
    administrative_area_level_7 দেশ পর্যায়ের নিচে সপ্তম-স্তরের একটি বেসামরিক সত্তা। এই প্রকারটি একটি ক্ষুদ্র বেসামরিক বিভাগকে নির্দেশ করে। সব দেশে এই প্রশাসনিক স্তরগুলো দেখা যায় না।
    colloquial_area সত্তাটির একটি বহুল ব্যবহৃত বিকল্প নাম।
    locality একটি নিগমিত শহর বা নগর রাজনৈতিক সত্তা।
    sublocality এলাকার নিম্নস্তরের একটি প্রথম-স্তরের বেসামরিক সত্তা। কিছু অবস্থানের জন্য এটি অতিরিক্ত প্রকারগুলোর মধ্যে একটি পেতে পারে: sublocality_level_1 থেকে sublocality_level_5 । প্রতিটি উপ-এলাকা স্তর একটি বেসামরিক সত্তা। বৃহত্তর সংখ্যা একটি ছোট ভৌগোলিক এলাকা নির্দেশ করে।
    neighborhood একটি নামযুক্ত এলাকা।
    premise একটি নামযুক্ত স্থান, যা সাধারণত একটি সাধারণ নামে পরিচিত কোনো ভবন বা একাধিক ভবন নিয়ে গঠিত।
    subpremise প্রাঙ্গণ স্তরের নিচে অবস্থিত একটি ঠিকানাযোগ্য সত্তা, যেমন অ্যাপার্টমেন্ট, ইউনিট বা স্যুইট।
    plus_code অক্ষাংশ ও দ্রাঘিমাংশ থেকে প্রাপ্ত একটি এনকোডেড অবস্থান নির্দেশক। যেসব স্থানে রাস্তার ঠিকানা নেই (যেমন যেখানে ভবনগুলোর নম্বর দেওয়া নেই বা রাস্তাগুলোর নাম নেই), সেখানে রাস্তার ঠিকানার বিকল্প হিসেবে প্লাস কোড ব্যবহার করা যেতে পারে। বিস্তারিত জানতে https://plus.codes দেখুন।
    postal_code দেশের অভ্যন্তরে ডাকযোগে চিঠি পাঠানোর ঠিকানা হিসেবে পোস্টাল কোড ব্যবহার করা হয়।
    natural_feature একটি উল্লেখযোগ্য প্রাকৃতিক বৈশিষ্ট্য।
    airport একটি বিমানবন্দর।
    park একটি নামযুক্ত পার্ক।
    point_of_interest একটি নামযুক্ত দর্শনীয় স্থান। সাধারণত, এই "পিওআই" (POI) গুলো হলো স্থানীয় গুরুত্বপূর্ণ স্থান, যেগুলোকে সহজে অন্য কোনো শ্রেণিতে ফেলা যায় না, যেমন "এম্পায়ার স্টেট বিল্ডিং" বা "আইফেল টাওয়ার"।

    প্রকারের একটি খালি তালিকা নির্দেশ করে যে নির্দিষ্ট ঠিকানা উপাদানটির (উদাহরণস্বরূপ, ফ্রান্সে Lieu-dit) জন্য কোনো পরিচিত প্রকার নেই।

  • location_type — এক বা একাধিক লোকেশন টাইপের একটি ফিল্টার, যা একটি পাইপ ( | ) দ্বারা পৃথক করা থাকে। যদি প্যারামিটারটিতে একাধিক লোকেশন টাইপ থাকে, তাহলে API সেই সমস্ত ঠিকানা ফেরত দেয় যা যেকোনো একটি টাইপের সাথে মেলে। প্রসেসিং সম্পর্কে একটি নোট: location_type প্যারামিটারটি সার্চকে নির্দিষ্ট লোকেশন টাইপগুলোর মধ্যে সীমাবদ্ধ রাখে না। বরং, location_type একটি পোস্ট-সার্চ ফিল্টার হিসেবে কাজ করে: API নির্দিষ্ট latlng জন্য সমস্ত ফলাফল ফেচ করে, তারপর সেই ফলাফলগুলো বাদ দেয় যা নির্দিষ্ট লোকেশন টাইপগুলোর সাথে মেলে না। নিম্নলিখিত মানগুলো সমর্থিত:
    • "ROOFTOP" শুধুমাত্র সেই ঠিকানাগুলোই ফেরত দেয়, যেগুলোর অবস্থানের তথ্য গুগলের কাছে রাস্তার ঠিকানা পর্যন্ত নির্ভুলভাবে রয়েছে।
    • "RANGE_INTERPOLATED" শুধুমাত্র সেই ঠিকানাগুলো ফেরত দেয় যা দুটি সুনির্দিষ্ট বিন্দুর (যেমন সংযোগস্থল) মধ্যে ইন্টারপোলেট করা একটি আনুমানিক অবস্থানকে (সাধারণত রাস্তার উপর) প্রতিফলিত করে। একটি ইন্টারপোলেটেড রেঞ্জ সাধারণত নির্দেশ করে যে একটি রাস্তার ঠিকানার জন্য রুফটপ জিওকোড উপলব্ধ নেই।
    • "GEOMETRIC_CENTER" শুধুমাত্র কোনো স্থানের, যেমন একটি পলিলাইন (উদাহরণস্বরূপ, একটি রাস্তা) বা বহুভুজের (অঞ্চল), জ্যামিতিক কেন্দ্রগুলো ফেরত দেয়।
    • "APPROXIMATE" শুধুমাত্র সেই ঠিকানাগুলোই ফেরত দেয় যেগুলোকে আনুমানিক হিসেবে চিহ্নিত করা হয়।
  • extra_computations — রেসপন্সে নিম্নলিখিত অতিরিক্ত ফিচারগুলো নির্দিষ্ট করতে এই প্যারামিটারটি ব্যবহার করুন: একই API অনুরোধের জন্য এই বৈশিষ্ট্যগুলির একাধিক সক্রিয় করতে, প্রতিটি বৈশিষ্ট্যের জন্য অনুরোধে extra_computations প্যারামিটারটি অন্তর্ভুক্ত করুন, উদাহরণস্বরূপ:
    extra_computations=ADDRESS_DESCRIPTORS&extra_computations=BUILDING_AND_ENTRANCES

যদি result_type এবং location_type উভয় ফিল্টার উপস্থিত থাকে, তাহলে API শুধুমাত্র সেই ফলাফলগুলি ফেরত দেয় যা result_type এবং location_type উভয় মানের সাথে মেলে। যদি কোনো ফিল্টার মানই গ্রহণযোগ্য না হয়, তাহলে API ZERO_RESULTS ফেরত দেয়।

বিপরীত ভূ-কোডিংয়ের উদাহরণ

নিম্নলিখিত কোয়েরিটিতে ব্রুকলিনের একটি অবস্থানের অক্ষাংশ/দ্রাঘিমাংশের মান রয়েছে:

https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY

উপরের কোয়েরিটি নিম্নলিখিত ফলাফল প্রদান করে:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "277",
               "short_name" : "277",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Bedford Avenue",
               "short_name" : "Bedford Ave",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Williamsburg",
               "short_name" : "Williamsburg",
               "types" : [ "neighborhood", "political" ]
            },
            {
               "long_name" : "Brooklyn",
               "short_name" : "Brooklyn",
               "types" : [ "sublocality", "political" ]
            },
            {
               "long_name" : "Kings",
               "short_name" : "Kings",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "New York",
               "short_name" : "NY",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "11211",
               "short_name" : "11211",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "277 Bedford Avenue, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.714232,
               "lng" : -73.9612889
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.7155809802915,
                  "lng" : -73.9599399197085
               },
               "southwest" : {
                  "lat" : 40.7128830197085,
                  "lng" : -73.96263788029151
               }
            }
         },
         "place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
         "types" : [ "street_address" ]
      },

  ... Additional <code>results[]</code> ...

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

রিভার্স জিওকোডার রাজনৈতিক সত্তা (দেশ, প্রদেশ, শহর ও এলাকা), রাস্তার ঠিকানা এবং পোস্টাল কোড শনাক্ত করে।

পূর্ববর্তী কোয়েরি দ্বারা প্রাপ্ত formatted_address ভ্যালুগুলোর সম্পূর্ণ তালিকা নিচে দেখানো হলো।

{
   "plus_code" : {
      "compound_code" : "P27Q+MCM New York, NY, USA",
      "global_code" : "87G8P27Q+MCM"
   },
   "results" : [
      {
         "formatted_address" : "277 Bedford Ave, Brooklyn, NY 11211, USA",
         ...
         "types" : [ "street_address" ]
      },
      {
         "formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA",
         ...
         "types" : [ "premise" ]
      },
      {
         "formatted_address" : "277 Bedford Ave, Brooklyn, NY 11211, USA",
         ...
         "types" : [ "establishment", "point_of_interest" ]
      },
      {
         "formatted_address" : "291-275 Bedford Ave, Brooklyn, NY 11211, USA",
         ...
         "types" : [ "route" ]
      },
      {
         "formatted_address" : "P27Q+MC New York, NY, USA",
         ...
         "types" : [ "plus_code" ]
      },
      {
         "formatted_address" : "South Williamsburg, Brooklyn, NY, USA",
         ...
         "types" : [ "neighborhood", "political" ]
      },
      {
         "formatted_address" : "Brooklyn, NY 11211, USA",
         ...
         "types" : [ "postal_code" ]
      },
      {
         "formatted_address" : "Williamsburg, Brooklyn, NY, USA",
         ...
         "types" : [ "neighborhood", "political" ]
      },
      {
         "formatted_address" : "Kings County, Brooklyn, NY, USA",
         ...
         "types" : [ "administrative_area_level_2", "political" ]
      },
      {
         "formatted_address" : "Brooklyn, NY, USA",
         ...
         "types" : [ "political", "sublocality", "sublocality_level_1" ]
      },
      {
         "formatted_address" : "New York, NY, USA",
         ...
         "types" : [ "locality", "political" ]
      },
      {
         "formatted_address" : "New York, USA",
         ...
         "types" : [ "administrative_area_level_1", "political" ]
      },
      {
         "formatted_address" : "United States",
         ...
         "types" : [ "country", "political" ]
      }
   ],
   "status" : "OK"
}

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

প্রকার অনুসারে ফিল্টার করা বিপরীত ভূ-কোডিং

নিম্নলিখিত উদাহরণটি ফেরত আসা ঠিকানাগুলিকে ফিল্টার করে শুধুমাত্র সেইগুলি অন্তর্ভুক্ত করে, যেগুলির অবস্থানের ধরণ ROOFTOP এবং ঠিকানার ধরণ street_address

https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452
&location_type=ROOFTOP&result_type=street_address&key=YOUR_API_KEY

দ্রষ্টব্য: এই ফিল্টারগুলো শুধুমাত্র রিভার্স জিওকোডিংয়ের জন্য প্রযোজ্য।

বিপরীত ভূ-কোডিং প্রতিক্রিয়া

রিভার্স জিওকোডিং রেসপন্সের ফরম্যাটটি জিওকোডিং রেসপন্সের মতোই। জিওকোডিং রেসপন্সসমূহ দেখুন। নিচে একটি রিভার্স জিওকোডিং রেসপন্সে সম্ভাব্য স্ট্যাটাস কোডগুলো দেওয়া হলো।

বিপরীত ভূ-কোডিং স্থিতি কোড

জিওকোডিং রেসপন্স অবজেক্টের অন্তর্গত "status" ফিল্ডটিতে অনুরোধের অবস্থা থাকে এবং এতে ডিবাগিং তথ্যও থাকতে পারে যা রিভার্স জিওকোডিং কেন কাজ করছে না তা খুঁজে বের করতে আপনাকে সাহায্য করে। "status" ফিল্ডটিতে নিম্নলিখিত মানগুলি থাকতে পারে:

  • "OK" নির্দেশ করে যে কোনো ত্রুটি ঘটেনি এবং অন্তত একটি ঠিকানা ফেরত এসেছে।
  • "ZERO_RESULTS" নির্দেশ করে যে রিভার্স জিওকোডিং সফল হয়েছে কিন্তু কোনো ফলাফল দেয়নি। এমনটা হতে পারে যদি জিওকোডারকে কোনো দূরবর্তী স্থানের latlng দেওয়া হয়।
  • "OVER_QUERY_LIMIT" নির্দেশ করে যে আপনি আপনার কোটা অতিক্রম করেছেন।
  • "REQUEST_DENIED" নির্দেশ করে যে অনুরোধটি প্রত্যাখ্যান করা হয়েছে। সম্ভবত এর কারণ হলো, অনুরোধটিতে result_type বা location_type প্যারামিটার থাকলেও কোনো API key অন্তর্ভুক্ত নেই।
  • "INVALID_REQUEST" সাধারণত নিম্নলিখিত বিষয়গুলির মধ্যে একটিকে নির্দেশ করে:
    • কোয়েরিটি ( address , components অথবা latlng ) অনুপস্থিত।
    • একটি অবৈধ result_type বা location_type প্রদান করা হয়েছে।
  • "UNKNOWN_ERROR" নির্দেশ করে যে সার্ভার ত্রুটির কারণে অনুরোধটি প্রক্রিয়া করা যায়নি। আপনি পুনরায় চেষ্টা করলে অনুরোধটি সফল হতে পারে।

বিপরীত ভূ-কোডিং প্লাস কোড

জিওকোডিং রেসপন্সের মধ্যে থাকা plus_code ফিল্ডটিতে একটি প্লাস কোড থাকে, যা কোয়েরি করা অক্ষাংশ এবং দ্রাঘিমাংশকে সবচেয়ে ভালোভাবে আনুমানিক করে। এছাড়াও, বেশিরভাগ ক্ষেত্রে JSON রেজাল্টস অ্যারেতে ' plus_code টাইপের একটি সম্পূর্ণ জিওকোডিং রেজাল্ট এবং একটি প্লাস কোডযুক্ত ঠিকানা থাকে। ডিকোড করা প্লাস কোড এবং রিকোয়েস্ট পয়েন্টের মধ্যে দূরত্ব ১০ মিটারের কম হবে বলে নিশ্চিত করা হয়।