একবার কোনো স্থান অনুসন্ধান থেকে place_id পেয়ে গেলে, আপনি একটি Place Details (Legacy) অনুরোধ শুরু করার মাধ্যমে কোনো নির্দিষ্ট প্রতিষ্ঠান বা দর্শনীয় স্থান সম্পর্কে আরও বিস্তারিত তথ্য চাইতে পারেন। একটি Place Details (Legacy) অনুরোধ উল্লিখিত স্থানটি সম্পর্কে আরও বিশদ তথ্য প্রদান করে, যেমন এর সম্পূর্ণ ঠিকানা, ফোন নম্বর, ব্যবহারকারীর রেটিং এবং পর্যালোচনা।
স্থানের বিবরণ (ঐতিহ্যগত) অনুরোধ
একটি প্লেস ডিটেইলস (লেগ্যাসি) অনুরোধ হলো নিম্নলিখিত ফর্মের একটি HTTP URL:
https://maps.googleapis.com/maps/api/place/details/output?parameters
যেখানে output নিম্নলিখিত মানগুলির যেকোনো একটি হতে পারে:
-
json(প্রস্তাবিত) জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন (JSON) ফরম্যাটে আউটপুট নির্দেশ করে। -
xmlবলতে আউটপুটকে XML হিসেবে বোঝায়।
অনুসন্ধানের অনুরোধ শুরু করার জন্য নির্দিষ্ট কিছু প্যারামিটার প্রয়োজন হয়। ইউআরএল-এর প্রচলিত রীতি অনুযায়ী, সমস্ত প্যারামিটার অ্যামপারস্যান্ড ( & ) চিহ্ন দিয়ে আলাদা করা হয়। নিচে প্যারামিটার এবং তাদের সম্ভাব্য মানগুলোর একটি তালিকা দেওয়া হলো।
প্রয়োজনীয় প্যারামিটার
স্থান_আইডি
একটি পাঠ্য শনাক্তকারী যা কোনো স্থানকে অনন্যভাবে চিহ্নিত করে এবং যা স্থান অনুসন্ধান (Place Search) থেকে পাওয়া যায়। স্থান আইডি সম্পর্কে আরও তথ্যের জন্য, স্থান আইডি সংক্ষিপ্ত বিবরণ (place ID overview ) দেখুন।
ঐচ্ছিক পরামিতি
ক্ষেত্রগুলি
সতর্কতা: প্লেস সার্চ রিকোয়েস্ট এবং প্লেস ডিটেইলস রিকোয়েস্ট একই ফিল্ড ফেরত দেয় না। প্লেস সার্চ রিকোয়েস্ট, প্লেস ডিটেইলস রিকোয়েস্ট দ্বারা ফেরত আসা ফিল্ডগুলোর একটি উপসেট ফেরত দেয়। যদি আপনার কাঙ্ক্ষিত ফিল্ডটি প্লেস সার্চ দ্বারা ফেরত না আসে, তাহলে আপনি প্লেস সার্চ ব্যবহার করে একটিplace_idপেতে পারেন, এবং তারপর সেই প্লেস আইডি ব্যবহার করে একটি প্লেস ডিটেইলস রিকোয়েস্ট করতে পারেন। প্লেস সার্চ রিকোয়েস্টে যে ফিল্ডগুলো অনুপলব্ধ, সে সম্পর্কে আরও তথ্যের জন্য প্লেসেস এপিআই ফিল্ডস সাপোর্ট দেখুন।ফেরত পাওয়ার জন্য স্থানের ডেটা টাইপগুলোর একটি কমা-বিভক্ত তালিকা নির্দিষ্ট করতে fields প্যারামিটারটি ব্যবহার করুন। উদাহরণস্বরূপ:
fields=formatted_address,name,geometry। যৌগিক মান নির্দিষ্ট করার সময় একটি ফরওয়ার্ড স্ল্যাশ ব্যবহার করুন। উদাহরণস্বরূপ:opening_hours/open_now।ফিল্ডগুলোকে তিনটি বিলিং ক্যাটাগরিতে ভাগ করা হয়েছে: বেসিক , কন্টাক্ট এবং অ্যাটমোস্ফিয়ার । যে অনুরোধের ফলে বেসিক, কন্টাক্ট এবং অ্যাটমোস্ফিয়ার SKU-গুলো সক্রিয় হয়েছে, তার বেস SKU (প্লেসেস ডিটেইলস, ফাইন্ড প্লেস, নিয়ারবাই সার্চ বা টেক্সট সার্চ)-এর সাথে অতিরিক্তভাবে এগুলোর জন্য চার্জ করা হয়। আরও তথ্যের জন্য, প্রাইসিং শিটটি দেখুন।
মৌলিক
বেসিক ক্যাটাগরিতে নিম্নলিখিত ফিল্ডগুলো অন্তর্ভুক্ত রয়েছে:
address_components,adr_address,business_status,formatted_address,geometry,icon,icon_mask_base_uri,icon_background_color,name,permanently_closed( deprecated ),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_vegetarian_foodserves_lunch,serves_wine,takeout,user_ratings_total।দ্রষ্টব্য: অ্যাট্রিবিউশনhtml_attributions) প্রতিটি কলের সাথেই ফেরত দেওয়া হয়, ফিল্ডটির জন্য অনুরোধ করা হয়েছে কি না তা নির্বিশেষে।ভাষা
যে ভাষায় ফলাফল ফেরত দেওয়া হয়।
- সমর্থিত ভাষাগুলোর তালিকা দেখুন। গুগল প্রায়শই সমর্থিত ভাষাগুলো হালনাগাদ করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
- যদি
languageসরবরাহ করা না হয়, তাহলে API-টিAccept-Languageহেডারে নির্দিষ্ট করা পছন্দের ভাষাটি ব্যবহার করার চেষ্টা করে। - এপিআইটি ব্যবহারকারী এবং স্থানীয় বাসিন্দা উভয়ের জন্য পাঠযোগ্য একটি রাস্তার ঠিকানা প্রদান করার জন্য যথাসাধ্য চেষ্টা করে। সেই লক্ষ্য অর্জনের জন্য, এটি পছন্দের ভাষাটি অনুসরণ করে রাস্তার ঠিকানাগুলো স্থানীয় ভাষায় ফেরত দেয় এবং প্রয়োজনে ব্যবহারকারীর পাঠযোগ্য লিপিতে তা প্রতিবর্ণীকরণ করে। অন্য সব ঠিকানা পছন্দের ভাষাতেই ফেরত দেওয়া হয়। ঠিকানার সমস্ত উপাদান একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদানটি থেকে বেছে নেওয়া হয়।
- পছন্দের ভাষায় কোনো নাম উপলব্ধ না থাকলে, এপিআই সবচেয়ে কাছাকাছি মিল থাকা নামটি ব্যবহার করে।
- এপিআই যে ফলাফলগুলো ফেরত দেবে এবং সেগুলো যে ক্রমে ফেরত আসবে, তার ওপর পছন্দের ভাষার সামান্য প্রভাব রয়েছে। জিওকোডার ভাষার ওপর নির্ভর করে সংক্ষিপ্ত রূপগুলোকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারভেদের সংক্ষিপ্ত রূপ, অথবা এমন সমার্থক শব্দ যা একটি ভাষায় বৈধ হলেও অন্যটিতে নয়। উদাহরণস্বরূপ, হাঙ্গেরীয় ভাষায় 'utca' এবং 'tér' হলো রাস্তার সমার্থক শব্দ।
অঞ্চল
অঞ্চল কোডটি একটি ccTLD ("টপ-লেভেল ডোমেইন") দুই-অক্ষরের মান হিসাবে নির্দিষ্ট করা হয়। কিছু উল্লেখযোগ্য ব্যতিক্রম ছাড়া, বেশিরভাগ ccTLD কোড ISO 3166-1 কোডের অনুরূপ। উদাহরণস্বরূপ, যুক্তরাজ্যের ccTLD হলো "uk" (.co.uk), যেখানে এর ISO 3166-1 কোড হলো "gb" (যা প্রযুক্তিগতভাবে "দ্য ইউনাইটেড কিংডম অফ গ্রেট ব্রিটেন অ্যান্ড নর্দার্ন আয়ারল্যান্ড" সত্তাটির জন্য ব্যবহৃত হয়)।
পর্যালোচনা_কোন_অনুবাদ নেই
রিভিউয়ের অনুবাদ বন্ধ করতে
reviews_no_translations=trueউল্লেখ করুন; অনুবাদ চালু করতেreviews_no_translations=falseউল্লেখ করুন। রিভিউগুলো তাদের মূল ভাষাতেই ফেরত দেওয়া হবে।যদি এটি বাদ দেওয়া হয়, বা কোনো মান ছাড়া পাস করা হয়, তাহলে রিভিউগুলির অনুবাদ সক্রিয় থাকে। যদি অনুরোধে
languageপ্যারামিটারটি নির্দিষ্ট করা থাকে, তাহলে অনুবাদের জন্য পছন্দের ভাষা হিসেবে নির্দিষ্ট ভাষাটি ব্যবহার করা হবে। যদিlanguageবাদ দেওয়া হয়, তাহলে API পছন্দের ভাষা হিসেবেAccept-Languageহেডারটি ব্যবহার করার চেষ্টা করে।পর্যালোচনা_সাজান
রিভিউ দেখানোর সময় যে সাজানোর পদ্ধতিটি ব্যবহার করা হবে।
most_relevant(ডিফল্ট) অথবাnewestহিসেবে সেট করা যেতে পারে।-
most_relevant(ডিফল্ট) বিকল্পটির ক্ষেত্রে, রিভিউগুলো প্রাসঙ্গিকতা অনুসারে সাজানো হয়; পরিষেবাটি পছন্দের ভাষায় মূলত লেখা রিভিউগুলো দেখানোর জন্য ফলাফলকে পক্ষপাতদুষ্ট করবে। -
newestরিভিউগুলো কালানুক্রমিকভাবে সাজানো হয়; পছন্দের ভাষা এই সাজানোর ক্রমকে প্রভাবিত করে না।
গুগল পরামর্শ দেয় যে, রিভিউগুলো কীভাবে সাজানো হচ্ছে তা আপনি ব্যবহারকারীকে দেখান।
-
সেশনটোকেন
একটি এলোমেলো স্ট্রিং যা বিলিংয়ের উদ্দেশ্যে একটি অটোকমপ্লিট সেশনকে শনাক্ত করে।
ব্যবহারকারী যখন কোনো কোয়েরি টাইপ করা শুরু করেন, তখন সেশনটি শুরু হয় এবং যখন তিনি একটি স্থান নির্বাচন করে 'প্লেস ডিটেইলস'-এ কল করেন, তখন এটি শেষ হয়। প্রতিটি সেশনে একাধিক কোয়েরি থাকতে পারে, যার পরে একটি স্থান নির্বাচন করতে হয়। একটি সেশনের মধ্যে প্রতিটি অনুরোধের জন্য ব্যবহৃত এপিআই কী (API key) অবশ্যই একই গুগল ক্লাউড কনসোল প্রজেক্টের অন্তর্ভুক্ত হতে হবে। একবার একটি সেশন শেষ হয়ে গেলে, টোকেনটি আর বৈধ থাকে না; আপনার অ্যাপকে প্রতিটি সেশনের জন্য একটি নতুন টোকেন তৈরি করতে হবে। যদি
sessiontokenপ্যারামিটারটি বাদ দেওয়া হয়, অথবা যদি আপনি একটি সেশন টোকেন পুনরায় ব্যবহার করেন, তাহলে সেশনটির জন্য এমনভাবে চার্জ করা হবে যেন কোনো সেশন টোকেন প্রদান করা হয়নি (প্রতিটি অনুরোধের জন্য আলাদাভাবে বিল করা হয়)।আমরা নিম্নলিখিত নির্দেশিকাগুলো সুপারিশ করছি:
- সমস্ত অটোকমপ্লিট সেশনের জন্য সেশন টোকেন ব্যবহার করুন।
- প্রতিটি সেশনের জন্য একটি নতুন টোকেন তৈরি করুন। ভার্সন ৪ UUID ব্যবহার করার পরামর্শ দেওয়া হয়।
- নিশ্চিত করুন যে একটি সেশনের মধ্যে সমস্ত 'Place Autocomplete' এবং 'Place Details' অনুরোধের জন্য ব্যবহৃত API কী(গুলি) একই ক্লাউড কনসোল প্রজেক্টের অন্তর্গত।
- প্রতিটি নতুন সেশনের জন্য একটি অনন্য সেশন টোকেন প্রদান করতে ভুলবেন না। একাধিক সেশনের জন্য একই টোকেন ব্যবহার করলে প্রতিটি অনুরোধের জন্য আলাদাভাবে বিল করা হবে।
স্থানের বিবরণ (লেগ্যাসি) উদাহরণ
নিম্নলিখিত উদাহরণটি place_id দ্বারা কোনো স্থানের বিবরণ জানতে চায় এবং এতে name , rating , ও formatted_phone_number ফিল্ডগুলো অন্তর্ভুক্ত রয়েছে:
খোলস
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'
HTTP
https://maps.googleapis.com/maps/api/place/details/json ?fields=name%2Crating%2Cformatted_phone_number &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4 &key=YOUR_API_KEY
মনে রাখবেন, আপনার অ্যাপ্লিকেশনে অনুরোধটি কাজ করার জন্য এই উদাহরণে থাকা কী-টি আপনার নিজের এপিআই কী (API key) দিয়ে প্রতিস্থাপন করতে হবে।
স্থানের বিবরণ (ঐতিহ্যগত) প্রতিক্রিয়া
প্লেস ডিটেইলস (লেগ্যাসি) রেসপন্সগুলো রিকোয়েস্টের ইউআরএল পাথের মধ্যে থাকা output ফ্ল্যাগ দ্বারা নির্দেশিত ফরম্যাটে ফেরত দেওয়া হয়।
JSON
{ "html_attributions": [], "result": { "address_components": [ { "long_name": "48", "short_name": "48", "types": ["street_number"] }, { "long_name": "Pirrama Road", "short_name": "Pirrama Rd", "types": ["route"], }, { "long_name": "Pyrmont", "short_name": "Pyrmont", "types": ["locality", "political"], }, { "long_name": "City of Sydney", "short_name": "City of Sydney", "types": ["administrative_area_level_2", "political"], }, { "long_name": "New South Wales", "short_name": "NSW", "types": ["administrative_area_level_1", "political"], }, { "long_name": "Australia", "short_name": "AU", "types": ["country", "political"], }, { "long_name": "2009", "short_name": "2009", "types": ["postal_code"], }, ], "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia", "business_status": "OPERATIONAL", "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia", "formatted_phone_number": "(02) 9374 4000", "geometry": { "location": { "lat": -33.866489, "lng": 151.1958561 }, "viewport": { "northeast": { "lat": -33.8655112697085, "lng": 151.1971156302915 }, "southwest": { "lat": -33.86820923029149, "lng": 151.1944176697085 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "international_phone_number": "+61 2 9374 4000", "name": "Google Workplace 6", "opening_hours": { "open_now": false, "periods": [ { "close": { "day": 1, "time": "1700" }, "open": { "day": 1, "time": "0900" }, }, { "close": { "day": 2, "time": "1700" }, "open": { "day": 2, "time": "0900" }, }, { "close": { "day": 3, "time": "1700" }, "open": { "day": 3, "time": "0900" }, }, { "close": { "day": 4, "time": "1700" }, "open": { "day": 4, "time": "0900" }, }, { "close": { "day": 5, "time": "1700" }, "open": { "day": 5, "time": "0900" }, }, ], "weekday_text": [ "Monday: 9:00 AM – 5:00 PM", "Tuesday: 9:00 AM – 5:00 PM", "Wednesday: 9:00 AM – 5:00 PM", "Thursday: 9:00 AM – 5:00 PM", "Friday: 9:00 AM – 5:00 PM", "Saturday: Closed", "Sunday: Closed", ], }, "photos": [ { "height": 3024, "html_attributions": [ "Cynthia Wei", ], "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX", "width": 4032, }, { "height": 3264, "html_attributions": [ "Heyang Li", ], "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI", "width": 4912, }, { "height": 3036, "html_attributions": [ "Anna Linetsky", ], "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1", "width": 4048, }, { "height": 4016, "html_attributions": [ "Jonah Dell", ], "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD", "width": 6016, }, { "height": 3024, "html_attributions": [ "Anthony Huynh", ], "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9", "width": 4032, }, { "height": 3024, "html_attributions": [ "Jasen Baker", ], "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x", "width": 4032, }, { "height": 3024, "html_attributions": [ "Jeremy Hsiao", ], "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk", "width": 4032, }, { "height": 1515, "html_attributions": [ "Andrew W", ], "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI", "width": 2048, }, { "height": 3024, "html_attributions": [ "Jeremy Hsiao", ], "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39", "width": 4032, }, { "height": 4032, "html_attributions": [ "Jeremy Hsiao", ], "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas", "width": 3024, }, ], "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4", "plus_code": { "compound_code": "45MW+C8 Pyrmont NSW, Australia", "global_code": "4RRH45MW+C8", }, "rating": 4, "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4", "reviews": [ { "author_name": "Luke Archibald", "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "a week ago", "text": "Beautiful building with a great view.", "time": 1652286798, }, { "author_name": "Tevita Taufoou", "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "6 months ago", "text": "Conference rooms were well equipped.", "time": 1637215605, }, { "author_name": "Jordy Baker", "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "4 months ago", "text": "The staff is very friendly.", "time": 1641389490, }, { "author_name": "Prem Rathod", "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "4 months ago", "text": "The location is convenient and easy to find.", "time": 1640159655, }, { "author_name": "Husuni Hamza", "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo", "rating": 5, "relative_time_description": "7 months ago", "text": "A modern and impressive facility.", "time": 1633197305, }, ], "types": ["point_of_interest", "establishment"], "url": "https://maps.google.com/?cid=10281119596374313554", "user_ratings_total": 939, "utc_offset": 600, "vicinity": "48 Pirrama Road, Pyrmont", "website": "http://google.com/", }, "status": "OK", }
এক্সএমএল
<?xml version="1.0" encoding="UTF-8"?> <PlaceDetailsResponse> <status>OK</status> <result> <name>Google Workplace 6</name> <vicinity>48 Pirrama Road, Pyrmont</vicinity> <type>point_of_interest</type> <type>establishment</type> <formatted_phone_number>(02) 9374 4000</formatted_phone_number> <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address> <address_component> <long_name>48</long_name> <short_name>48</short_name> <type>street_number</type> </address_component> <address_component> <long_name>Pirrama Road</long_name> <short_name>Pirrama Rd</short_name> <type>route</type> </address_component> <address_component> <long_name>Pyrmont</long_name> <short_name>Pyrmont</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>City of Sydney</long_name> <short_name>City of Sydney</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>New South Wales</long_name> <short_name>NSW</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>Australia</long_name> <short_name>AU</short_name> <type>country</type> <type>political</type> </address_component> <address_component> <long_name>2009</long_name> <short_name>2009</short_name> <type>postal_code</type> </address_component> <geometry> <location> <lat>-33.8664890</lat> <lng>151.1958561</lng> </location> <viewport> <southwest> <lat>-33.8682092</lat> <lng>151.1944177</lng> </southwest> <northeast> <lat>-33.8655113</lat> <lng>151.1971156</lng> </northeast> </viewport> </geometry> <rating>4.0</rating> <url>https://maps.google.com/?cid=10281119596374313554</url> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference> <international_phone_number>+61 2 9374 4000</international_phone_number> <website>http://google.com/</website> <review> <time>1652286798</time> <text>Beautiful building with a great view.</text> <author_name>Luke Archibald</author_name> <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>a week ago</relative_time_description> </review> <review> <time>1637215605</time> <text>Conference rooms were well equipped.</text> <author_name>Joe Schmoe</author_name> <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>6 months ago</relative_time_description> </review> <review> <time>1641389490</time> <text>The staff is very friendly.</text> <author_name>Jordy Baker</author_name> <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>4 months ago</relative_time_description> </review> <review> <time>1640159655</time> <text>The location is convenient and easy to find.</text> <author_name>Prem Rathod</author_name> <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>4 months ago</relative_time_description> </review> <review> <time>1633197305</time> <text>A modern and impressive facility.</text> <author_name>Husuni Hamza</author_name> <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url> <rating>5.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>7 months ago</relative_time_description> </review> <opening_hours> <open_now>false</open_now> <period> <open> <day>1</day> <time>0900</time> </open> <close> <day>1</day> <time>1700</time> </close> </period> <period> <open> <day>2</day> <time>0900</time> </open> <close> <day>2</day> <time>1700</time> </close> </period> <period> <open> <day>3</day> <time>0900</time> </open> <close> <day>3</day> <time>1700</time> </close> </period> <period> <open> <day>4</day> <time>0900</time> </open> <close> <day>4</day> <time>1700</time> </close> </period> <period> <open> <day>5</day> <time>0900</time> </open> <close> <day>5</day> <time>1700</time> </close> </period> <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Saturday: Closed</weekday_text> <weekday_text>Sunday: Closed</weekday_text> </opening_hours> <utc_offset>600</utc_offset> <photo> <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/117600448889234589608">Cynthia Wei</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference> <width>4912</width> <height>3264</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102493344958625549078">Heyang Li</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference> <width>4048</width> <height>3036</height> <html_attribution><a href="https://maps.google.com/maps/contrib/104829437842034782235">Anna Linetsky</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference> <width>6016</width> <height>4016</height> <html_attribution><a href="https://maps.google.com/maps/contrib/107755640736541028674">Jonah Dell</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/115886271727815775491">Anthony Huynh</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102939237947063969663">Jasen Baker</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference> <width>2048</width> <height>1515</height> <html_attribution><a href="https://maps.google.com/maps/contrib/112343109286948028063">Andrew W</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference> <width>3024</width> <height>4032</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <adr_address><span class="street-address">48 Pirrama Rd</span>, <span class="locality">Pyrmont</span> <span class="region">NSW</span> <span class="postal-code">2009</span>, <span class="country-name">Australia</span></adr_address> <user_ratings_total>939</user_ratings_total> <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id> <plus_code> <global_code>4RRH45MW+C8</global_code> <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> </PlaceDetailsResponse>
JSON এবং XML উভয় রেসপন্সেই নিম্নলিখিত উপাদানগুলো থাকে:
স্থান বিবরণ প্রতিক্রিয়া
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| প্রয়োজনীয় | অ্যারে<স্ট্রিং> | এই লিস্টিং সম্পর্কিত কিছু তথ্য এতে থাকতে পারে যা ব্যবহারকারীকে অবশ্যই দেখানো হবে (কিছু লিস্টিং-এ তথ্য নাও থাকতে পারে)। |
| প্রয়োজনীয় | স্থান | অনুরোধকৃত স্থানটি সম্পর্কে বিস্তারিত তথ্য রয়েছে। আরও তথ্যের জন্য স্থানটি দেখুন। |
| প্রয়োজনীয় | স্থান বিবরণ অবস্থা | এতে অনুরোধের অবস্থা থাকে এবং অনুরোধটি কেন ব্যর্থ হয়েছে তা খুঁজে বের করতে সাহায্য করার জন্য ডিবাগিং তথ্যও থাকতে পারে। আরও তথ্যের জন্য PlacesDetailsStatus দেখুন। |
| ঐচ্ছিক | অ্যারে<স্ট্রিং> | যখন পরিষেবাটি অনুরোধের বিবরণ সম্পর্কে অতিরিক্ত তথ্য ফেরত দেয়, তখন রেসপন্স অবজেক্টের মধ্যে একটি অতিরিক্ত |
একটি JSON রেসপন্সে, এগুলো রুট এলিমেন্ট হিসেবে উপস্থাপিত হয়। একটি XML রেসপন্সে, এগুলো <PlaceDetailsResponse> এর নিচে টপ-লেভেল এলিমেন্ট হিসেবে প্রদর্শিত হয়।
স্থান বিবরণ অবস্থা
পরিষেবা দ্বারা ফেরত দেওয়া স্ট্যাটাস কোড।
-
OKনির্দেশ করে যে এপিআই অনুরোধটি সফল হয়েছে। -
ZERO_RESULTSনির্দেশ করে যে উল্লেখিত স্থান (place_id) বৈধ ছিল, কিন্তু এখন আর কোনো বৈধ ফলাফলকে নির্দেশ করে না। প্রতিষ্ঠানটি যদি আর ব্যবসায় না থাকে, তবে এমনটি ঘটতে পারে। -
NOT_FOUNDনির্দেশ করে যে উল্লেখিত স্থান,place_id, Places ডেটাবেসে খুঁজে পাওয়া যায়নি। -
INVALID_REQUESTনির্দেশ করে যে এপিআই অনুরোধটি ত্রুটিপূর্ণ ছিল। -
OVER_QUERY_LIMITনিম্নলিখিত যেকোনো একটি নির্দেশ করে:- আপনি QPS সীমা অতিক্রম করেছেন।
- আপনার অ্যাকাউন্টে বিলিং চালু করা হয়নি।
- মাসিক ২০০ ডলারের ক্রেডিট, বা স্বেচ্ছায় নির্ধারিত ব্যবহারের সীমা, অতিক্রম করা হয়েছে।
- প্রদত্ত অর্থপ্রদানের পদ্ধতিটি আর বৈধ নয় (উদাহরণস্বরূপ, ক্রেডিট কার্ডের মেয়াদ শেষ হয়ে গেছে)।
-
REQUEST_DENIEDনির্দেশ করে যে আপনার অনুরোধটি প্রত্যাখ্যান করা হয়েছে, সাধারণত নিম্নলিখিত কারণে:- অনুরোধটিতে একটি এপিআই কী নেই।
-
keyপ্যারামিটারটি অবৈধ।
-
UNKNOWN_ERRORএকটি অজানা ত্রুটি নির্দেশ করে।
স্থান
কোনো স্থানের বর্ণনাকারী বৈশিষ্ট্যসমূহ। সব ধরনের স্থানের জন্য সকল বৈশিষ্ট্য উপলব্ধ নাও হতে পারে।
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| ঐচ্ছিক | অ্যারে< AddressComponent > | এই ঠিকানার জন্য প্রযোজ্য পৃথক উপাদানসমূহ ধারণকারী একটি অ্যারে। আরও তথ্যের জন্য |
| ঐচ্ছিক | স্ট্রিং | এডিআর মাইক্রোফরম্যাটে স্থানটির ঠিকানার একটি উপস্থাপনা। |
| ঐচ্ছিক | স্ট্রিং | স্থানটি যদি একটি ব্যবসা হয়, তবে এটি তার পরিচালনগত অবস্থা নির্দেশ করে। কোনো ডেটা না থাকলে,
The allowed values include: OPERATIONAL ,
CLOSED_TEMPORARILY , and CLOSED_PERMANENTLY
|
| ঐচ্ছিক | বুলিয়ান | ব্যবসাটি কার্বসাইড পিকআপ সমর্থন করে কিনা তা উল্লেখ করে। |
| ঐচ্ছিক | স্থান খোলার সময় | এতে আগামী সাত দিনের (আজ সহ) কার্যঘণ্টা রয়েছে। এই সময়কাল অনুরোধের তারিখের মধ্যরাতে শুরু হয় এবং ছয় দিন পর রাত ১১:৫৯ মিনিটে শেষ হয়। এই ফিল্ডটিতে সমস্ত কার্যঘণ্টার আরও তথ্যের জন্য স্থানটির খোলার সময়সূচী দেখুন। |
| ঐচ্ছিক | বুলিয়ান | ব্যবসাটি ডেলিভারি সমর্থন করে কিনা তা নির্দিষ্ট করে। |
| ঐচ্ছিক | বুলিয়ান | ব্যবসা প্রতিষ্ঠানটিতে ভেতরে নাকি বাইরে বসার ব্যবস্থা আছে, তা উল্লেখ করে। |
| ঐচ্ছিক | স্থান সম্পাদকীয় সারসংক্ষেপ | স্থানটির একটি সারসংক্ষেপ রয়েছে। সারসংক্ষেপটি একটি লিখিত বিবরণ নিয়ে গঠিত এবং প্রযোজ্য ক্ষেত্রে এর ভাষা কোডও অন্তর্ভুক্ত থাকে। সারসংক্ষেপের লেখাটি হুবহু উপস্থাপন করতে হবে এবং এটি পরিবর্তন বা পরিমার্জন করা যাবে না। আরও তথ্যের জন্য স্থান-সম্পাদকীয় সারাংশ দেখুন। |
| ঐচ্ছিক | স্ট্রিং | এই স্থানটির পাঠযোগ্য ঠিকানা সম্বলিত একটি স্ট্রিং। অনেক ক্ষেত্রে এই ঠিকানাটি ডাক ঠিকানার সমতুল্য হয়। উল্লেখ্য যে, যুক্তরাজ্যসহ কিছু দেশ লাইসেন্স সংক্রান্ত বিধিনিষেধের কারণে প্রকৃত ডাক ঠিকানা বিতরণের অনুমতি দেয় না। বিন্যাসকৃত ঠিকানাটি যৌক্তিকভাবে এক বা একাধিক ঠিকানার উপাদান দ্বারা গঠিত। উদাহরণস্বরূপ, "111 8th Avenue, New York, NY" ঠিকানাটি নিম্নলিখিত উপাদানগুলি নিয়ে গঠিত: "111" (রাস্তার নম্বর), "8th Avenue" (পথ), "New York" (শহর) এবং "NY" (মার্কিন যুক্তরাষ্ট্রের রাজ্য)। প্রোগ্রাম্যাটিকভাবে ফরম্যাট করা ঠিকানা পার্স করবেন না। এর পরিবর্তে, আপনার ঠিকানার স্বতন্ত্র উপাদানগুলো ব্যবহার করা উচিত, যা এপিআই রেসপন্সে ফরম্যাট করা ঠিকানা ফিল্ডের পাশাপাশি অন্তর্ভুক্ত থাকে। |
| ঐচ্ছিক | স্ট্রিং | স্থানটির ফোন নম্বরটি তার স্থানীয় বিন্যাসে রয়েছে। |
| ঐচ্ছিক | Geometry | এতে অবস্থান এবং সেই অবস্থানের ভিউপোর্ট রয়েছে। আরও তথ্যের জন্য |
| ঐচ্ছিক | স্ট্রিং | এতে একটি প্রস্তাবিত আইকনের URL রয়েছে, যা মানচিত্রে এই ফলাফলটি নির্দেশ করার সময় ব্যবহারকারীকে দেখানো যেতে পারে। |
| ঐচ্ছিক | স্ট্রিং | স্থানটির ক্যাটাগরির জন্য ডিফল্ট হেক্স কালার কোড অন্তর্ভুক্ত রয়েছে। |
| ঐচ্ছিক | স্ট্রিং | এতে একটি প্রস্তাবিত আইকনের ইউআরএল রয়েছে, তবে এতে |
| ঐচ্ছিক | স্ট্রিং | এতে স্থানটির ফোন নম্বর আন্তর্জাতিক ফরম্যাটে থাকে। আন্তর্জাতিক ফরম্যাটে দেশের কোড অন্তর্ভুক্ত থাকে এবং এর আগে প্লাস (+) চিহ্নটি থাকে। উদাহরণস্বরূপ, অস্ট্রেলিয়ার সিডনিতে অবস্থিত গুগলের অফিসের আন্তর্জাতিক ফোন নম্বরটি হলো |
| ঐচ্ছিক | স্ট্রিং | ফেরত আসা ফলাফলের পাঠযোগ্য নামটি এতে থাকে। |
| ঐচ্ছিক | স্থান খোলার সময় | এতে নিয়মিত কার্যক্রমের সময়সূচী রয়েছে। আরও তথ্যের জন্য স্থানটির খোলার সময়সূচী দেখুন। |
| ঐচ্ছিক | বুলিয়ান | ব্যবসাগুলোর পরিচালনগত অবস্থা জানতে |
| ঐচ্ছিক | অ্যারে< প্লেসফটো > | |
| ঐচ্ছিক | স্ট্রিং | একটি পাঠ্য শনাক্তকারী যা কোনো স্থানকে অনন্যভাবে চিহ্নিত করে। স্থানটি সম্পর্কে তথ্য পেতে, একটি প্লেসেস এপিআই (Places API) অনুরোধের |
| ঐচ্ছিক | PlusCode | অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্ক থেকে প্রাপ্ত একটি এনকোডেড অবস্থান নির্দেশক, যা ১/৮০০০ ডিগ্রি × ১/৮০০০ ডিগ্রি (নিরক্ষীয় অঞ্চলে প্রায় ১৪মি × ১৪মি) বা তার চেয়ে ছোট একটি এলাকাকে প্রতিনিধিত্ব করে। যেসব স্থানে রাস্তার ঠিকানা নেই (যেমন যেখানে ভবনগুলোর নম্বর দেওয়া নেই বা রাস্তাগুলোর নাম নেই), সেখানে রাস্তার ঠিকানার বিকল্প হিসেবে প্লাস কোড ব্যবহার করা যেতে পারে। ওপেন লোকেশন কোড এবং প্লাস কোড দেখুন। আরও তথ্যের জন্য |
| ঐচ্ছিক | সংখ্যা | স্থানটির মূল্যস্তর, ০ থেকে ৪ এর স্কেলে। একটি নির্দিষ্ট মান দ্বারা নির্দেশিত সঠিক পরিমাণ অঞ্চলভেদে ভিন্ন হবে। মূল্যস্তরকে নিম্নরূপে ব্যাখ্যা করা হয়:
|
| ঐচ্ছিক | সংখ্যা | এতে ব্যবহারকারীদের সম্মিলিত পর্যালোচনার উপর ভিত্তি করে স্থানটির রেটিং রয়েছে, যা ১.০ থেকে ৫.০ পর্যন্ত। |
| ঐচ্ছিক | স্ট্রিং | |
| ঐচ্ছিক | বুলিয়ান | স্থানটিতে রিজার্ভেশন করা যায় কিনা তা নির্দিষ্ট করে। |
| ঐচ্ছিক | অ্যারে< স্থান পর্যালোচনা > | সর্বোচ্চ পাঁচটি রিভিউ সম্বলিত একটি JSON অ্যারে। ডিফল্টরূপে, রিভিউগুলো প্রাসঙ্গিকতা অনুসারে সাজানো থাকে। সর্টিং নিয়ন্ত্রণ করতে
ফলাফলগুলো আরও তথ্যের জন্য প্লেসরিভিউ দেখুন। |
| ঐচ্ছিক | স্ট্রিং | |
| ঐচ্ছিক | অ্যারে< স্থান খোলার সময় > | এতে পরবর্তী সাত দিনের জন্য বিভিন্ন এন্ট্রির একটি অ্যারে থাকে, যার মধ্যে একটি ব্যবসার সেকেন্ডারি আওয়ার বা দ্বিতীয় পর্যায়ের কর্মঘন্টা সম্পর্কিত তথ্যও অন্তর্ভুক্ত। সেকেন্ডারি আওয়ার বা দ্বিতীয় পর্যায়ের কর্মঘন্টা একটি ব্যবসার মূল কর্মঘন্টা থেকে ভিন্ন। উদাহরণস্বরূপ, একটি রেস্তোরাঁ তার সেকেন্ডারি আওয়ার বা দ্বিতীয় পর্যায়ের কর্মঘন্টা হিসেবে ড্রাইভ-থ্রু আওয়ার বা ডেলিভারি আওয়ার নির্দিষ্ট করতে পারে। এই ফিল্ডটি আরও তথ্যের জন্য স্থানটির খোলার সময়সূচী দেখুন। |
| ঐচ্ছিক | বুলিয়ান | স্থানটিতে বিয়ার পাওয়া যায় কিনা তা উল্লেখ করে। |
| ঐচ্ছিক | বুলিয়ান | স্থানটিতে সকালের নাস্তা পরিবেশন করা হয় কিনা তা উল্লেখ করে। |
| ঐচ্ছিক | বুলিয়ান | স্থানটিতে ব্রাঞ্চ পরিবেশন করা হয় কিনা তা উল্লেখ করে। |
| ঐচ্ছিক | বুলিয়ান | স্থানটিতে রাতের খাবার পরিবেশন করা হয় কিনা তা উল্লেখ করে। |
| ঐচ্ছিক | বুলিয়ান | স্থানটিতে দুপুরের খাবার পরিবেশন করা হয় কিনা তা উল্লেখ করে। |
| ঐচ্ছিক | বুলিয়ান | স্থানটিতে নিরামিষ খাবার পরিবেশন করা হয় কিনা তা উল্লেখ করুন। |
| ঐচ্ছিক | বুলিয়ান | স্থানটিতে ওয়াইন পরিবেশন করা হয় কিনা তা উল্লেখ করে। |
| ঐচ্ছিক | বুলিয়ান | ব্যবসাটি টেকআউট সমর্থন করে কিনা তা উল্লেখ করে। |
| ঐচ্ছিক | অ্যারে<স্ট্রিং> | প্রদত্ত ফলাফল বর্ণনা করে এমন বৈশিষ্ট্য প্রকারের একটি অ্যারে এতে রয়েছে। সমর্থিত প্রকারের তালিকা দেখুন। |
| ঐচ্ছিক | স্ট্রিং | এতে এই স্থানটির জন্য অফিসিয়াল গুগল পেজের ইউআরএল রয়েছে। এটি হবে গুগলের নিজস্ব পেজ, যেখানে স্থানটি সম্পর্কে উপলব্ধ সেরা তথ্য থাকবে। ব্যবহারকারীকে স্থানটি সম্পর্কে বিস্তারিত ফলাফল দেখানোর জন্য ব্যবহৃত যেকোনো স্ক্রিনে অ্যাপ্লিকেশনগুলোকে অবশ্যই এই পেজটি লিঙ্ক করতে বা এমবেড করতে হবে। |
| ঐচ্ছিক | সংখ্যা | এই জায়গাটির জন্য লেখা সহ বা লেখা ছাড়া মোট পর্যালোচনার সংখ্যা। |
| ঐচ্ছিক | সংখ্যা | এই স্থানের বর্তমান টাইমজোন UTC থেকে কত মিনিটের ব্যবধানে রয়েছে, তা এখানে উল্লেখ করা আছে। উদাহরণস্বরূপ, ডেলাইট সেভিং টাইম চলাকালীন অস্ট্রেলিয়ার সিডনির মতো স্থানগুলির জন্য এটি হবে ৬৬০ (UTC থেকে +১১ ঘণ্টা), এবং ডেলাইট সেভিং টাইমের বাইরে ক্যালিফোর্নিয়ার মতো স্থানগুলির জন্য এটি হবে -৪৮০ (UTC থেকে -৮ ঘণ্টা)। |
| ঐচ্ছিক | স্ট্রিং | শুধুমাত্র প্রতিষ্ঠান ( অন্য সকল ফলাফলের ক্ষেত্রে, এই বিষয়বস্তুটি হুবহু পড়ার জন্য। ফরম্যাট করা ঠিকানাটি প্রোগ্রামগতভাবে পার্স করবেন না। |
| ঐচ্ছিক | স্ট্রিং | এই স্থানের জন্য নির্ভরযোগ্য ওয়েবসাইট, যেমন কোনো ব্যবসার হোমপেজ। |
| ঐচ্ছিক | বুলিয়ান | স্থানটিতে হুইলচেয়ার-বান্ধব প্রবেশপথ আছে কিনা তা উল্লেখ করে। |
স্থান সম্পাদকীয় সারসংক্ষেপ
স্থানটির একটি সারসংক্ষেপ রয়েছে। সারসংক্ষেপটি একটি লিখিত বিবরণ নিয়ে গঠিত এবং প্রযোজ্য ক্ষেত্রে এর ভাষা কোডও অন্তর্ভুক্ত থাকে। সারসংক্ষেপের লেখাটি হুবহু উপস্থাপন করতে হবে এবং এটি পরিবর্তন বা পরিমার্জন করা যাবে না।
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| ঐচ্ছিক | স্ট্রিং | পূর্ববর্তী ক্ষেত্রগুলোর ভাষা। এটি সবসময় উপস্থিত নাও থাকতে পারে। |
| ঐচ্ছিক | স্ট্রিং | স্থানটি সম্পর্কে একটি মাঝারি দৈর্ঘ্যের লিখিত সারাংশ। |
স্থান খোলার সময়
কোনো স্থানের খোলার সময়সূচী বর্ণনা করে এমন একটি বস্তু।
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| ঐচ্ছিক | বুলিয়ান | একটি বুলিয়ান মান যা নির্দেশ করে স্থানটি বর্তমান সময়ে খোলা আছে কি না। |
| ঐচ্ছিক | অ্যারে< স্থান খোলার সময়কাল > | রবিবার থেকে শুরু করে কালানুক্রমিকভাবে সাত দিনব্যাপী একাধিক খোলার পর্ব। আরও তথ্যের জন্য PlaceOpeningHoursPeriod দেখুন। |
| ঐচ্ছিক | অ্যারে< স্থানবিশেষদিন > | পরবর্তী সাত দিনের জন্য সর্বাধিক সাতটি এন্ট্রির একটি অ্যারে। আরও তথ্যের জন্য PlaceSpecialDay দেখুন। |
| ঐচ্ছিক | স্ট্রিং | সেকেন্ডারি আওয়ারের ধরন শনাক্ত করতে ব্যবহৃত একটি টাইপ স্ট্রিং (উদাহরণস্বরূপ, |
| ঐচ্ছিক | অ্যারে<স্ট্রিং> | স্থানটির খোলার সময় মানুষের পাঠযোগ্য অক্ষরে বর্ণনা করে এমন স্ট্রিংগুলির একটি অ্যারে। |
স্থান খোলার সময়
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| প্রয়োজনীয় | স্থান খোলার সময় সময়কাল বিবরণ | এতে একজোড়া দিন ও সময়ের অবজেক্ট রয়েছে, যা বর্ণনা করে স্থানটি কখন খোলে। আরও তথ্যের জন্য PlaceOpeningHoursPeriodDetail দেখুন। |
| ঐচ্ছিক | স্থান খোলার সময় সময়কাল বিবরণ | এতে একজোড়া দিন এবং সময়ের অবজেক্ট থাকতে পারে, যা স্থানটি কখন বন্ধ হয় তা বর্ণনা করে। যদি কোনো স্থান সর্বদা খোলা থাকে, তাহলে প্রতিক্রিয়া থেকে বন্ধ হওয়ার অংশটি অনুপস্থিত থাকবে। ক্লায়েন্টরা এই বিষয়ে নিশ্চিত থাকতে পারেন যে, সর্বদা-খোলা অবস্থাটি একটি খোলা সময়কাল হিসাবে উপস্থাপিত হয়, যেখানে দিনের মান আরও তথ্যের জন্য PlaceOpeningHoursPeriodDetail দেখুন। |
স্থানবিশেষদিন
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| ঐচ্ছিক | স্ট্রিং | স্থানটির স্থানীয় সময় অঞ্চলে RFC3339 বিন্যাসে প্রকাশিত একটি তারিখ, উদাহরণস্বরূপ ২০১০-১২-৩১। |
| ঐচ্ছিক | বুলিয়ান | এই দিনের জন্য ব্যতিক্রমী সময় থাকলে 'ট্রু' হবে। যদি ' |
স্থান খোলার সময় সময়কাল বিবরণ
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| প্রয়োজনীয় | সংখ্যা | ০ থেকে ৬ পর্যন্ত একটি সংখ্যা, যা রবিবার থেকে শুরু করে সপ্তাহের দিনগুলোকে নির্দেশ করে। উদাহরণস্বরূপ, ২ মানে মঙ্গলবার। |
| প্রয়োজনীয় | স্ট্রিং | এতে ২৪-ঘণ্টার hhmm ফরম্যাটে দিনের সময় থাকতে পারে। মানগুলো ০০০০–২৩৫৯ পরিসরের মধ্যে থাকে। সময়টি স্থানটির টাইম জোন অনুযায়ী জানানো হবে। |
| ঐচ্ছিক | স্ট্রিং | স্থানটির স্থানীয় সময় অঞ্চলে RFC3339 বিন্যাসে প্রকাশিত একটি তারিখ, উদাহরণস্বরূপ ২০১০-১২-৩১। |
| ঐচ্ছিক | বুলিয়ান | সত্য হবে যদি সাত দিনের সময়সীমার কারণে কোনো নির্দিষ্ট সময়কাল সংক্ষিপ্ত করা হয়, যেখানে সময়কালটি অনুরোধের তারিখের মধ্যরাতের আগে শুরু হয় এবং/অথবা শেষ দিনের মধ্যরাতে বা তার পরে শেষ হয়। এই বৈশিষ্ট্যটি নির্দেশ করে যে খোলা বা বন্ধ করার সময়কাল এই সাত দিনের সময়সীমা অতিক্রম করতে পারে। |
প্লেসফটো
একটি স্থানের ছবি। প্লেস ফটো এপিআই (Place Photo API) ব্যবহার করে নিম্নলিখিত প্যাটার্নের একটি ইউআরএল (url) দ্বারা ছবিটি অ্যাক্সেস করা যাবে:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
আরও তথ্যের জন্য স্থানটির ছবিগুলো দেখুন।
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| প্রয়োজনীয় | সংখ্যা | ছবিটির উচ্চতা। |
| প্রয়োজনীয় | অ্যারে<স্ট্রিং> | ছবিটির এইচটিএমএল অ্যাট্রিবিউশন। |
| প্রয়োজনীয় | স্ট্রিং | ফটো অনুরোধ করার সময় ছবিটি শনাক্ত করতে ব্যবহৃত একটি স্ট্রিং। |
| প্রয়োজনীয় | সংখ্যা | ছবিটির প্রস্থ। |
স্থান পর্যালোচনা
একজন ব্যবহারকারীর জমা দেওয়া স্থানটির পর্যালোচনা।
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| প্রয়োজনীয় | স্ট্রিং | যে ব্যবহারকারী রিভিউটি জমা দিয়েছেন তার নাম। বেনামী রিভিউগুলোকে "একজন গুগল ব্যবহারকারী" হিসেবে উল্লেখ করা হয়। |
| প্রয়োজনীয় | সংখ্যা | এই জায়গাটির জন্য ব্যবহারকারীর সামগ্রিক রেটিং। এটি একটি পূর্ণ সংখ্যা, যার পরিসর ১ থেকে ৫ পর্যন্ত। |
| প্রয়োজনীয় | স্ট্রিং | বর্তমান সময়ের সাপেক্ষে, যে সময়ে পর্যালোচনাটি লিখিত আকারে জমা দেওয়া হয়েছিল। |
| প্রয়োজনীয় | সংখ্যা | পর্যালোচনাটি জমা দেওয়ার সময়, যা ১ জানুয়ারী, ১৯৭০ ইউটিসি-এর মধ্যরাত থেকে সেকেন্ডে পরিমাপ করা হয়েছে। |
| ঐচ্ছিক | স্ট্রিং | ব্যবহারকারীর গুগল ম্যাপস লোকাল গাইডস প্রোফাইলের ইউআরএল, যদি উপলব্ধ থাকে। |
| ঐচ্ছিক | স্ট্রিং | একটি IETF ভাষা কোড যা ফেরত আসা পর্যালোচনার ভাষা নির্দেশ করে। এই ফিল্ডটিতে শুধুমাত্র মূল ভাষার ট্যাগ থাকে, দেশ বা অঞ্চল নির্দেশকারী দ্বিতীয় ট্যাগটি থাকে না। উদাহরণস্বরূপ, সমস্ত ইংরেজি পর্যালোচনাকে 'en' হিসাবে ট্যাগ করা হয়, 'en-AU' বা 'en-UK' ইত্যাদি হিসাবে নয়। যদি পর্যালোচনার কোনো লেখা ছাড়া শুধুমাত্র রেটিং থাকে, তাহলে এই ফিল্ডটি খালি থাকে। |
| ঐচ্ছিক | স্ট্রিং | একটি IETF ভাষা কোড যা পর্যালোচনার মূল ভাষা নির্দেশ করে। যদি পর্যালোচনাটি অনুবাদ করা হয়ে থাকে, তাহলে |
| ঐচ্ছিক | স্ট্রিং | ব্যবহারকারীর প্রোফাইল ফটোর ইউআরএল, যদি উপলব্ধ থাকে। |
| ঐচ্ছিক | স্ট্রিং | ব্যবহারকারীর রিভিউ। গুগল প্লেসেস-এ কোনো স্থানের রিভিউ দেওয়ার সময়, টেক্সট রিভিউ ঐচ্ছিক বলে গণ্য করা হয়। তাই, এই ফিল্ডটি খালি থাকতে পারে। মনে রাখবেন যে এই ফিল্ডে সাধারণ HTML মার্কআপ থাকতে পারে। উদাহরণস্বরূপ, এনটিটি রেফারেন্স |
| ঐচ্ছিক | বুলিয়ান | একটি বুলিয়ান মান যা নির্দেশ করে যে রিভিউটি তার মূল ভাষা থেকে অনুবাদ করা হয়েছে কিনা। যদি কোনো রিভিউ অনুবাদ করা হয়ে থাকে, যার মান 'true', তাহলে গুগল আপনার ব্যবহারকারীদের তা জানানোর পরামর্শ দেয়। উদাহরণস্বরূপ, আপনি রিভিউটিতে "Translated by Google" স্ট্রিংটি যোগ করতে পারেন। |