Region Lookup API ব্যবহার করুন

রিজিওন লুকআপ এপিআই ব্যবহার করে, আপনি অঞ্চলের জন্য স্থান আইডি খুঁজে পেতে পারেন, যা আপনি সীমানার জন্য ডেটা-চালিত স্টাইলিংয়ে সীমানা বহুভুজ স্টাইল করতে ব্যবহার করতে পারেন। রিজিওন লুকআপ এপিআই দুই ধরণের অনুরোধ সমর্থন করে:

  • অঞ্চল অনুসন্ধান স্থানের নাম, FIPS কোড (শুধুমাত্র মার্কিন যুক্তরাষ্ট্রের রাজ্য এবং কাউন্টি), অথবা ISO-3166-1 দেশের কোড দ্বারা একটি অঞ্চল অনুসন্ধান করে।
  • অঞ্চল অনুসন্ধান সেই অঞ্চলের সন্ধান করে যেখানে ঠিকানা, LatLng , অথবা স্থান আইডি দ্বারা নির্দিষ্ট একটি নির্দিষ্ট অবস্থান রয়েছে।

সমর্থিত অঞ্চলের স্থানের ধরণ

নিম্নলিখিত অঞ্চলের স্থানের ধরণগুলি সমর্থিত: country , administrative_area_level_1 , administrative_area_level_2 , postal_code , locality .

লাইব্রেরি ইনস্টল করুন

রিজিওন লুকআপ এপিআই ব্যবহার করতে, এই পদক্ষেপগুলি নিন:

  1. কনসোলে রিজিওন লুকআপ API সক্ষম করুন ।
  2. ওপেন সোর্স লাইব্রেরি ইনস্টল করুন: npm install @googlemaps/region-lookup

লাইব্রেরি থেকে নির্ভরতা আমদানি করুন

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

  • অঞ্চল অনুসন্ধানের অনুরোধের জন্য, নিম্নলিখিতগুলি আমদানি করুন:

    import {
  lookupRegion,
  LookupRegionRequestData,
  LookupRegionResponseData,
  LookupRegionResponse,
  RegionIdentifier
} from "@googlemaps/region-lookup";

  • অঞ্চল অনুসন্ধানের অনুরোধের জন্য, নিম্নলিখিতগুলি আমদানি করুন:

    import {
  searchRegion,
  RegionSearchValue,
  SearchRegionRequestData,
  SearchRegionResponse
} from "@googlemaps/region-lookup";

অঞ্চল অনুসন্ধানের অনুরোধ

একটি অঞ্চল অনুসন্ধানের অনুরোধ একটি স্থানের নাম বা শনাক্তকারী কোড নেয় এবং একটি স্থান আইডি প্রদান করে। একটি অঞ্চল অনুসন্ধান করতে, lookupRegion() কল করুন, নিম্নলিখিত পরামিতি সহ একটি LookupRegionRequestData নির্দিষ্ট করে:

  • place অথবা unit_code (প্রয়োজনীয়) অঞ্চলের নাম ( place ) অথবা স্থানের unit_code । unit_code একটি FIPS কোড (শুধুমাত্র মার্কিন যুক্তরাষ্ট্রের রাজ্য এবং কাউন্টি), অথবা ISO-3166-1 দেশের কোড হতে পারে।
  • place_type (প্রয়োজনীয়) যে ধরণের স্থান খুঁজতে হবে তার জন্য স্থানের ধরণ মান।
  • region_code অবস্থানের সাথে মিলের জন্য দুই অক্ষরের ISO-3166 দেশ/অঞ্চল কোড। place_type COUNTRY হলে region_code ঐচ্ছিক।
  • language BCP-47 ভাষা কোড, যেমন "en-US" বা "sr-Latn"। যদি কোনটিই নির্দিষ্ট না করা থাকে তবে ডিফল্ট হল en-US।

নিম্নলিখিত উদাহরণে নিউয়ার্ক, এনজে-এর জন্য একটি লুকআপ অনুরোধ দেখানো হয়েছে।

// Headers
const headers = {
  "X-Goog-Api-Key": "YOUR API KEY",
};
const data: LookupRegionRequestData = {
  identifiers: [
    {
      "place": "newark",
      "place_type": "locality",
      "region_code": "us",
      "language": "en",
    },
  ],
};
const response: LookupRegionResponse = await RegionLookup.lookupRegion({ headers, data });

place অথবা unit_code প্যারামিটারের যেকোনো একটি প্রয়োজন। যদি কোনটিই নির্দিষ্ট না করা থাকে, তাহলে একটি ত্রুটি দেখাবে।

যদি না place_type COUNTRY হয়, তাহলে region_code প্যারামিটারটি প্রয়োজন।

