আইডি রাখুন

প্ল্যাটফর্ম নির্বাচন করুন: Android iOS জাভাস্ক্রিপ্ট ওয়েব পরিষেবা

প্লেস আইডিগুলি অনন্যভাবে Google Places ডাটাবেসে এবং Google মানচিত্রে একটি স্থান চিহ্নিত করে৷ নিম্নলিখিত মানচিত্র API-এর অনুরোধে স্থান আইডি গৃহীত হয়:

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

একটি নির্দিষ্ট জায়গার আইডি খুঁজুন

আপনি কি একটি নির্দিষ্ট জায়গার আইডি খুঁজছেন? একটি জায়গা অনুসন্ধান করতে এবং তার আইডি পেতে নীচের স্থান আইডি সন্ধানকারী ব্যবহার করুন:

বিকল্পভাবে, আপনি Maps JavaScript API ডকুমেন্টেশনে এর কোড সহ প্লেস আইডি ফাইন্ডার দেখতে পারেন।

ওভারভিউ

একটি স্থান আইডি একটি পাঠ্য শনাক্তকারী যা একটি স্থানকে অনন্যভাবে সনাক্ত করে। শনাক্তকারীর দৈর্ঘ্য পরিবর্তিত হতে পারে (স্থান আইডিগুলির জন্য সর্বাধিক দৈর্ঘ্য নেই)। উদাহরণ:

  • ChIJgUbEo8cfqokR5lP9_Wh_DaM
  • GhIJQWDl0CIeQUARxks3icF8U8A
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
  • IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ

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

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

স্থান আইডি ব্যবহার করে স্থান বিবরণ পুনরুদ্ধার করুন

স্থান আইডি ব্যবহার করার একটি সাধারণ উপায় হল একটি স্থান অনুসন্ধান করা (উদাহরণস্বরূপ, মানচিত্র জাভাস্ক্রিপ্ট এপিআই-এ স্থানগুলি এপিআই বা স্থান লাইব্রেরি ব্যবহার করে) তারপর স্থানের বিবরণ পুনরুদ্ধার করতে ফেরত স্থান আইডি ব্যবহার করুন। আপনি জায়গার আইডি সংরক্ষণ করতে পারেন এবং পরে একই স্থানের বিবরণ পুনরুদ্ধার করতে এটি ব্যবহার করতে পারেন। নীচে স্থান আইডি সংরক্ষণ সম্পর্কে পড়ুন.

নিম্নলিখিত উদাহরণগুলি দেখায় কিভাবে স্থান API (নতুন) এবং স্থান API-এর জন্য একটি আইকন URL অনুরোধ করতে হয়৷

স্থান API (নতুন)

Places API ব্যবহার করে, আপনি টেক্সট সার্চ (নতুন) অনুরোধ করে একটি জায়গার আইডি খুঁজে পেতে পারেন।

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'

প্রতিক্রিয়া id ক্ষেত্রে একটি স্থান আইডি অন্তর্ভুক্ত, নীচে দেখানো হিসাবে:

{
  "places": [
    {
      "id": "ChIJs5ydyTiuEmsR0fRSlU0C7k0",
      "formattedAddress": "29 King St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Peace Harmony",
        "languageCode": "en"
      }
    },
  ...
}

এখন আপনি অনুরোধ URL-এ স্থান আইডি অন্তর্ভুক্ত করে একটি স্থানের বিবরণ (নতুন) অনুরোধ করতে পারেন: 

https://places.googleapis.com/v1/places/ChIJs5ydyTiuEmsR0fRSlU0C7k0?fields=id,displayName&key=API_KEY

স্থান API

Places API ব্যবহার করে, আপনি একটি স্থান অনুসন্ধান অনুরোধ করে একটি স্থান আইডি খুঁজে পেতে পারেন।

নিম্নলিখিত উদাহরণটি অস্ট্রেলিয়ার সিডনিতে একটি বিন্দুর 1500 মিটার ব্যাসার্ধের মধ্যে 'রেস্তোরাঁ' টাইপের জায়গাগুলির জন্য অনুসন্ধানের অনুরোধ, যেখানে 'ক্রুজ' শব্দটি রয়েছে:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY

প্রতিক্রিয়াটিতে place_id ক্ষেত্রে একটি স্থান আইডি রয়েছে, যেমনটি এই স্নিপেটে দেখানো হয়েছে:

