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