আইডি রাখুন

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

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

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

অবচয় বিজ্ঞপ্তি: অপ্রচলিত স্থান আইডি

বিজ্ঞপ্তি: 30 মার্চ, 2022 তারিখে, সমস্ত Google Maps প্ল্যাটফর্ম API কিছু অপ্রচলিত স্থানের আইডি গ্রহণ করা বন্ধ করবে। 30 মার্চ, 2022 থেকে শুরু করে, অপ্রচলিত স্থান আইডি ব্যবহার করে করা যেকোনো অনুরোধ প্রত্যাখ্যান করা হবে এবং ত্রুটি কোড INVALID_REQUEST ফেরত দেওয়া হবে। ব্যবহারকারীর অভিজ্ঞতার অবনতি রোধ করতে, অনুগ্রহ করে 30 মার্চ, 2022-এর আগে 12 মাসের বেশি পুরনো সমস্ত জায়গার আইডি রিফ্রেশ করুন ।

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

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

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

ওভারভিউ

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

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

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

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

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

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

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

স্থান 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(a) এ বর্ণিত ক্যাশিং বিধিনিষেধ থেকে প্লেস আইডিগুলিকে ছাড় দেওয়া হয়েছে ৷ আপনি তাই পরে ব্যবহারের জন্য স্থান আইডি মান সংরক্ষণ করতে পারেন.

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

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

যেমন:

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

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

দ্রষ্টব্য: একটি স্থান আইডি অবৈধ হয়ে যাওয়ার পরে প্রথম কয়েক দিনের জন্য, এই কৌশলটি এখনও 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