{
  "html_attributions" : [],
  "results" : [
    {
      "geometry" : {
        "location" : {
          "lat" : -33.870775,
          "lng" : 151.199025
        }
      },
      ...
      "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
      ...
    }
  ],
  "status" : "OK"
}

এখন আপনি place_id প্যারামিটারে স্থান আইডি রেখে একটি স্থানের বিবরণের অনুরোধ পাঠাতে পারেন: 

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&key=YOUR_API_KEY

পরে ব্যবহারের জন্য স্থান আইডি সংরক্ষণ করুন

Google Maps প্ল্যাটফর্ম পরিষেবার শর্তাবলীর ধারা 3.2.3(b) এ বর্ণিত ক্যাশিং বিধিনিষেধ থেকে স্থান আইডিগুলিকে ছাড় দেওয়া হয়েছে৷ আপনি তাই পরে ব্যবহারের জন্য স্থান আইডি মান সংরক্ষণ করতে পারেন.

সঞ্চিত স্থান আইডি রিফ্রেশ করা হচ্ছে

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

স্থান API (নতুন)

উদাহরণস্বরূপ, স্থানের বিবরণ ব্যবহার করে (নতুন) : 

https://places.googleapis.com/v1/places/ChIJ05IRjKHxEQ0RJLV_5NLdK2w?fields=id&key=API_KEY

স্থান API

উদাহরণস্বরূপ, উত্তরাধিকার স্থান বিবরণ API ব্যবহার করে:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJ05IRjKHxEQ0RJLV_5NLdK2w&fields=place_id&key=API_KEY

এই কলটি স্থানের বিবরণ নতুন (শুধুমাত্র আইডি) বা স্থানের বিবরণ - আইডি রিফ্রেশ SKU ট্রিগার করে।

এই অনুরোধটি NOT_FOUND স্ট্যাটাস কোডও ফেরত দিতে পারে। একটি কৌশল হল আসল অনুরোধটি সংরক্ষণ করা যা প্রতিটি স্থানের আইডি ফেরত দেয়। যদি একটি স্থান আইডি অবৈধ হয়ে যায়, আপনি নতুন ফলাফল পেতে সেই অনুরোধটি পুনরায় ইস্যু করতে পারেন। এই ফলাফল মূল স্থান অন্তর্ভুক্ত বা নাও হতে পারে. যাইহোক, এই অনুরোধ চার্জযোগ্য.

স্থান আইডি ব্যবহার করার সময় ত্রুটি কোড

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

NOT_FOUND স্ট্যাটাস কোড নির্দেশ করে যে নির্দিষ্ট জায়গার আইডি অপ্রচলিত। একটি ব্যবসা বন্ধ বা একটি নতুন অবস্থানে চলে গেলে একটি স্থান আইডি অপ্রচলিত হতে পারে। Google Maps ডাটাবেসে বড় আকারের আপডেটের কারণে স্থান আইডি পরিবর্তিত হতে পারে। এই ধরনের ক্ষেত্রে, একটি স্থান একটি নতুন স্থান আইডি পেতে পারে, এবং পুরানো আইডি একটি NOT_FOUND প্রতিক্রিয়া প্রদান করে৷

বিশেষ করে, কিছু ধরণের স্থান আইডি কখনও কখনও একটি NOT_FOUND প্রতিক্রিয়ার কারণ হতে পারে, বা API প্রতিক্রিয়াতে একটি ভিন্ন স্থান আইডি ফেরত দিতে পারে৷ এই স্থানের আইডি প্রকারগুলি অন্তর্ভুক্ত:

  • রাস্তার ঠিকানাগুলি যেগুলি Google মানচিত্রে সুনির্দিষ্ট ঠিকানা হিসাবে বিদ্যমান নেই, তবে ঠিকানাগুলির একটি পরিসর থেকে অনুমান করা হয়েছে৷
  • একটি দীর্ঘ রুটের সেগমেন্ট, যেখানে অনুরোধটি একটি শহর বা এলাকাও নির্দিষ্ট করে।
  • ছেদ.
  • টাইপ subpremise এর ঠিকানা উপাদান সহ স্থানগুলি।

এই আইডিগুলি প্রায়শই একটি দীর্ঘ স্ট্রিংয়ের রূপ নেয় (স্থানীয় আইডিগুলির জন্য সর্বাধিক দৈর্ঘ্য নেই)। যেমন:

EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4