প্লেস আইডিগুলি অনন্যভাবে 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 জুড়ে একই স্থান আইডি ব্যবহার করতে পারেন। উদাহরণ স্বরূপ, আপনি প্লেস এপিআই , ম্যাপ জাভাস্ক্রিপ্ট এপিআই , জিওকোডিং এপিআই , ম্যাপ এম্বেড এপিআই এবং রোডস এপিআই- এ একটি স্থান উল্লেখ করতে একই স্থান আইডি ব্যবহার করতে পারেন।
স্থান আইডি ব্যবহার করে স্থান বিবরণ পুনরুদ্ধার করুন
স্থান আইডি ব্যবহার করার একটি সাধারণ উপায় হল একটি স্থান অনুসন্ধান করা (উদাহরণস্বরূপ, মানচিত্র জাভাস্ক্রিপ্ট এপিআই-এ স্থানগুলি এপিআই বা স্থান লাইব্রেরি ব্যবহার করে) তারপর স্থানের বিবরণ পুনরুদ্ধার করতে ফেরত স্থান আইডি ব্যবহার করুন। আপনি জায়গার আইডি সংরক্ষণ করতে পারেন এবং পরে একই স্থানের বিবরণ পুনরুদ্ধার করতে এটি ব্যবহার করতে পারেন। নীচে স্থান আইডি সংরক্ষণ সম্পর্কে পড়ুন.
Android এর জন্য Places SDK ব্যবহার করার উদাহরণ
Android এর জন্য Places SDK-এ, আপনি Place.getId() কল করে একটি জায়গার আইডি পুনরুদ্ধার করতে পারেন। স্থান স্বয়ংসম্পূর্ণ পরিষেবা সরবরাহ করা অনুসন্ধান ক্যোয়ারী এবং ফিল্টারের সাথে মেলে এমন প্রতিটি স্থানের জন্য একটি স্থান আইডিও প্রদান করে। পরে আবার Place অবজেক্ট পুনরুদ্ধার করতে স্থান আইডি ব্যবহার করুন।
আইডি দ্বারা একটি স্থান পেতে, একটি FetchPlaceRequest পাস করে PlacesClient.fetchPlace() এ কল করুন।
API একটি Task একটি FetchPlaceResponse প্রদান করে। FetchPlaceResponse এ সরবরাহকৃত স্থানের আইডির সাথে মিলে যাওয়া একটি Place বস্তু রয়েছে।
নিম্নলিখিত কোড উদাহরণটি নির্দিষ্ট স্থানের বিবরণ পেতে fetchPlace() কল করা দেখায়।
কোটলিন
// Define a Place ID.
val placeId = "INSERT_PLACE_ID_HERE"
// Specify the fields to return.
val placeFields = listOf(Place.Field.ID, Place.Field.NAME)
// Construct a request object, passing the place ID and fields array.
val request = FetchPlaceRequest.newInstance(placeId, placeFields)
placesClient.fetchPlace(request)
.addOnSuccessListener { response: FetchPlaceResponse ->
val place = response.place
Log.i(PlaceDetailsActivity.TAG, "Place found: ${place.name}")
}.addOnFailureListener { exception: Exception ->
if (exception is ApiException) {
Log.e(TAG, "Place not found: ${exception.message}")
val statusCode = exception.statusCode
TODO("Handle error with given status code")
}
}
জাভা
// Define a Place ID.
final String placeId = "INSERT_PLACE_ID_HERE";
// Specify the fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);
// Construct a request object, passing the place ID and fields array.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);
placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
Place place = response.getPlace();
Log.i(TAG, "Place found: " + place.getName());
}).addOnFailureListener((exception) -> {
if (exception instanceof ApiException) {
final ApiException apiException = (ApiException) exception;
Log.e(TAG, "Place not found: " + exception.getMessage());
final int statusCode = apiException.getStatusCode();
// TODO: Handle error with given status code.
}
});
পরে ব্যবহারের জন্য স্থান আইডি সংরক্ষণ করুন
Google Maps প্ল্যাটফর্ম পরিষেবার শর্তাবলীর ধারা 3.2.3(b) এ বর্ণিত ক্যাশিং বিধিনিষেধ থেকে স্থান আইডিগুলিকে ছাড় দেওয়া হয়েছে৷ আপনি তাই পরে ব্যবহারের জন্য স্থান আইডি মান সংরক্ষণ করতে পারেন.
সঞ্চিত স্থান আইডি রিফ্রেশ করা হচ্ছে
12 মাসের বেশি বয়সী হলে আমরা জায়গার আইডি রিফ্রেশ করার পরামর্শ দিই। fields প্যারামিটারে শুধুমাত্র Place.Field.ID ক্ষেত্র নির্দিষ্ট করে, স্থানের বিবরণের অনুরোধ করে আপনি কোনো চার্জ ছাড়াই প্লেস আইডি রিফ্রেশ করতে পারেন। এই কলটি স্থানের বিশদ - আইডি রিফ্রেশ 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