place এবং unit_code একটি স্থান আইডি মেলানোর জন্য একটি অবস্থান নির্দিষ্ট করে। উদাহরণস্বরূপ, যদি place "ক্যালিফোর্নিয়া" হয় এবং place_type ADMINISTRATIVE_AREA_LEVEL_1 হয়, তাহলে API ক্যালিফোর্নিয়ার স্থান আইডি matched_place_id হিসাবে ফেরত দেয়:

  • place_type : ADMINISTRATIVE_AREA_LEVEL_1

    matched_place_id ফলাফল: ক্যালিফোর্নিয়ার জন্য স্থান আইডি। অন্যান্য সমস্ত সমর্থিত প্রকার কোনও মিল ফেরত দেয় না।

যদি unit_code "6" হয় (ক্যালিফোর্নিয়ার জন্য FIPS কোড), place_type হল ADMINISTRATIVE_AREA_LEVEL_1 , এবং region_code হল "US," তাহলে API ক্যালিফোর্নিয়ার জন্য স্থান আইডি প্রদান করে:

  • place_type : ADMINISTRATIVE_AREA_LEVEL_1

  • region_code : US

    matched_place_id ফলাফল: ক্যালিফোর্নিয়ার জন্য স্থান আইডি। অন্যান্য সমস্ত সমর্থিত প্রকার কোনও মিল ফেরত দেয় না।

যদি unit_code "US" হয়, তাহলে নিম্নলিখিত place_type গুলি নির্দিষ্ট করা হলে API নিম্নলিখিত ফলাফলগুলি প্রদান করে:

  • place_type : COUNTRY

    matched_place_id ফলাফল: মার্কিন যুক্তরাষ্ট্রের জন্য স্থান আইডি। অন্যান্য সমস্ত সমর্থিত প্রকার কোনও মিল ফেরত দেয় না।

যদি কোন মিল না পাওয়া যায়, তাহলে matched_place_id সেট করা হয় না।

অস্পষ্টতার ক্ষেত্রে প্রার্থীর স্থানের আইডি ফেরত দেওয়া হয়। উদাহরণস্বরূপ, যদি place "সান্তা ক্লারা কাউন্টি" হয় এবং place_type LOCALITY হয়, তাহলে সান্তা ক্লারা কাউন্টির স্থানের আইডি প্রার্থী হিসেবে ফেরত দেওয়া হয়।

অঞ্চল অনুসন্ধানের প্রতিক্রিয়া

যদি কোনও ফলাফল পাওয়া যায়, তাহলে LookupRegionResponse অবজেক্টে একটি matched_place_id থাকে। যদি কোনও ফলাফল না পাওয়া যায়, তাহলে কম আত্মবিশ্বাসের স্থানের আইডিগুলি প্রার্থী আইডি হিসাবে ফেরত পাঠানো হয়, সাথে ডিবাগিং তথ্য সম্বলিত একটি ত্রুটি কোডও থাকে।

{
  "matches": [
    {
      "matchedPlaceId": "ChIJPV4oX_65j4ARVW8IJ6IJUYs"
    }
  ]
}

অঞ্চল অনুসন্ধানের অনুরোধ

একটি নির্দিষ্ট অবস্থান সম্বলিত অঞ্চল খুঁজে পেতে, নিম্নলিখিত প্যারামিটার সহ একটি SearchRegionRequestData উল্লেখ করে searchRegion কল করুন:

  • address অথবা latlng অথবা place_id (প্রয়োজনীয়) এতে হয় একটি অসংগঠিত ঠিকানা স্ট্রিং, latlng , অথবা অঞ্চল দ্বারা অন্তর্ভুক্ত স্থান ID থাকে (উদাহরণস্বরূপ POI, ভবন, ইত্যাদি)। যদি কোনটিই নির্দিষ্ট না করা থাকে, তাহলে একটি ত্রুটি ফেরত পাঠানো হয়।
  • place_type (প্রয়োজনীয়) যে অঞ্চলের জন্য অনুসন্ধান করা হবে তার জন্য place type মান।
  • region_code অবস্থানের সাথে মিলের জন্য দুই অক্ষরের ISO-3166 দেশ/অঞ্চল কোড। address নির্দিষ্ট করার সময় region_code প্রয়োজন।
  • language BCP-47 ভাষা কোড, যেমন "en-US" বা "sr-Latn"। যদি কোনটিই নির্দিষ্ট না করা থাকে তবে ডিফল্ট হল en-US।

নিম্নলিখিত উদাহরণটি বারব্যাঙ্ক, ক্যালিফোর্নিয়ার জন্য একটি লুকআপ অনুরোধ দেখায়।

