ভূমিকা
প্লেস আইডিগুলি অনন্যভাবে Google Places ডাটাবেসে এবং Google মানচিত্রে একটি স্থান চিহ্নিত করে৷ নিম্নলিখিত মানচিত্র API-এর অনুরোধে স্থান আইডি গৃহীত হয়:
- জিওকোডিং এপিআই এবং জিওকোডিং সার্ভিস, ম্যাপ জাভাস্ক্রিপ্ট এপিআই-এ একটি প্লেস আইডির জন্য একটি ঠিকানা পুনরুদ্ধার করা হচ্ছে।
- রুট API এবং নির্দেশাবলী API (উত্তরাধিকার) এবং দিকনির্দেশ পরিষেবা, মানচিত্র জাভাস্ক্রিপ্ট API (উত্তরাধিকার) এ উত্স, গন্তব্য এবং মধ্যবর্তী পথপয়েন্টগুলি নির্দিষ্ট করা।
- Routes API এবং Distance Matrix API (Legacy) এবং Distance Matrix Service, Maps JavaScript API (Legacy) তে উৎপত্তি ও গন্তব্য উল্লেখ করা।
- 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) এ বর্ণিত ক্যাশিং বিধিনিষেধ থেকে স্থান আইডিগুলিকে ছাড় দেওয়া হয়েছে৷ আপনি তাই পরে ব্যবহারের জন্য স্থান আইডি মান সংরক্ষণ করতে পারেন.
সঞ্চিত স্থান আইডি রিফ্রেশ করুন
যেহেতু Google Maps ডাটাবেসে আপডেটের কারণে প্লেস আইডি পরিবর্তিত হতে পারে, তাই Google 12 মাসের বেশি বয়সী হলে জায়গা আইডি রিফ্রেশ করার পরামর্শ দেয়। fields প্যারামিটারে শুধুমাত্র স্থান আইডি ক্ষেত্র নির্দিষ্ট করে একটি স্থানের বিবরণ অনুরোধ করে আপনি কোনো চার্জ ছাড়াই প্লেস আইডি রিফ্রেশ করতে পারেন।
স্থান API (নতুন)
উদাহরণস্বরূপ, স্থানের বিবরণ ব্যবহার করে (নতুন) :
https://places.googleapis.com/v1/places/ChIJ05IRjKHxEQ0RJLV_5NLdK2w?fields=id&key=API_KEY
স্থান API (উত্তরাধিকার)
উদাহরণস্বরূপ, Places API (উত্তরাধিকার) ব্যবহার করে :
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJ05IRjKHxEQ0RJLV_5NLdK2w&fields=place_id&key=API_KEY
এই কলটি স্থানের বিশদ বিবরণ নতুন অপরিহার্য আইডি শুধুমাত্র বা স্থানের বিবরণ - আইডি রিফ্রেশ SKU ট্রিগার করে।
স্থান আইডি ব্যবহার করার সময় ত্রুটি কোড
INVALID_REQUEST
INVALID_REQUEST স্ট্যাটাস কোড নির্দেশ করে যে নির্দিষ্ট স্থান আইডি বৈধ নয়। INVALID_REQUEST ফেরত দেওয়া হতে পারে যখন জায়গার আইডি ছেঁটে ফেলা হয়েছে বা অন্যভাবে সংশোধন করা হয়েছে, এবং আর সঠিক নয়৷
NOT_FOUND
NOT_FOUND স্ট্যাটাস কোড নির্দেশ করে যে নির্দিষ্ট জায়গার আইডি অপ্রচলিত। একটি ব্যবসা বন্ধ বা একটি নতুন অবস্থানে চলে গেলে একটি স্থান আইডি অপ্রচলিত হতে পারে। Google Maps ডাটাবেসের আপডেটের কারণে স্থানের আইডিও পরিবর্তিত হতে পারে। এই ধরনের ক্ষেত্রে, একটি স্থান একটি নতুন স্থান আইডি পেতে পারে, এবং পুরানো আইডি একটি NOT_FOUND প্রতিক্রিয়া প্রদান করে৷
একটি অপ্রচলিত স্থান আইডির ক্ষেত্রে ফলাফল রিফ্রেশ করতে, প্রতিটি স্থানের আইডি ফিরিয়ে দেওয়া আসল অনুরোধটি সংরক্ষণ করুন এবং প্রয়োজন অনুসারে অনুরোধটি পুনরায় জারি করুন। মনে রাখবেন যে পুনরায় জারি করা অনুরোধটি উপযুক্ত SKU-এ বিল করা হয়।
কিছু ধরণের স্থান আইডি কখনও কখনও একটি NOT_FOUND প্রতিক্রিয়া সৃষ্টি করতে পারে, অথবা API প্রতিক্রিয়াতে একটি ভিন্ন স্থানের ID প্রদান করতে পারে৷ এই স্থানের আইডি প্রকারগুলি অন্তর্ভুক্ত:
- রাস্তার ঠিকানাগুলি যেগুলি Google মানচিত্রে সুনির্দিষ্ট ঠিকানা হিসাবে বিদ্যমান নেই, তবে ঠিকানাগুলির একটি পরিসর থেকে অনুমান করা হয়েছে৷
- একটি দীর্ঘ রুটের সেগমেন্ট, যেখানে অনুরোধটি একটি শহর বা এলাকাও নির্দিষ্ট করে।
- ছেদ.
- টাইপ
subpremiseএর ঠিকানা উপাদান সহ স্থানগুলি।
এই আইডিগুলি প্রায়শই একটি দীর্ঘ স্ট্রিংয়ের রূপ নেয় (স্থানীয় আইডিগুলির জন্য সর্বাধিক দৈর্ঘ্য নেই)। যেমন:
EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4