Places API (নতুন) বিভিন্ন পদ্ধতির মাধ্যমে জায়গার ডেটার জন্য অনুরোধ গ্রহণ করে। Places API (নতুন) উত্তরের মধ্যে কোনও জায়গা সম্পর্কিত ডেটা থাকে, যার মধ্যে লোকেশন ডেটা ও ছবি, ভৌগোলিক লোকেশন এবং আগ্রহের গুরুত্বপূর্ণ পয়েন্ট অন্তর্ভুক্ত।
এছাড়াও, টেক্সট সার্চ (নতুন), আশেপাশের সার্চ (নতুন) এবং জায়গার বিবরণ (নতুন) থেকে পাওয়া উত্তরে Google Maps-এর লিঙ্ক থাকতে পারে। আপনার ব্যবহারকারীরা উত্তরের মধ্যে কোনও জায়গা সম্পর্কে অতিরিক্ত তথ্য দেখতে এইসব Google Maps লিঙ্ক ব্রাউজ করতে পারবেন।
যেমন, আপনি ক্যালিফোর্নিয়ার সান ফ্রান্সিসকোতে বিমানবন্দর সার্চ করেছেন। উত্তরে
তারপরে জায়গার তালিকায় সান ফ্রান্সিসকো আন্তর্জাতিক বিমানবন্দর (SFO) অন্তর্ভুক্ত করা হয়েছে।
উত্তরে SFO-এর জন্য Place
অবজেক্টে googleMapsUri ফিল্ড যোগ করা হয়েছে যাতে
Google Maps-এর লিঙ্ক রয়েছে। এই লিঙ্কে ক্লিক করলে Google Maps-এ জায়গাটি খুলে যাবে,
জায়গাটির দিকনির্দেশ, রিভিউ ও ফটো দেখা যাবে।
Place অবজেক্টে যোগ করা লিঙ্কগুলির সাথে, googleMapsUri ফিল্ডও
রেসপন্সে থাকা
Reviews
ও
Photos
অবজেক্টে যোগ করা হয়েছে:
Reviews.googleMapsUri: রিভিউতে Google Maps-এর লিঙ্ক থাকে যাতে আপনি ব্রাউজারে এটি দেখতে পারেন।Photos.googleMapsUri: ফটোতে Google Maps লিঙ্ক থাকে যাতে আপনি এটি ব্রাউজারে দেখতে পারেন।
API Explorer আপনাকে লাইভ অনুরোধ করার সুবিধা দেয় যাতে আপনি এইসব নতুন বিকল্পের সাথে পরিচিত হতে পারেন:
কোনও জায়গার জন্য কাজ করে এমন Google Maps লিঙ্ক
নিচে দেওয়া সারণীতে Google Maps-এর সেইসব লিঙ্ক দেখানো হয়েছে যা আপনি উত্তরে যোগ করতে পারবেন:
| Google Maps লিঙ্ক | বিবরণ | ফিল্ডের নাম |
|---|---|---|
| জায়গা | জায়গাটি Google Maps-এ খুলতে লিঙ্ক। | googleMapsLinks.placeUri |
| দিকনির্দেশ | Google Maps-এ জায়গাটির দিকনির্দেশ খোলার লিঙ্ক। | googleMapsLinks.directionsUri |
| রিভিউ লিখুন | Google Maps-এ জায়গাটির জন্য রিভিউ লেখার লিঙ্ক। | googleMapsLinks.writeAReviewUri |
| রিভিউ পড়ুন | জায়গাটির Google Maps রিভিউ দেখানোর লিঙ্ক। | googleMapsLinks.reviewsUri |
| ফটো | Google Maps-এ জায়গাটির ফটো দেখানোর লিঙ্ক। | googleMapsLinks.photosUri |
Places-এর উত্তরে সব লিঙ্ক অন্তর্ভুক্ত করুন
জায়গার উত্তরে থাকা লিঙ্কগুলি
googleMapsLinks
ফিল্ডে থাকে। আপনি যদি চান যে সেগুলি উত্তরে দেখানো হোক, তাহলে নিশ্চিত করুন যে আপনি
অনুরোধের ফিল্ড মাস্কে googleMapsLinks ফিল্ড অন্তর্ভুক্ত করেছেন।
যেমন, নিম্নলিখিত টেক্সট সার্চ (নতুন) ফিচারে উত্তরের মধ্যে সব Maps লিঙ্ক অন্তর্ভুক্ত থাকে:
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"
}
}
]
}উত্তরে নির্দিষ্ট লিঙ্ক অন্তর্ভুক্ত করা
আপনাকে উত্তরে সব লিঙ্ক দিতে হবে না। যেমন, আপনি যদি উত্তরে শুধুমাত্র
ফটো লিঙ্ক চান, তাহলে শুধুমাত্র 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'
উত্তরে দিকনির্দেশ অন্তর্ভুক্ত করা
সব Places পদ্ধতিতে উত্তরের মধ্যে দিকনির্দেশ সংক্রান্ত লিঙ্ক তৈরি করা যায়। বর্তমান লোকেশনকে অরিজিন হিসেবে, জায়গার লোকেশনকে ডেস্টিনেশন হিসেবে এবং ভ্রমণের মোডকে ড্রাইভ হিসেবে ব্যবহার করা হয়।
পরের উদাহরণে, Nearby Search (নতুন) ব্যবহার করে directionsUri ফিল্ডে ম্যাপের দিকনির্দেশ
লিঙ্ককে উত্তরের মধ্যে অন্তর্ভুক্ত করা হয়েছে:
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
রিভিউ ও ফটোর লিঙ্ক যোগ করুন
এই রিলিজে, উত্তরে googleMapsUri ফিল্ডটি
Reviews
এবং
Photos
অবজেক্টে যোগ করা হয়েছে। এইসব লিঙ্কে ব্রাউজ করলে Google Maps-এ রিভিউ বা ফটো
খোলে।
যেমন, নিম্নলিখিত টেক্সট সার্চ (নতুন) ফিচারে প্রতিটি জায়গার জন্য রিভিউ ও ফটো অন্তর্ভুক্ত থাকে:
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 এক্সপ্লোরার আপনাকে নমুনা অনুরোধ করতে দেয় যাতে আপনি API ও API বিকল্প সম্পর্কে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে API আইকন বেছে নিন ।
প্রয়োজন হলে, স্ট্যান্ডার্ড প্যারামিটার দেখুন বিকল্পটি বড় করুন এবং
fieldsপ্যারামিটার ফিল্ড মাস্ক হিসেবে সেট করুন।প্রয়োজন হলে অনুরোধের মূল অংশ এডিট করুন।
এক্সিকিউট করুন বোতাম বেছে নিন। ডায়ালগে, অনুরোধ করার জন্য আপনি যে অ্যাকাউন্ট ব্যবহার করতে চান সেটি বেছে নিন।
API Explorer প্যানেলে, বেছে নিন
API Explorer উইন্ডো বড় করতে ফুলস্ক্রিন বিকল্পে ক্লিক করুন।