প্লেসেস এপিআই (নতুন) বিভিন্ন পদ্ধতির মাধ্যমে স্থানের ডেটার জন্য অনুরোধ গ্রহণ করে। প্লেসেস এপিআই (নতুন)-এর প্রতিক্রিয়ায় একটি স্থান সম্পর্কিত ডেটা থাকে, যার মধ্যে রয়েছে অবস্থানের ডেটা ও চিত্রাবলী, ভৌগোলিক অবস্থান এবং গুরুত্বপূর্ণ দর্শনীয় স্থান।
টেক্সট সার্চ (নতুন), নিয়ারবাই সার্চ (নতুন), এবং প্লেস ডিটেইলস (নতুন) থেকে প্রাপ্ত উত্তরে গুগল ম্যাপসের লিঙ্কও থাকতে পারে। আপনার ব্যবহারকারীরা উত্তরে থাকা কোনো স্থান সম্পর্কে অতিরিক্ত তথ্য দেখতে এই গুগল ম্যাপস লিঙ্কগুলোতে ব্রাউজ করতে পারেন।
উদাহরণস্বরূপ, আপনি ক্যালিফোর্নিয়ার সান ফ্রান্সিসকোতে বিমানবন্দর খুঁজছেন। তখন প্রাপ্ত উত্তরে স্থানগুলির তালিকায় সান ফ্রান্সিসকো আন্তর্জাতিক বিমানবন্দর (SFO) অন্তর্ভুক্ত থাকে। উত্তরে থাকা SFO-এর Place অবজেক্টটি googleMapsUri ফিল্ডটি যোগ করে, যেখানে স্থানটিতে গুগল ম্যাপস খোলার জন্য গুগল ম্যাপস লিঙ্ক, সেখানে যাওয়ার দিকনির্দেশনা, স্থানটির পর্যালোচনা এবং স্থানটির ছবি থাকে।
Place অবজেক্টে লিঙ্কগুলো যোগ করার পাশাপাশি, রেসপন্সের Reviews এবং Photos অবজেক্টগুলোতেও googleMapsUri ফিল্ডটি যোগ করা হয়:
Reviews.googleMapsUri: এতে রিভিউটির একটি গুগল ম্যাপস লিঙ্ক থাকে, যাতে আপনি এটি ব্রাউজারে দেখতে পারেন।Photos.googleMapsUri: এতে ছবিটির একটি গুগল ম্যাপস লিঙ্ক থাকে, যাতে আপনি এটি ব্রাউজারে দেখতে পারেন।
এপিআই এক্সপ্লোরার আপনাকে সরাসরি অনুরোধ করার সুযোগ দেয়, যাতে আপনি এই নতুন বিকল্পগুলোর সাথে পরিচিত হতে পারেন:
একটি স্থানের জন্য সমর্থিত গুগল ম্যাপস লিঙ্ক
নিচের সারণিতে সেই গুগল ম্যাপস লিঙ্কগুলো দেখানো হলো যা আপনি উত্তরে অন্তর্ভুক্ত করতে পারেন:
| গুগল ম্যাপস লিঙ্ক | বর্ণনা | ক্ষেত্রের নাম |
|---|---|---|
| স্থান | স্থানটির গুগল ম্যাপ খোলার লিঙ্ক। | googleMapsLinks.placeUri |
| নির্দেশনা | গুগল ম্যাপে স্থানটিতে যাওয়ার দিকনির্দেশনা খোলার লিঙ্ক। | googleMapsLinks.directionsUri |
| পর্যালোচনা লিখুন | গুগল ম্যাপসে জায়গাটির রিভিউ লেখার লিঙ্ক। | googleMapsLinks.writeAReviewUri |
| পর্যালোচনা পড়ুন | স্থানটির গুগল ম্যাপস রিভিউ দেখার লিঙ্ক। | googleMapsLinks.reviewsUri |
| ছবি | গুগল ম্যাপে স্থানটির ছবি দেখার লিঙ্ক। | googleMapsLinks.photosUri |
স্থান সম্পর্কিত উত্তরে সমস্ত লিঙ্ক অন্তর্ভুক্ত করুন।
Places রেসপন্সের লিঙ্কগুলো googleMapsLinks ফিল্ডের মধ্যে থাকে। রেসপন্সে লিঙ্কগুলো দেখাতে চাইলে, রিকোয়েস্টের ফিল্ড মাস্কে অবশ্যই googleMapsLinks ফিল্ডটি অন্তর্ভুক্ত করুন।
উদাহরণস্বরূপ, নিম্নলিখিত টেক্সট সার্চ (নতুন) এর উত্তরে সমস্ত ম্যাপ লিঙ্ক অন্তর্ভুক্ত করে:
curl -X POST -d '{
"textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'
উত্তরটি নিম্নরূপ:
{
"places": [
{
"formattedAddress": "San Francisco, CA 94128, USA",
"displayName": {
"text": "San Francisco International Airport",
"languageCode": "en"
},
"googleMapsLinks": {
"placeUri": "https://maps.google.com/?cid=11885663895765773631",
"directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
"writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
"reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
"photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
}
}
]
}উত্তরে একটি নির্দিষ্ট লিঙ্ক অন্তর্ভুক্ত করুন
রেসপন্সে সব লিঙ্ক ফেরত দেওয়ার প্রয়োজন নেই। উদাহরণস্বরূপ, যদি আপনি রেসপন্সে শুধুমাত্র 'photos' লিঙ্কটি চান, তাহলে নিচে দেখানো অনুযায়ী ফিল্ড মাস্কটি পরিবর্তন করে শুধু photosUri ফিল্ডটি অন্তর্ভুক্ত করুন:
curl -X POST -d '{
"textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'
উত্তরে নির্দেশনা অন্তর্ভুক্ত করুন।
All Places মেথডগুলো রেসপন্সে ডিরেকশন লিঙ্ক তৈরি করা সমর্থন করে। এখানে বর্তমান অবস্থানকে উৎস, স্থানের অবস্থানকে গন্তব্য এবং ভ্রমণের মাধ্যম হিসেবে ড্রাইভ ব্যবহার করা হয়।
পরবর্তী উদাহরণটিতে, রেসপন্সের directionsUri ফিল্ডে ম্যাপের দিকনির্দেশনা লিঙ্কটি অন্তর্ভুক্ত করার জন্য Nearby Search (New) ব্যবহার করা হয়েছে:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": -33.8688,
"longitude": 151.1957362},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby
রিভিউ এবং ছবির লিঙ্ক অন্তর্ভুক্ত করুন
এই রিলিজে রেসপন্সের Reviews এবং Photos অবজেক্টগুলোতে googleMapsUri ফিল্ডটি যোগ করা হয়েছে। এই লিঙ্কগুলোতে ব্রাউজ করলে রিভিউ বা ফটোটি গুগল ম্যাপসে খুলে যাবে।
উদাহরণস্বরূপ, নিম্নলিখিত টেক্সট সার্চ (নতুন)-এর উত্তরে প্রতিটি স্থানের জন্য রিভিউ এবং ছবি অন্তর্ভুক্ত থাকে:
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.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'
রেসপন্সে, রিভিউ এবং ফটো অ্যারের প্রতিটি এলিমেন্টে ব্রাউজারে রিভিউ বা ফটোটি খোলার জন্য googleMapsUri ফিল্ডটি থাকে।
চেষ্টা করে দেখুন!
এপিআই এক্সপ্লোরার আপনাকে নমুনা অনুরোধ করার সুযোগ দেয়, যাতে আপনি এপিআই এবং এর অপশনগুলোর সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে থাকা (API) আইকনটি নির্বাচন করুন।
ঐচ্ছিকভাবে 'Show standard parameters' প্রসারিত করুন এবং
fieldsপ্যারামিটারটিকে ' field mask'- এ সেট করুন।ঐচ্ছিকভাবে অনুরোধের মূল অংশটি সম্পাদনা করুন।
Execute বাটনটি নির্বাচন করুন। প্রদর্শিত ডায়ালগ বক্সে, অনুরোধটি করার জন্য আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান, সেটি বেছে নিন।
এপিআই এক্সপ্লোরার প্যানেলে, নির্বাচন করুন।
API Explorer উইন্ডোটি প্রসারিত করতে পূর্ণস্ক্রিন করুন ।