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