Find Place (Legacy) অনুরোধ টেক্সট ইনপুট নেয় এবং একটি জায়গা রিটার্ন করে। ইনপুট যেকোনও ধরনের Places টেক্সট ডেটা হতে পারে, যেমন নাম, ঠিকানা বা ফোন নম্বর। অনুরোধটি অবশ্যই একটি স্ট্রিং হতে হবে। Find Place (Legacy) অনুরোধে স্ট্রিং নয় এমন ডেটা ব্যবহার করলে, যেমন অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট বা প্লাস কোড, তাহলে সমস্যা হয়।
Find Place (Legacy) সংক্রান্ত অনুরোধ
Find Place (Legacy) অনুরোধ হল নিম্নলিখিত ফর্মের একটি HTTP URL:
https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters
যেখানে output নিম্নলিখিত মানগুলির মধ্যে যেকোনও একটি হতে পারে:
json(সাজেস্ট করা হয়েছে) জাভাস্ক্রিপ্ট অবজেক্ট নোটেশনে (JSON) আউটপুট দেখায়xmlXML হিসেবে আউটপুট দেখায়
Find Place (Legacy) অনুরোধ শুরু করার জন্য নির্দিষ্ট কিছু প্যারামিটার প্রয়োজন। URL-এর স্ট্যান্ডার্ড অনুযায়ী, সব প্যারামিটারকে অ্যামপারস্যান্ড (&) অক্ষর ব্যবহার করে
আলাদা করা হয়।
প্রয়োজনীয় প্যারামিটার
ইনপুট
যে টেক্সট স্ট্রিংয়ে সার্চ করতে হবে। এটি অবশ্যই কোনও জায়গার নাম, ঠিকানা বা ফোন নম্বর হতে হবে (যেমন, "১২৩ মেইন স্ট্রিট" বা "সিটি হল")।
ইনপুটের ধরন
ইনপুটের ধরন। এটি textquery অথবা
phonenumber-এর মধ্যে যেকোনও একটি হতে পারে। ফোন নম্বর আন্তর্জাতিক ফর্ম্যাটে হতে হবে
(প্রথমে প্লাস চিহ্ন ("+"), তারপর দেশের কোড, তারপর
ফোন নম্বর)। আরও তথ্যের জন্য
E.164 ITU সাজেশন
দেখুন।
ঐচ্ছিক প্যারামিটার
ফিল্ড
place_id পেতে পারেন, তারপর সেই Place ID ব্যবহার করে একটি Place Details (Legacy)
অনুরোধ করতে পারেন। Place Search (Legacy) অনুরোধে উপলভ্য নয় এমন ফিল্ড সম্পর্কে আরও জানতে,
Places API ফিল্ড সংক্রান্ত সহায়তা দেখুন।
ফেরত পাঠানোর জন্য জায়গার ডেটার ধরন কমা দিয়ে আলাদা করা তালিকা হিসেবে উল্লেখ করতে
fields প্যারামিটার ব্যবহার করুন। যেমন:
fields=formatted_address,name,geometry. কম্পাউন্ড ভ্যালু উল্লেখ করার সময়
ফরওয়ার্ড স্ল্যাশ ব্যবহার করুন। যেমন:
opening_hours/open_now.
ফিল্ডগুলি তিনটি বিলিং বিভাগে বিভক্ত: প্রাথমিক, যোগাযোগ এবং পরিবেশ। বেসিক ফিল্ডের জন্য বেস রেটে বিল করা হয় এবং কন্ট্যাক্ট ও অ্যাটমোস্ফিয়ার ফিল্ডের জন্য বেশি রেটে বিল করা হয়। বেসিক, পরিচিতি ও পরিবেশ SKU-এর জন্য বেস SKU (জায়গার বিবরণ, জায়গা খোঁজা, নিয়ারবাই Search বা টেক্সট সার্চ) ছাড়াও চার্জ করা হয়। আরও তথ্যের জন্য, প্রাইসিং শিট দেখুন।
প্রাথমিক
বেসিক বিভাগে নিম্নলিখিত ফিল্ড অন্তর্ভুক্ত থাকে:
address_components, adr_address,
business_status, formatted_address,
geometry, icon, icon_mask_base_uri,
icon_background_color, name,
permanently_closed (বন্ধ করা হয়েছে), photo, place_id, plus_code,
type, url, utc_offset,
vicinity, wheelchair_accessible_entrance.
পরিচিতি
পরিচিতি বিভাগে নিম্নলিখিত ফিল্ডগুলি অন্তর্ভুক্ত থাকে:
current_opening_hours, formatted_phone_number,
international_phone_number, opening_hours,
secondary_opening_hours, website
পরিবেশ
পরিবেশ বিভাগে নিম্নলিখিত ফিল্ড অন্তর্ভুক্ত থাকে:
curbside_pickup, delivery, dine_in,
editorial_summary, price_level,
rating, reservable, reviews,
serves_beer, serves_breakfast,
serves_brunch, serves_dinner,
serves_lunch, serves_vegetarian_food,
serves_wine, takeout,
user_ratings_total.
html_attributions, সবসময় প্রতিটি কলের সাথে ফেরত দেওয়া হয়, ফিল্ডের জন্য অনুরোধ করা হয়েছে কিনা তা নির্বিশেষে।
ভাষা
যে ভাষায় ফলাফল দেখানো হবে।
- অনুমোদিত ভাষার তালিকা দেখুন। Google প্রায়ই কাজ করে এমন ভাষার তালিকা আপডেট করে, তাই এই তালিকা সম্পূর্ণ নাও হতে পারে।
-
languageপ্রদান করা না হলে, APIAccept-Languageহেডারে উল্লেখ করা পছন্দের ভাষা ব্যবহার করার চেষ্টা করে। - API এমন রাস্তার ঠিকানা প্রদান করার যথাসাধ্য চেষ্টা করে যা ব্যবহারকারী ও স্থানীয় লোকজন উভয়ের জন্যই বোধগম্য হয়। এই লক্ষ্য পূরণ করতে, এটি স্থানীয় ভাষায় রাস্তার ঠিকানা ফেরত পাঠায়, যা ব্যবহারকারীর পছন্দের ভাষা অনুযায়ী, প্রয়োজনে ব্যবহারকারীর পড়ার উপযোগী স্ক্রিপ্টে লিপ্যন্তর করা হয়। অন্যান্য সব ঠিকানা পছন্দের ভাষায় দেখানো হয়। ঠিকানার সব কম্পোনেন্ট একই ভাষায় দেখানো হয়, যা প্রথম কম্পোনেন্ট থেকে বেছে নেওয়া হয়।
- পছন্দের ভাষায় কোনও নাম উপলভ্য না থাকলে, API সবচেয়ে কাছাকাছি ম্যাচ ব্যবহার করে।
- API যে ফলাফল দেখায় এবং যে ক্রমে দেখায়, তার উপর পছন্দের ভাষার সামান্য প্রভাব থাকে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারের সংক্ষিপ্ত রূপ বা সমার্থক শব্দ যা একটি ভাষায় বৈধ হতে পারে কিন্তু অন্য ভাষায় নয়। যেমন, হাঙ্গেরিয়ান ভাষায় utca এবং tér হল রাস্তার সমার্থক শব্দ।
locationbias
নির্দিষ্ট এলাকায় ফলাফল পেতে, ব্যাসার্ধের সাথে অক্ষাংশ/দ্রাঘিমাংশ অথবা দুটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া উল্লেখ করুন যা আয়তক্ষেত্রের বিন্দুগুলিকে দেখায়। এই প্যারামিটার নির্দিষ্ট করা না থাকলে, API ডিফল্ট হিসেবে IP অ্যাড্রেস বায়াসিং ব্যবহার করে।
-
IP বায়াস: IP অ্যাড্রেস বায়াসিং ব্যবহার করার জন্য API-কে নির্দেশ দেয়। স্ট্রিং পাস করুন
ipbias(এই বিকল্পে কোনও অতিরিক্ত প্যারামিটার নেই)। -
বৃত্তাকার: মিটারে ব্যাসার্ধ এবং দশমিক ডিগ্রিতে অক্ষাংশ/দ্রাঘিমাংশ উল্লেখ করে এমন একটি স্ট্রিং। নিম্নলিখিত ফর্ম্যাট ব্যবহার করুন:
circle:radius@lat,lng। -
আয়তাকার: দশমিক ডিগ্রিতে দুটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া নির্দিষ্ট করে এমন একটি স্ট্রিং,
যা একটি আয়তক্ষেত্রের দক্ষিণ/পশ্চিম এবং উত্তর/পূর্ব পয়েন্টকে উপস্থাপন করে। নিম্নলিখিত
ফর্ম্যাট ব্যবহার করুন:
rectangle:south,west|north,east। মনে রাখবেন যে পূর্ব/পশ্চিম ভ্যালু -১৮০, ১৮০ রেঞ্জে এবং উত্তর/দক্ষিণ ভ্যালু -৯০, ৯০ রেঞ্জে সীমাবদ্ধ।
Find Place (Legacy)-এর উদাহরণ
নিম্নলিখিত উদাহরণে "Museum of Contemporary
Art Australia"-এর জন্য Find Place (Legacy) অনুরোধ দেখানো হয়েছে, যার মধ্যে photos,
formatted_address, name, rating,
opening_hours এবং geometry ফিল্ড অন্তর্ভুক্ত:
কার্ল
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'HTTP
https://maps.googleapis.com/maps/api/place/findplacefromtext/json ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry &input=Museum%20of%20Contemporary%20Art%20Australia &inputtype=textquery &key=YOUR_API_KEY
নিচের উদাহরণে "Mongolian Grill"-এর জন্য Find Place (Legacy) অনুরোধ দেখানো হয়েছে,
যেখানে locationbias প্যারামিটার ব্যবহার করে নির্দিষ্ট করা স্থানাঙ্কের
২০০০ মিটারের মধ্যে ফলাফলকে অগ্রাধিকার দেওয়া হয়েছে:
কার্ল
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'HTTP
https://maps.googleapis.com/maps/api/place/findplacefromtext/json ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry &input=Mongolian%20Grill &inputtype=textquery &locationbias=circle:2000@−33.866,151.216 &key=YOUR_API_KEY
নিম্নলিখিত উদাহরণে ফোন নম্বরের জন্য Find Place (Legacy) অনুরোধ দেখানো হয়েছে। মনে রাখবেন যে আন্তর্জাতিক কল প্রিফিক্স "+" এনকোড করে %2B করা হয়েছে যাতে এই অনুরোধটি একটি মানানসই URL হয়। আনএনকোডেড অবস্থায় রেখে দিলে, + প্রিফিক্স সার্ভারে স্পেস হিসেবে ডিকোড করা হবে, যার ফলে ফোন নম্বর লুকআপ ভুল হবে।
কার্ল
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'HTTP
https://maps.googleapis.com/maps/api/place/findplacefromtext/json ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry &input=%2B16502530000 &inputtype=phonenumber &key=YOUR_API_KEY
Find Place (Legacy) রেসপন্স
Find Place (Legacy) রেসপন্সে শুধু সেইসব ডেটার ধরন থাকে যেগুলি
fields প্যারামিটার ব্যবহার করে নির্দিষ্ট করা হয়েছে, সাথে
html_attributions। নিম্নলিখিত উদাহরণে "Museum of Contemporary Art Australia"-এর জন্য
Find Place (Legacy) অনুরোধের উত্তর দেখানো হয়েছে, যার মধ্যে
formatted_address, geometry, name,
opening_hours, photos, rating ফিল্ড অন্তর্ভুক্ত।
JSON
{ "candidates": [ { "formatted_address": "140 George St, The Rocks NSW 2000, Australia", "geometry": { "location": { "lat": -33.8599358, "lng": 151.2090295 }, "viewport": { "northeast": { "lat": -33.85824377010728, "lng": 151.2104386798927 }, "southwest": { "lat": -33.86094342989272, "lng": 151.2077390201073 }, }, }, "name": "Museum of Contemporary Art Australia", "opening_hours": { "open_now": false }, "rating": 4.4, }, ], "status": "OK", }
XML
<?xml version="1.0" encoding="UTF-8"?> <FindPlaceFromTextResponse> <candidates> <name>Museum of Contemporary Art Australia</name> <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address> <geometry> <location> <lat>-33.8599358</lat> <lng>151.2090295</lng> </location> <viewport> <southwest> <lat>-33.8609434</lat> <lng>151.2077390</lng> </southwest> <northeast> <lat>-33.8582438</lat> <lng>151.2104387</lng> </northeast> </viewport> </geometry> <rating>4.4</rating> <opening_hours> <open_now>false</open_now> </opening_hours> </candidates> <status>OK</status> </FindPlaceFromTextResponse>
PlacesFindPlaceFromTextResponse
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | Array<Place> |
এতে সম্ভাব্য জায়গার অ্যারে থাকে।
জায়গা সার্চ করা (পুরনো) সংক্রান্ত অনুরোধের ফলে ফিল্ডের একটি সাবসেট ফেরত আসে যা
জায়গার বিবরণ (পুরনো) সংক্রান্ত অনুরোধের মাধ্যমে ফেরত আসে। আপনি যে ফিল্ডটি চান সেটি যদি
Place Search (Legacy) দ্বারা ফেরত না আসে, তাহলে আপনি একটি
place_id পেতে Place Search (Legacy) ব্যবহার করতে পারেন, তারপর সেই Place ID ব্যবহার করে Place Details (Legacy) অনুরোধ করতে পারেন।
আরও তথ্যের জন্য জায়গা দেখুন। |
|
প্রয়োজনীয় | PlacesSearchStatus |
এতে অনুরোধের স্ট্যাটাস থাকে এবং অনুরোধ কেন ব্যর্থ হয়েছে তা ট্র্যাক করতে সাহায্য করার জন্য ডিবাগিং তথ্য থাকতে পারে। আরও তথ্যের জন্য PlacesSearchStatus দেখুন। |
|
ঐচ্ছিক | স্ট্রিং |
পরিষেবাটি |
|
ঐচ্ছিক | Array<string> |
পরিষেবাটি অনুরোধের স্পেসিফিকেশন সম্পর্কে অতিরিক্ত তথ্য প্রদান করলে, রেসপন্স অবজেক্টের মধ্যে একটি অতিরিক্ত
|
PlacesSearchStatus
পরিষেবা থেকে স্ট্যাটাস কোড পাঠানো হয়েছে।
OKAPI অনুরোধ সফল হয়েছে তা নির্দেশ করছে।-
ZERO_RESULTSইঙ্গিত করে যে সার্চ সফল হয়েছে কিন্তু কোনও ফলাফল পাওয়া যায়নি। এটি হতে পারে যদি সার্চটি কোনও দূরবর্তী লোকেশনেlatlngপাস করে থাকে। -
INVALID_REQUESTথেকে বোঝা যায় যে API অনুরোধটি ভুলভাবে ফর্ম্যাট করা হয়েছে, সাধারণত প্রয়োজনীয় কোয়েরি প্যারামিটার (locationবাradius) না থাকার কারণে এটি হয়। -
OVER_QUERY_LIMITনিম্নলিখিত যেকোনও একটি নির্দেশ করে:- আপনি QPS সীমা অতিক্রম করেছেন।
- আপনার অ্যাকাউন্টে বিলিং চালু করা হয়নি।
- মাসিক $২০০ ক্রেডিট বা নিজের উপর আরোপ করা ব্যবহারের সীমা অতিক্রম করা হয়েছে।
- প্রদান করা পেমেন্ট পদ্ধতি আর বৈধ নয় (যেমন, ক্রেডিট কার্ডের মেয়াদ শেষ হয়ে গেছে)।
-
REQUEST_DENIED, যা থেকে বোঝা যায় যে আপনার অনুরোধ প্রত্যাখ্যান করা হয়েছে, সাধারণত এই কারণে:- অনুরোধে API key নেই।
keyপ্যারামিটারটি সঠিক নয়।
UNKNOWN_ERRORঅজানা সমস্যার ইঙ্গিত দিচ্ছে।
জায়গা
'জায়গা সার্চ করা' ফিচারের উত্তরে
জায়গা
ফিল্ডের নিম্নলিখিত সাবসেট দেখানো হয়। সব ধরনের জায়গার জন্য সব অ্যাট্রিবিউট উপলভ্য নয়। জায়গা সার্চ করার
মাধ্যমে পাওয়া যায় না এমন ফিল্ড, যেমন
address_components, formatted_phone_number,
reviews বা website,
place_id-এর মাধ্যমে পাওয়া তথ্য
জায়গার বিবরণ (লিগ্যাসি)
অনুরোধে পাস করুন। এন্ডপয়েন্ট জুড়ে ফিল্ডের উপলভ্যতা ও দামের টিয়ার সম্পর্কে জানতে, জায়গা
ডেটা ফিল্ড (পুরনো) দেখুন।
| ফিল্ড | ধরন | বিবরণ |
|---|---|---|
business_status |
string |
এটি কোনও ব্যবসা হলে, জায়গার অপারেশনাল স্ট্যাটাস দেখায়:
OPERATIONAL, CLOSED_TEMPORARILY, অথবা
CLOSED_PERMANENTLY. স্ট্যাটাস ডেটা না থাকলে বাদ দেওয়া হয়।
|
formatted_address |
string |
এই জায়গার মানুষের-পঠনযোগ্য ঠিকানা। টেক্সট সার্চ (পুরানো) এবং
জায়গা খুঁজুন (পুরানো) দ্বারা রিটার্ন করা হয়। প্রোগ্রাম্যাটিক্যালি ফর্ম্যাট করা ঠিকানা
পার্স করবেন না; পরিবর্তে
জায়গার বিবরণ (লেগেসি)-এ
address_components
অনুরোধ করুন।
|
geometry |
Geometry
|
এতে জিওকোড করা location-এর সাথে lat ও
lng কোঅর্ডিনেট এবং পছন্দের viewport-এর সাথে
northeast ও southwest বাউন্ড থাকে।
|
icon |
string |
ম্যাপে এই ফলাফল দেখানোর সময় আপনি যে সাজেস্ট করা আইকন দেখাতে পারেন, সেটির URL। |
icon_background_color
|
string |
জায়গার বিভাগের জন্য ডিফল্ট হেক্সাডেসিমেল রঙের কোড। |
icon_mask_base_uri |
string |
সাজেস্ট করা আইকনের বেস URL, SVG বা PNG ফাইলের ধরনের এক্সটেনশন ছাড়া। |
name |
string |
ফিরে আসা ফলাফলের জন্য মানুষের-পঠনযোগ্য নাম। establishment
ফলাফলের জন্য, এই ভ্যালু সাধারণত
ক্যানোনিক্যালাইজ করা ব্যবসার নাম হয়।
|
opening_hours |
PlaceOpeningHours
|
খোলা থাকার সময় সংক্রান্ত তথ্য। 'জায়গা সার্চ' এন্ডপয়েন্ট শুধু
open_now বুলিয়ান সাবফিল্ড ফিরিয়ে দেয়;
periods এবং weekday_text-এর জন্য
'জায়গার বিবরণ (লিগ্যাসি)' থেকে
opening_hours
অনুরোধ করুন।
|
permanently_closed |
boolean |
বাতিল করা হয়েছে: কোনও ব্যবসার অপারেশনাল স্ট্যাটাস চেক করতে
business_status ব্যবহার করুন।
|
photos |
Array<PlacePhoto>
|
PlacePhoto
অবজেক্টের একটি অ্যারে, যার প্রতিটিতে একটি করে photo_reference,
height, width এবং
html_attributions আছে। ব্যবহারের বিবরণ জানতে,
জায়গার ফটো (লিগ্যাসি) দেখুন।
|
place_id |
string |
একটি টেক্সট শনাক্তকারী যা অনন্যভাবে একটি স্থান শনাক্ত করে। জায়গার বিবরণ (পুরনো)
অনুরোধের place_id প্যারামিটারে
এই আইডি
পাস করুন। প্লেস আইডি
এক নজরে
দেখুন।
|
plus_code |
PlusCode
|
অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক থেকে প্রাপ্ত একটি এনকোড করা লোকেশন রেফারেন্স, যার মধ্যে একটি global_code এবং একটি ঐচ্ছিক
compound_code থাকে।
|
price_level |
integer |
0 থেকে 4 স্কেলে জায়গার দামের লেভেল,
সবচেয়ে কম দাম থেকে সবচেয়ে বেশি দাম। price_level
দেখুন।
|
rating |
number |
ব্যবহারকারীদের দেওয়া রিভিউয়ের ভিত্তিতে, 1.0 থেকে 5.0-এর মধ্যে
জায়গার রেটিং।
|
reference |
string |
বন্ধ করা হয়েছে: পরিবর্তে place_id ব্যবহার করুন।
|
scope |
string |
ডেপ্রিকেট করা হয়েছে: place_id-এর স্কোপ নির্দেশ করে,
যা সবসময় GOOGLE হয়। নিয়ারবাই Search (লিগ্যাসি)
দ্বারা রিটার্ন করা হয়েছে।
|
types |
Array<string> |
প্রদত্ত ফলাফল বর্ণনা করে এমন ফিচার প্রকারের একটি অ্যারে। জায়গার ধরন (লিগ্যাসি) দেখুন। |
user_ratings_total |
integer |
এই জায়গার জন্য রিভিউ টেক্সট সহ বা ছাড়া মোট রেটিংয়ের সংখ্যা। |
vicinity |
string |
জায়গার একটি সহজ ঠিকানা, যার মধ্যে রাস্তার নাম, রাস্তার নম্বর এবং এলাকা অন্তর্ভুক্ত, রাজ্য বা প্রদেশ, পিন কোড বা দেশ ছাড়া। নিয়ারবাই Search (লিগ্যাসি) দ্বারা রিটার্ন করা হয়েছে। |