// Headers
const headers = {
  "X-Goog-Api-Key": "YOUR API KEY",
};

const data: SearchRegionRequestData = {
  search_values: [
    {
      "address": "2627 N Hollywood Way, Burbank, CA" ,
      "place_type": "locality" as const,
      "region_code": "us"
    },
  ],
};
const response = await regionLookupClient.searchRegion({ headers, data });

অঞ্চল অনুসন্ধানের প্রতিক্রিয়া

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

{
  "matches": [
    {
      "matchedPlaceId": "ChIJPV4oX_65j4ARVW8IJ6IJUYs"
    }
  ]
}

তথ্যসূত্র

LookupRegionRequestData শনাক্তকারী

মাঠ আদর্শ বিবরণ
place স্ট্রিং একটি স্থান আইডির সাথে মিলিত অঞ্চলের নাম। অঞ্চল স্থান আইডি খুঁজতে place_type এর সাথে place ক্ষেত্রটি ব্যবহার করুন। উদাহরণস্বরূপ, যদি place_type "locality" হয়, তাহলে একটি বৈধ place "Palo Alto, CA" হতে পারে। যদি place_type `POSTAL_CODE` হয়, তাহলে একটি বৈধ স্থানের নাম "94109" হতে পারে। যদি place_type `COUNTRY` হয়, তাহলে একটি বৈধ place "মার্কিন যুক্তরাষ্ট্র" হতে পারে, ইত্যাদি। place নির্দিষ্ট করার সময় region_code প্রয়োজন, যদি না place_type `COUNTRY` হয়।
unit_code স্ট্রিং FIPs রাজ্য বা কাউন্টি কোড (শুধুমাত্র মার্কিন যুক্তরাষ্ট্র) অথবা ISO-3166-1 দেশের কোড মেলাতে হবে। অঞ্চলের স্থান আইডি খুঁজতে unit_code ক্ষেত্রটি place_type এর সাথে একত্রে ব্যবহার করা হয়। উদাহরণস্বরূপ: যদি place_type COUNTRY হয়, তাহলে একটি বৈধ ইউনিট_কোড "US" (মার্কিন যুক্তরাষ্ট্রের জন্য ISO-3166-1 Alpha-2 কোড) অথবা "BR" (ব্রাজিলের জন্য ISO-3166-1 Alpha-2 কোড) হতে পারে। যদি place_type ADMINISTRATIVE_AREA_LEVEL_1 (রাজ্য) এবং অঞ্চলের কোড "US" হয়, তাহলে একটি বৈধ ইউনিট_কোড "6" (ক্যালিফোর্নিয়ার জন্য FIP কোড) অথবা "12" (ফ্লোরিডার জন্য FIP কোড) হতে পারে। যদি place_type ADMINISTRATIVE_AREA_LEVEL_2 (কাউন্টি) হয় এবং region_code "US" হয়, তাহলে একটি বৈধ unit_code "6001" (ক্যালিফোর্নিয়ার Alameda কাউন্টির জন্য FIP কোড) অথবা "12086" (ফ্লোরিডার Miami-Dade কাউন্টির জন্য FIP কোড) হতে পারে। FIP কোড নির্দিষ্ট করার সময় region_code প্রয়োজন। ISO-3166-1 দেশের কোডের জন্য region_code উপেক্ষা করা হয়।
place_type স্থানের ধরণ প্রয়োজনীয়। মিল করার জন্য অঞ্চলের ধরণ।
region_code স্ট্রিং আপনি যে অবস্থানটি মেলানোর চেষ্টা করছেন তার জন্য দুই অক্ষরের ISO-3166 দেশ/অঞ্চল কোড। যদি place_type `COUNTRY` হয়, তাহলে region_code ঐচ্ছিক।
language_code স্ট্রিং BCP-47 ভাষা কোড, যেমন "en-US" অথবা "sr-Latn", যে ভাষায় স্থানের নাম এবং ঠিকানা অনুরোধ করা হয়েছে তার সাথে সম্পর্কিত। যদি কোনও অনুরোধ না করা হয়, তাহলে এটি ডিফল্টভাবে ইংরেজিতে ব্যবহৃত হয়।

SearchRegionRequestData শনাক্তকারী

প্রয়োজনীয়: address , latlng , অথবা place_id এর যেকোনো একটি।

