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

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

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

সমর্থিত অঞ্চল স্থান প্রকার

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

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

অঞ্চল লুকআপ API ব্যবহার করতে, এই পদক্ষেপগুলি নিন:

  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";

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

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

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

নিম্নলিখিত উদাহরণ Newark, NJ জন্য একটি সন্ধান অনুরোধ দেখায়.

// 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 প্যারামিটার প্রয়োজন। কোনোটি নির্দিষ্ট না থাকলে, একটি ত্রুটি ফেরত দেওয়া হয়।

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

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 হল "ইউএস", API ক্যালিফোর্নিয়ার জন্য স্থান আইডি প্রদান করে:

  • place_type : ADMINISTRATIVE_AREA_LEVEL_1

  • region_code : US

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

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

  • 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 , বা অঞ্চলের আইডি (উদাহরণস্বরূপ POI, বিল্ডিং ইত্যাদি) ধারণ করে। কোনোটি নির্দিষ্ট না থাকলে, একটি ত্রুটি ফেরত দেওয়া হয়।
  • place_type (প্রয়োজনীয়) অঞ্চলের প্রকারের জন্য স্থানের প্রকারের মান অনুসন্ধান করতে হবে।
  • region_code দুই-অক্ষরের ISO-3166 দেশ/অঞ্চল কোড মেলে অবস্থানের জন্য। address নির্দিষ্ট করা হলে region_code প্রয়োজন।
  • language BCP-47 ভাষার কোড, যেমন "en-US" বা "sr-Latn"। কোনোটি নির্দিষ্ট না থাকলে ডিফল্ট হল en-US.

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

// 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 "স্থানীয়" হয়, তাহলে একটি বৈধ place "Palo Alto, CA" হতে পারে। যদি place_type `POSTAL_CODE` হয়, তাহলে একটি বৈধ স্থান_নাম "94109" হতে পারে। যদি place_type হয় `COUNTRY`, তাহলে একটি বৈধ place হতে পারে "মার্কিন যুক্তরাষ্ট্র" ইত্যাদি। place নির্দিষ্ট করার সময় region_code প্রয়োজন যদি না place_type `COUNTRY` হয়।
unit_code স্ট্রিং FIP-এর রাজ্য বা কাউন্টি কোড (শুধুমাত্র US) বা ISO-3166-1 দেশের কোড মেলে। unit_code ক্ষেত্রটি place_type সাথে অঞ্চলের স্থান আইডি সন্ধান করতে ব্যবহার করা হয়। উদাহরণস্বরূপ: place_type যদি COUNTRY হয়, তাহলে একটি বৈধ ইউনিট_কোড হতে পারে "US" (মার্কিন যুক্তরাষ্ট্রের জন্য ISO-3166-1 আলফা-2 কোড) বা "BR" (ব্রাজিলের জন্য ISO-3166-1 আলফা-2 কোড)। যদি place_type হয় ADMINISTRATIVE_AREA_LEVEL_1 (রাজ্য) এবং অঞ্চল_কোড হয় "US", তাহলে একটি বৈধ ইউনিট_কোড হতে পারে "6" (ক্যালিফোর্নিয়ার জন্য FIPs কোড) বা "12" (ফ্লোরিডার FIPs কোড)। যদি place_type হয় ADMINISTRATIVE_AREA_LEVEL_2 (কাউন্টি) এবং অঞ্চল_কোড হয় "US", তাহলে একটি বৈধ ইউনিট_কোড হতে পারে "6001" (ক্যালিফোর্নিয়ার আলামেডা কাউন্টির জন্য FIPs কোড) বা "12086" (ফ্লোরিডার মিয়ামি-ডেড কাউন্টির FIPs কোড)। FIPs কোড নির্দিষ্ট করার সময় 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 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 জাতীয় রাজনৈতিক সত্তা, সাধারণত সর্বোচ্চ ক্রম প্রকার।

LatLng

একটি বস্তু যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া প্রতিনিধিত্ব করে। এটি ডিগ্রী অক্ষাংশ এবং ডিগ্রী দ্রাঘিমাংশের প্রতিনিধিত্ব করার জন্য এক জোড়া দ্বিগুণ হিসাবে প্রকাশ করা হয়। অন্যথায় নির্দিষ্ট করা না থাকলে, এই বস্তুটিকে অবশ্যই 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 মিলে যাওয়া জায়গার আইডি জায়গার ধরন এবং দেশের অনুমোদিত তালিকায় নেই।