মাঠ আদর্শ বিবরণ
address স্ট্রিং একটি অসংগঠিত রাস্তার ঠিকানা যা একটি অঞ্চলের ভিতরে থাকে যাতে মিল থাকে। address নির্দিষ্ট করার সময় region_code প্রয়োজন।
latlng অক্ষাংশ একটি অঞ্চলের মধ্যে থাকা অক্ষাংশ এবং দ্রাঘিমাংশ যা মেলানোর জন্য।
place_id স্ট্রিং একটি স্থান আইডি যা একটি অঞ্চলের ভিতরে থাকে যাতে মিল থাকে।
place_type স্থানের ধরণ প্রয়োজনীয়। মিল করার জন্য অঞ্চলের ধরণ।
language_code স্ট্রিং BCP-47 ভাষা কোড , যেমন "en-US" অথবা "sr-Latn", যে ভাষায় স্থানের নাম এবং ঠিকানা অনুরোধ করা হয়েছে তার সাথে সম্পর্কিত। যদি কোনও অনুরোধ না করা হয়, তাহলে এটি ডিফল্টভাবে ইংরেজিতে ব্যবহৃত হয়।
region_code স্ট্রিং অবস্থানের সাথে মিলের জন্য দুই অক্ষরের ISO-3166 দেশ/অঞ্চল কোড। ঠিকানা নির্দিষ্ট করার সময় region_code প্রয়োজন।

স্থানের ধরণ

মূল্য বিবরণ
POSTAL_CODE দেশের মধ্যে ডাক যোগাযোগের জন্য ব্যবহৃত একটি ডাক কোড।
ADMINISTRATIVE_AREA_LEVEL_1 দেশ স্তরের নীচে একটি প্রথম সারির নাগরিক সত্তা। মার্কিন যুক্তরাষ্ট্রের মধ্যে, এই প্রশাসনিক স্তরগুলি হল রাজ্য।
ADMINISTRATIVE_AREA_LEVEL_2 দেশ স্তরের নীচে একটি দ্বিতীয়-ক্রমের নাগরিক সত্তা। মার্কিন যুক্তরাষ্ট্রের মধ্যে, এই প্রশাসনিক স্তরগুলি কাউন্টি।
LOCALITY একটি অন্তর্ভুক্ত শহর বা শহরের রাজনৈতিক সত্তা।
COUNTRY জাতীয় রাজনৈতিক সত্তা, সাধারণত সর্বোচ্চ স্তরের।

অক্ষাংশ

একটি বস্তু যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া প্রতিনিধিত্ব করে। এটি ডিগ্রি অক্ষাংশ এবং ডিগ্রি দ্রাঘিমাংশ প্রতিনিধিত্ব করার জন্য দ্বিগুণের জোড়া হিসাবে প্রকাশ করা হয়। অন্যথায় নির্দিষ্ট না করা হলে, এই বস্তুটিকে WGS84 মান মেনে চলতে হবে। মানগুলি স্বাভাবিক সীমার মধ্যে থাকতে হবে।

মাঠ আদর্শ বিবরণ
latitude দ্বিগুণ ডিগ্রীতে অক্ষাংশ। এটি অবশ্যই [-90.0, +90.0] পরিসরে হতে হবে। উদাহরণস্বরূপ 47.47583476464538 ।
longitude দ্বিগুণ ডিগ্রীতে দ্রাঘিমাংশ। এটি অবশ্যই [-180.0, +180.0] পরিসরে হতে হবে। উদাহরণস্বরূপ -121.73858779269906 ।

ত্রুটি কোড

মূল্য বিবরণ
UnknownError একটি অজানা ত্রুটি ঘটেছে।
NoMatchFound অনুরোধটির ফলে কোনও মিল পাওয়া যায়নি, যদি পাওয়া যায় তাহলে candidate_place_ids পরীক্ষা করুন।
AddressNotUnderstood প্রদত্ত ঠিকানার জন্য জিওকোডিং ব্যর্থ হয়েছে।
PlaceTypeMismatch প্রতিক্রিয়ায় স্থানের ধরণটি অনুরোধের সাথে মেলে না। উদাহরণস্বরূপ, locality অনুরোধ করা হয়েছিল কিন্তু administrative_area_level_2 ফেরত দেওয়া হয়েছিল।
MultipleCandidatesFound ইনপুটের সাথে একাধিক প্রার্থী মিলেছে। যদি পাওয়া যায় তাহলে candidate_place_ids চেক করুন।
PlaceNameNotUnderstood প্রদত্ত স্থানের নামটি কোনও অঞ্চলের সাথে মিলতে ব্যর্থ হয়েছে।
UnitCodeNotFound ইউনিট কোড খুঁজে পাওয়া যায়নি। ইউনিট কোডটি বৈধ এবং সঠিক ফর্ম্যাটে দেওয়া আছে কিনা তা যাচাই করুন।
PlaceTypeNotAllowed মিলে যাওয়া স্থানের আইডিটি স্থানের ধরণ এবং দেশের অনুমোদিত তালিকায় নেই।