জায়গার বিবরণ (লিগ্যাসি)

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর ডেভেলপার

প্লেস সার্চ থেকে place_id পাওয়ার পরে, আপনি প্লেস বিবরণ (Legacy) অনুরোধ করে কোনও নির্দিষ্ট এস্ট্যাবলিশমেন্ট বা আগ্রহের বিষয় সম্পর্কে আরও বিবরণ জানতে চাইতে পারেন। Place Details (Legacy) অনুরোধের মাধ্যমে নির্দিষ্ট করা জায়গা সম্পর্কে আরও বিস্তারিত তথ্য পাওয়া যায় যেমন, সম্পূর্ণ ঠিকানা, ফোন নম্বর, ব্যবহারকারীর রেটিং ও রিভিউ।

জায়গার বিবরণ (লিগ্যাসি) সংক্রান্ত অনুরোধ

একটি Place Details (Legacy) অনুরোধ হল নিম্নলিখিত ফর্মের একটি HTTP URL:

https://maps.googleapis.com/maps/api/place/details/output?parameters

যেখানে output নিম্নলিখিত মানগুলির মধ্যে যেকোনও একটি হতে পারে:

  • json (সাজেস্ট করা হয়েছে) জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন (JSON)-এ আউটপুট নির্দেশ করে
  • xml XML হিসেবে আউটপুট নির্দেশ করে

সার্চের অনুরোধ শুরু করার জন্য নির্দিষ্ট কিছু প্যারামিটার প্রয়োজন। URL-এ স্ট্যান্ডার্ড হিসেবে, সব প্যারামিটারকে অ্যামপারস্যান্ড (&) অক্ষর ব্যবহার করে আলাদা করা হয়। নিচে প্যারামিটার ও তার সম্ভাব্য ভ্যালুর তালিকা দেওয়া হল।

প্রয়োজনীয় প্যারামিটার

ঐচ্ছিক প্যারামিটার

  • ফিল্ড

    সতর্কতা: Place Search (Legacy) অনুরোধ এবং Place Details (Legacy) অনুরোধ একই ফিল্ড ফেরত দেয় না। Place Search (Legacy) অনুরোধগুলি ফিল্ডের একটি সাবসেট ফেরত দেয় যা Place Details (Legacy) অনুরোধ দ্বারা ফেরত দেওয়া হয়। আপনি যে ফিল্ডটি চান সেটি যদি Place Search (Legacy) দ্বারা রিটার্ন করা না হয়, তাহলে আপনি Place Search (Legacy) ব্যবহার করে একটি place_id পেতে পারেন, তারপর সেই প্লেস আইডি ব্যবহার করে Place Details (Legacy) অনুরোধ করতে পারেন। প্লেস সার্চ (Legacy) অনুরোধে উপলভ্য নয় এমন ফিল্ড সম্পর্কে আরও তথ্য পেতে, প্লেস ডেটা ফিল্ড (Legacy) দেখুন।

    ফেরত পাঠানোর জন্য কমা-সেপারেটেড প্লেস ডেটা টাইপের তালিকা নির্দিষ্ট করতে 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 (বন্ধ করা হয়েছে), 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 প্রদান করা না হলে, API Accept-Language হেডার থেকে পাওয়া পছন্দের ভাষা ব্যবহার করার চেষ্টা করে।
    • ব্যবহারকারী ও স্থানীয় লোকজন, উভয়ের কাছেই বোধগম্য হয় এমন রাস্তার ঠিকানা প্রদান করার জন্য API যথাসাধ্য চেষ্টা করে। সেই লক্ষ্য পূরণ করতে, এটি স্থানীয় ভাষায় রাস্তার ঠিকানা রিটার্ন করে, প্রয়োজন হলে ব্যবহারকারীর পড়ার মতো স্ক্রিপ্টে ট্রান্সলিটারেট করে এবং পছন্দের ভাষা মেনে চলে। অন্যান্য সব ঠিকানা পছন্দের ভাষায় দেখানো হয়। ঠিকানার কম্পোনেন্টগুলি সব একই ভাষায় রিটার্ন করা হয়, যা প্রথম কম্পোনেন্ট থেকে বেছে নেওয়া হয়।
    • পছন্দসই ভাষায় কোনও নাম উপলভ্য না থাকলে, API সবচেয়ে কাছাকাছি ম্যাচ ব্যবহার করে।
    • API যে ফলাফলগুলি রিটার্ন করার জন্য বেছে নেয় এবং সেগুলি যে ক্রমে রিটার্ন করা হয়, সেগুলির সেটের উপর পছন্দের ভাষার সামান্য প্রভাব পড়ে। ভাষা অনুযায়ী জিওকোডার সংক্ষিপ্ত শব্দ আলাদাভাবে ব্যাখ্যা করে, যেমন, রাস্তার ধরনের সংক্ষিপ্ত শব্দ বা সমার্থক শব্দ যা একটি ভাষায় বৈধ হতে পারে কিন্তু অন্য ভাষায় নয়। যেমন, utca এবং tér হল হাঙ্গেরিয়ান ভাষায় রাস্তার সমার্থক শব্দ।
  • অঞ্চল

    অঞ্চল কোড, ccTLD ("টপ-লেভেল ডোমেন") দুটি অক্ষরের মান হিসেবে উল্লেখ করা হয়েছে। বেশিরভাগ ccTLD কোড ISO 3166-1 কোডের মতোই হয়, তবে কিছু ব্যতিক্রম আছে। যেমন, যুক্তরাজ্যের ccTLD হল "uk" (.co.uk) এবং এর ISO 3166-1 কোড হল "gb" (টেকনিক্যালি "গ্রেট ব্রিটেন ও উত্তর আয়ারল্যান্ডের যুক্তরাজ্য" এন্টিটির জন্য)।

  • reviews_no_translations

    রিভিউয়ের অনুবাদ বন্ধ করতে reviews_no_translations=true এবং রিভিউয়ের অনুবাদ চালু করতে reviews_no_translations=false নির্দিষ্ট করুন। রিভিউগুলি মূল ভাষাতেই দেখানো হয়।

    এটি বাদ দেওয়া হলে বা কোনও ভ্যালু ছাড়াই পাস করা হলে, রিভিউয়ের অনুবাদ চালু করা হয়। অনুরোধে language প্যারামিটার উল্লেখ করা থাকলে, অনুবাদের জন্য পছন্দসই ভাষা হিসেবে উল্লেখ করা ভাষা ব্যবহার করুন। যদি language বাদ দেওয়া হয়, তাহলে API Accept-Language হেডারকে পছন্দসই ভাষা হিসেবে ব্যবহার করার চেষ্টা করে।

  • reviews_sort

    রিভিউ ফেরত দেওয়ার সময় যে সর্টিং পদ্ধতি ব্যবহার করতে হবে। এগুলি most_relevant (ডিফল্ট) বা newest হিসেবে সেট করা যেতে পারে।

    • most_relevant-এর (ডিফল্ট) জন্য, পর্যালোচনাগুলি প্রাসঙ্গিকতা অনুযায়ী সাজানো হয়; পরিষেবাটি এমনভাবে ফলাফলকে পক্ষপাতদুষ্ট করে যাতে মূলত পছন্দের ভাষায় লেখা পর্যালোচনা দেখানো যায়।
    • newest-এর জন্য, রিভিউ কালানুক্রমিক ক্রমে সাজানো হয়; পছন্দের ভাষা সাজানোর ক্রমকে প্রভাবিত করে না।

    Google সাজেস্ট করে যে আপনি ব্যবহারকারীকে দেখান যে কীভাবে রিভিউগুলি সাজানো হচ্ছে।

  • sessiontoken

    একটি র‍্যান্ডম স্ট্রিং যা বিলিংয়ের উদ্দেশ্যে সেশন অটোমেটিক সম্পূর্ণ করার জন্য শনাক্ত করে।

    ব্যবহারকারী কোয়েরি টাইপ করা শুরু করলে সেশন শুরু হয় এবং তিনি কোনও জায়গা বেছে নিলে এবং Place Details (Legacy)-এ কল করা হলে সেশন শেষ হয়। প্রতিটি সেশনে একাধিক কোয়েরি থাকতে পারে, তারপরে একটি জায়গা বেছে নেওয়া হয়। সেশনের মধ্যে প্রতিটি অনুরোধের জন্য ব্যবহৃত API কী একই Google Cloud Console প্রোজেক্টের হতে হবে। সেশন শেষ হয়ে গেলে, টোকেন আর বৈধ থাকে না; আপনার অ্যাপকে প্রতিটি সেশনের জন্য নতুন টোকেন জেনারেট করতে হবে। sessiontoken প্যারামিটার বাদ দিলে অথবা সেশন টোকেন আবার ব্যবহার করলে, সেশন টোকেন না দিলে যেভাবে চার্জ করা হয়, সেইভাবে চার্জ করা হয় (প্রতিটি অনুরোধের জন্য আলাদাভাবে বিল করা হয়)।

    আমরা নিম্নলিখিত নির্দেশিকা সাজেস্ট করি:

    • সব অটোকমপ্লিট সেশনের জন্য সেশন টোকেন ব্যবহার করুন।
    • প্রতিটি সেশনের জন্য নতুন টোকেন জেনারেট করুন। UUID-এর ভার্সন ৪ ব্যবহার করার জন্য সাজেস্ট করা হয়।
    • একটি সেশনের মধ্যে সমস্ত জায়গা অটোমেটিক সম্পূর্ণ করা এবং জায়গার বিবরণ সংক্রান্ত অনুরোধের জন্য ব্যবহৃত API কী(গুলি) একই Cloud Console প্রোজেক্টের অন্তর্গত কিনা তা নিশ্চিত করুন।
    • প্রতিটি নতুন সেশনের জন্য একটি অনন্য সেশন টোকেন পাস করতে ভুলবেন না। একাধিক সেশনের জন্য একই টোকেন ব্যবহার করলে, প্রতিটি অনুরোধের জন্য আলাদা আলাদা করে বিল করা হবে।

জায়গার বিবরণ (লিগ্যাসি) সংক্রান্ত উদাহরণ

নিচে দেওয়া উদাহরণে, কোনও জায়গার বিবরণ জানতে 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 কী দিয়ে প্রতিস্থাপন করতে হবে।

জায়গার বিবরণ (লিগ্যাসি) সংক্রান্ত উত্তর

অনুরোধের URL পাথের মধ্যে 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

<?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>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference>
   <width>4048</width>
   <height>3036</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104829437842034782235&quot;&gt;Anna Linetsky&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference>
   <width>6016</width>
   <height>4016</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/107755640736541028674&quot;&gt;Jonah Dell&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115886271727815775491&quot;&gt;Anthony Huynh&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102939237947063969663&quot;&gt;Jasen Baker&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference>
   <width>2048</width>
   <height>1515</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112343109286948028063&quot;&gt;Andrew W&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</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>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</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, দু'টি রেসপন্সেই নিম্নলিখিত এলিমেন্ট থাকে:

PlacesDetailsResponse

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় Array<string>

এই তালিকা সম্পর্কে অ্যাট্রিবিউশনের একটি সেট থাকতে পারে যা অবশ্যই ব্যবহারকারীকে দেখাতে হবে (কিছু তালিকায় অ্যাট্রিবিউশন নাও থাকতে পারে)।

প্রয়োজনীয় জায়গা

অনুরোধ করা জায়গা সম্পর্কে বিস্তারিত তথ্য থাকে।

আরও তথ্যের জন্য স্থান দেখুন।

প্রয়োজনীয় PlacesDetailsStatus

অনুরোধের স্ট্যাটাস থাকে এবং অনুরোধ কেন ব্যর্থ হল তা ট্র্যাক করতে সাহায্য করার জন্য এতে ডিবাগিং তথ্য থাকতে পারে।

আরও তথ্যের জন্য PlacesDetailsStatus দেখুন।

ঐচ্ছিক Array<string>

পরিষেবাটি অনুরোধের স্পেসিফিকেশন সম্পর্কে অতিরিক্ত তথ্য প্রদান করলে, রেসপন্স অবজেক্টের মধ্যে একটি অতিরিক্ত info_messages ফিল্ড থাকতে পারে। এই ফিল্ড শুধুমাত্র সফল অনুরোধের ক্ষেত্রে রিটার্ন করা হয়। এটি সবসময় ফেরত নাও আসতে পারে এবং এর কন্টেন্ট পরিবর্তন করা হতে পারে।

JSON রেসপন্সে, এগুলি রুট এলিমেন্ট হিসেবে দেখানো হয়। XML উত্তরে, এগুলি <PlaceDetailsResponse>-এর নিচে টপ-লেভেল এলিমেন্ট হিসেবে দেখা যায়।

PlacesDetailsStatus

পরিষেবা থেকে ফেরত আসা স্ট্যাটাস কোড।

  • OK API অনুরোধ সফল হয়েছে তা নির্দেশ করছে।
  • ZERO_RESULTS ইঙ্গিত করছে যে রেফারেন্স করা লোকেশন, place_id, সঠিক ছিল কিন্তু এখন আর সঠিক ফলাফল রেফার করে না। প্রতিষ্ঠানটি আর ব্যবসা না করলে এমনটি হতে পারে।
  • NOT_FOUND ইঙ্গিত করে যে রেফারেন্স করা লোকেশন, place_id, Places ডেটাবেসে খুঁজে পাওয়া যায়নি।
  • INVALID_REQUEST, যা থেকে বোঝা যায় যে API অনুরোধটি ভুল ফর্ম্যাটে আছে।
  • OVER_QUERY_LIMIT নিম্নলিখিত যেকোনও একটি নির্দেশ করে:
    • আপনি QPS সীমা অতিক্রম করেছেন।
    • আপনার অ্যাকাউন্টে বিলিং চালু করা হয়নি।
    • $২০০ মূল্যের মাসিক ক্রেডিট বা নিজের সেট করা ব্যবহারের সীমা পেরিয়ে গেছেন।
    • প্রদান করা পেমেন্ট পদ্ধতি আর বৈধ নয় (যেমন, ক্রেডিট কার্ডের মেয়াদ শেষ হয়ে গেছে)।
    এই সমস্যার সমাধান কীভাবে করবেন সেই সম্পর্কে আরও জানতে Maps-এর প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন।
  • REQUEST_DENIED থেকে বোঝা যাচ্ছে যে আপনার অনুরোধ প্রত্যাখ্যান করা হয়েছে, সাধারণত এই কারণে:
    • অনুরোধে API key নেই।
    • key প্যারামিটারটি সঠিক নয়।
  • UNKNOWN_ERROR যা অজানা সমস্যার ইঙ্গিত দেয়।

জায়গা

কোনও জায়গার বিবরণ সহ অ্যাট্রিবিউট। সব ধরনের জায়গার জন্য সব অ্যাট্রিবিউট উপলভ্য হবে না।

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
ঐচ্ছিক Array<AddressComponent>

এই ঠিকানার ক্ষেত্রে প্রযোজ্য আলাদা আলাদা কম্পোনেন্ট সহ একটি অ্যারে।

আরও তথ্যের জন্য AddressComponent দেখুন।

ঐচ্ছিক স্ট্রিং

adr মাইক্রোফরম্যাটে জায়গার ঠিকানার উপস্থাপনা।

ঐচ্ছিক স্ট্রিং

এটি কোনও ব্যবসা হলে, জায়গার অপারেশনাল স্ট্যাটাস নির্দেশ করে। কোনও ডেটা না থাকলে, business_status ফিরিয়ে দেওয়া হয় না।

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
ঐচ্ছিক বুলিয়ান

ব্যবসা কার্বসাইড পিক-আপের সুবিধা দেয় কিনা তা নির্দিষ্ট করে।

ঐচ্ছিক PlaceOpeningHours

পরবর্তী সাত দিনের (আজ সহ) জন্য খোলা থাকার সময় উল্লেখ করা আছে। অনুরোধের তারিখের মধ্যরাত থেকে সময়সীমা শুরু হয় এবং ছয় দিন পরে রাত ১১টা ৫৯ মিনিটে শেষ হয়। এই ফিল্ডে সেইসব তারিখের জন্য সেট করা special_days সব ঘণ্টার সাবফিল্ড অন্তর্ভুক্ত থাকে যেগুলিতে অসাধারণ ঘণ্টা থাকে।

আরও তথ্যের জন্য PlaceOpeningHours দেখুন।

ঐচ্ছিক বুলিয়ান

ব্যবসা ডেলিভারি পরিষেবা দেয় কিনা তা উল্লেখ করে।

ঐচ্ছিক বুলিয়ান

ব্যবসাটি ইনডোর বা আউটডোর বসার বিকল্প সমর্থন করে কিনা তা নির্দিষ্ট করে।

ঐচ্ছিক PlaceEditorialSummary

জায়গাটির সারসংক্ষেপ রয়েছে। সারসংক্ষেপে টেক্সচুয়াল ওভারভিউ থাকে এবং প্রযোজ্য হলে এতে এইসব ভাষার কোডও থাকে। সারসংক্ষেপের টেক্সট যেমন আছে তেমনই দেখাতে হবে এবং এটি পরিবর্তন বা সংশোধন করা যাবে না।

আরও তথ্যের জন্য PlaceEditorialSummary দেখুন।

ঐচ্ছিক স্ট্রিং

এই জায়গার মানুষের-পঠনযোগ্য ঠিকানা সহ স্ট্রিং।

প্রায়শই এই ঠিকানা পোস্টাল ঠিকানার সমতুল্য হয়। মনে রাখবেন যে যুক্তরাজ্যের মতো কিছু দেশে লাইসেন্স সংক্রান্ত বিধিনিষেধের কারণে আসল পোস্টাল ঠিকানা ডিস্ট্রিবিউট করার অনুমতি দেওয়া হয় না।

ফর্ম্যাট করা ঠিকানাটি যৌক্তিকভাবে এক বা একাধিক ঠিকানা উপাদান নিয়ে গঠিত। যেমন, "111 8th Avenue, New York, NY" ঠিকানায় নিম্নলিখিত উপাদানগুলি রয়েছে: "111" (রাস্তার নম্বর), "8th Avenue" (রাস্তা), "New York" (শহর) এবং "NY" (মার্কিন যুক্তরাষ্ট্রের রাজ্য)।

প্রোগ্রাম্যাটিক উপায়ে ফর্ম্যাট করা ঠিকানা পার্স করবেন না। এর পরিবর্তে, আপনাকে ঠিকানার আলাদা আলাদা কম্পোনেন্ট ব্যবহার করতে হবে, যা API উত্তর ফর্ম্যাট করা ঠিকানার ফিল্ড ছাড়াও অন্তর্ভুক্ত করে।

ঐচ্ছিক স্ট্রিং

এতে জায়গার ফোন নম্বরটি স্থানীয় ফর্ম্যাটে আছে।

ঐচ্ছিক Geometry

লোকেশন ও লোকেশনের ভিউপোর্ট থাকে।

আরও তথ্যের জন্য Geometry দেখুন।

ঐচ্ছিক স্ট্রিং

এতে সাজেস্ট করা আইকনের URL থাকে যা ম্যাপে এই ফলাফল দেখানোর সময় ব্যবহারকারীকে দেখানো হতে পারে।

ঐচ্ছিক স্ট্রিং

জায়গার বিভাগের জন্য ডিফল্ট HEX কালার কোড থাকে।

ঐচ্ছিক স্ট্রিং

এতে সাজেস্ট করা আইকনের URL থাকে, তবে .svg বা .png ফাইলের ধরনের এক্সটেনশন থাকে না।

ঐচ্ছিক স্ট্রিং

আন্তর্জাতিক ফর্ম্যাটে জায়গার ফোন নম্বর থাকে। আন্তর্জাতিক ফর্ম্যাটে দেশের কোড থাকে এবং তার আগে প্লাস, +, চিহ্ন থাকে। যেমন, Google-এর সিডনি, অস্ট্রেলিয়া অফিসের international_phone_number হল +61 2 9374 4000।

ঐচ্ছিক স্ট্রিং

ফেরত আসা ফলাফলের জন্য মানুষের-পঠনযোগ্য নাম থাকে। establishment ফলাফলের জন্য, এটি সাধারণত ক্যানোনিকালাইজ করা ব্যবসার নাম।

ঐচ্ছিক PlaceOpeningHours

সাধারণত খোলা থাকার সময় উল্লেখ করা থাকে।

আরও তথ্যের জন্য PlaceOpeningHours দেখুন ।

ঐচ্ছিক বুলিয়ান

ব্যবসার অপারেশনাল স্ট্যাটাস পেতে business_status ব্যবহার করুন।

ঐচ্ছিক Array<PlacePhoto>

ফটো অবজেক্টের একটি অ্যারে, যার প্রত্যেকটিতে একটি ছবির রেফারেন্স থাকে। একটি অনুরোধে সর্বাধিক দশটি ফটো ফেরত আসতে পারে। জায়গার ফটো এবং কীভাবে আপনার অ্যাপ্লিকেশনে ছবি ব্যবহার করতে পারবেন সেই সম্পর্কে আরও তথ্য জায়গার ফটো ডকুমেন্টেশনে পাওয়া যাবে।

আরও তথ্যের জন্য PlacePhoto দেখুন।

ঐচ্ছিক স্ট্রিং

টেক্সচুয়াল শনাক্তকারী যা কোনও জায়গাকে অনন্যভাবে শনাক্ত করে। জায়গাটি সম্পর্কে তথ্য পেতে, Places API অনুরোধের place_id ফিল্ডে এই শনাক্তকারী পাস করুন। প্লেস আইডি সম্পর্কে আরও জানতে, প্লেস আইডি ওভারভিউ দেখুন।

ঐচ্ছিক PlusCode

অক্ষাংশ ও দ্রাঘিমাংশ কোঅর্ডিনেট থেকে প্রাপ্ত এনকোড করা লোকেশন রেফারেন্স, যা একটি এলাকাকে বোঝায়: ১/৮০০০ ডিগ্রি বাই ১/৮০০০ ডিগ্রি (নিরক্ষরেখায় প্রায় ১৪ মিটার x ১৪ মিটার) বা তার চেয়ে ছোট। যেসব জায়গায় রাস্তার ঠিকানা নেই (যেখানে বিল্ডিংয়ের নম্বর বা রাস্তার নাম নেই) সেখানে রাস্তার ঠিকানার পরিবর্তে Plus Code ব্যবহার করা যেতে পারে। ওপেন লোকেশন কোড এবং Plus Code দেখুন।

আরও তথ্যের জন্য PlusCode দেখুন।

ঐচ্ছিক নম্বর

০ থেকে ৪-এর স্কেলে জায়গাটির দামের লেভেল। নির্দিষ্ট ভ্যালু দ্বারা চিহ্নিত সঠিক পরিমাণ অঞ্চল ভেদে আলাদা আলাদা হবে। দাম অনুযায়ী লেভেল এইভাবে ব্যাখ্যা করা হয়:

  • ০টি ফ্রি
  • ১ কম দামি
  • ২ মাঝারি
  • 3 দামী
  • ৪ খুব দামি
ঐচ্ছিক নম্বর

এতে ব্যবহারকারীর দেওয়া রিভিউয়ের ভিত্তিতে ১.০ থেকে ৫.০ পর্যন্ত জায়গার রেটিং থাকে।

ঐচ্ছিক স্ট্রিং
ঐচ্ছিক বুলিয়ান

জায়গাটিতে রিজার্ভেশনের সুবিধা আছে কিনা তা উল্লেখ করে।

ঐচ্ছিক Array<PlaceReview>

সর্বাধিক পাঁচটি রিভিউয়ের JSON অ্যারে। ডিফল্ট হিসেবে, প্রাসঙ্গিকতা অনুযায়ী রিভিউ সাজানো হয়। সর্টিং নিয়ন্ত্রণ করতে reviews_sort রিকোয়েস্ট প্যারামিটার ব্যবহার করুন।

  • most_relevant-এর (ডিফল্ট) জন্য, পর্যালোচনাগুলি প্রাসঙ্গিকতা অনুযায়ী সাজানো হয়; পরিষেবাটি এমনভাবে ফলাফল দেখাবে যাতে পছন্দের ভাষায় লেখা পর্যালোচনাগুলি প্রথমে দেখানো হয়।
  • newest-এর জন্য, রিভিউ কালানুক্রমিক অর্ডারে সাজানো হয়; পছন্দের ভাষা ক্রমানুসারে সাজানোর সেটিংকে প্রভাবিত করে না।

Google সাজেস্ট করে যে ফলাফলগুলি most_relevant বা newest অনুযায়ী সাজানো হয়েছে কিনা তা ব্যবহারকারীদের জানান।

আরও তথ্যের জন্য PlaceReview দেখুন।

ঐচ্ছিক স্ট্রিং
ঐচ্ছিক Array<PlaceOpeningHours>

এর মধ্যে পরবর্তী সাত দিনের জন্য এন্ট্রিগুলির একটি অ্যারে রয়েছে যার মধ্যে কোনও ব্যবসার গৌণ সময় সম্পর্কিত তথ্য অন্তর্ভুক্ত। সেকেন্ডারি সময় হল ব্যবসার মূল সময়ের থেকে আলাদা। যেমন, কোনও রেস্তোরাঁ ড্রাইভ-থ্রু খোলা থাকার সময় বা ডেলিভারি দেওয়ার সময়কে সেকেন্ডারি সময় হিসেবে উল্লেখ করতে পারে। এই ফিল্ড type সাবফিল্ড পূরণ করে, যা জায়গার ধরনের উপর ভিত্তি করে খোলা থাকার সময়ের ধরনের (যেমন DRIVE_THROUGH, PICKUP, অথবা TAKEOUT) পূর্বনির্ধারিত তালিকা থেকে তথ্য নেয়। এই ফিল্ডে ব্যতিক্রমী ঘণ্টা থাকা তারিখের জন্য সেট করা সব ঘণ্টার special_days সাবফিল্ড অন্তর্ভুক্ত।

আরও তথ্যের জন্য PlaceOpeningHours দেখুন।

ঐচ্ছিক বুলিয়ান

এই জায়গায় বিয়ার পরিবেশন করা হয় কিনা তা উল্লেখ করে।

ঐচ্ছিক বুলিয়ান

জায়গাটিতে ব্রেকফাস্ট পরিবেশন করা হয় কিনা তা উল্লেখ করে।

ঐচ্ছিক বুলিয়ান

এই জায়গায় ব্রাঞ্চ পরিবেশন করা হয় কিনা তা উল্লেখ করে।

ঐচ্ছিক বুলিয়ান

এই জায়গায় ডিনার পরিবেশন করা হয় কিনা তা উল্লেখ করে।

ঐচ্ছিক বুলিয়ান

এই জায়গায় লাঞ্চ পাওয়া যায় কিনা তা উল্লেখ করে।

ঐচ্ছিক বুলিয়ান

জায়গাটিতে নিরামিষ খাবার পরিবেশন করা হয় কিনা তা উল্লেখ করে।

ঐচ্ছিক বুলিয়ান

এই জায়গায় ওয়াইন পরিবেশন করা হয় কিনা তা উল্লেখ করে।

ঐচ্ছিক বুলিয়ান

ব্যবসাটি টেকআউট পরিষেবা প্রদান করে কিনা তা নির্দিষ্ট করে।

ঐচ্ছিক Array<string>

প্রদত্ত ফলাফল বর্ণনা করে এমন ফিচার ধরনের একটি অ্যারে থাকে। কাজ করে এমন ধরন এর তালিকা দেখুন।

ঐচ্ছিক স্ট্রিং

এই জায়গার জন্য অফিসিয়াল Google পৃষ্ঠার URL থাকে। এটি Google-এর মালিকানাধীন পৃষ্ঠা হবে যেখানে জায়গাটি সম্পর্কে উপলভ্য সেরা তথ্য থাকবে। ব্যবহারকারীকে জায়গাটি সম্পর্কে বিস্তারিত ফলাফল দেখানো হয় এমন যেকোনও স্ক্রিনে অ্যাপ্লিকেশনকে এই পৃষ্ঠার সাথে লিঙ্ক করতে বা এম্বেড করতে হবে।

ঐচ্ছিক নম্বর

এই জায়গার জন্য টেক্সট সহ বা টেক্সট ছাড়া মোট রিভিউয়ের সংখ্যা।

ঐচ্ছিক নম্বর

এই জায়গার বর্তমান টাইমজোন UTC থেকে কত মিনিট অফসেট আছে তা এতে থাকে। যেমন, ডেলাইট সেভিং টাইম চলাকালীন অস্ট্রেলিয়ার সিডনির কোনও জায়গার জন্য এটি হবে ৬৬০ (UTC থেকে +১১ ঘণ্টা) এবং ডেলাইট সেভিং টাইম ছাড়া ক্যালিফোর্নিয়ার কোনও জায়গার জন্য এটি হবে -৪৮০ (UTC থেকে -৮ ঘণ্টা)।

ঐচ্ছিক স্ট্রিং

প্রতিষ্ঠানের (types:["establishment", ...]) ফলাফল শুধুমাত্র, vicinity ফিল্ডে একটি সরলীকৃত ঠিকানা থাকে, যার মধ্যে রাস্তার নাম, রাস্তার নম্বর এবং এলাকা অন্তর্ভুক্ত, তবে প্রদেশ/রাজ্য, পিন কোড বা দেশ অন্তর্ভুক্ত নয়।

অন্যান্য সব ফলাফলের জন্য, vicinity ফিল্ডে ফলাফলের ঠিকানায় উপস্থিত সবচেয়ে সংকীর্ণ রাজনৈতিক (types:["political", ...]) ফিচারের নাম থাকে।

এই কন্টেন্টটি যেভাবে আছে সেভাবেই পড়তে হবে। ফর্ম্যাট করা ঠিকানাটি প্রোগ্রামাটিক উপায়ে পার্স করবেন না।

ঐচ্ছিক স্ট্রিং

এই জায়গার জন্য কর্তৃত্বপূর্ণ ওয়েবসাইট, যেমন কোনও ব্যবসার হোমপেজ।

ঐচ্ছিক বুলিয়ান

এই জায়গায় হুইলচেয়ার নিয়ে ঢোকার উপযুক্ত প্রবেশপথ আছে কিনা তা উল্লেখ করে।

PlaceEditorialSummary

জায়গাটির সারাংশ অন্তর্ভুক্ত আছে। সারসংক্ষেপে টেক্সট ওভারভিউ থাকে, এবং প্রযোজ্য হলে এগুলির জন্য ভাষা কোডও অন্তর্ভুক্ত থাকে। সারসংক্ষেপ টেক্সট যেমন আছে তেমনই দেখাতে হবে এবং তা পরিবর্তন বা অল্টার করা যাবে না।

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
ঐচ্ছিক স্ট্রিং

আগের ফিল্ডের ভাষা। সবসময় নাও থাকতে পারে।

ঐচ্ছিক স্ট্রিং

জায়গাটির মাঝারি দৈর্ঘ্যের টেক্সট সারাংশ।

PlaceOpeningHours

কোনও জায়গা খোলা থাকার সময়ের বিবরণ সহ অবজেক্ট।

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
ঐচ্ছিক বুলিয়ান

বুলিয়ান ভ্যালু যা নির্দেশ করে যে বর্তমান সময়ে জায়গাটি খোলা আছে কিনা।

ঐচ্ছিক Array<PlaceOpeningHoursPeriod>

সাত দিন ধরে খোলা থাকার সময়সীমার একটি অ্যারে, যা কালানুক্রমিক ক্রমে রবিবার থেকে শুরু হয়।

আরও তথ্যের জন্য PlaceOpeningHoursPeriod দেখুন।

ঐচ্ছিক Array<PlaceSpecialDay>

পরবর্তী সাত দিনের জন্য সাতটি এন্ট্রির একটি অ্যারে।

আরও তথ্যের জন্য PlaceSpecialDay দেখুন ।

ঐচ্ছিক স্ট্রিং

সেকেন্ডারি ঘণ্টার ধরন শনাক্ত করতে ব্যবহৃত টাইপ স্ট্রিং (যেমন, DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS)। শুধুমাত্র secondary_opening_hours-এর জন্য সেট করা আছে।

ঐচ্ছিক Array<string>

জায়গার সময়সূচি মানুষের-পঠনযোগ্য টেক্সটে বর্ণনা করে এমন স্ট্রিংয়ের অ্যারে।

PlaceOpeningHoursPeriod

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় PlaceOpeningHoursPeriodDetail

এতে দিন ও সময়ের একটি পেয়ার অব অবজেক্ট থাকে যা থেকে বোঝা যায় যে জায়গাটি কখন খোলে।

আরও তথ্যের জন্য PlaceOpeningHoursPeriodDetail দেখুন।

ঐচ্ছিক PlaceOpeningHoursPeriodDetail

এতে দিন ও সময়ের অবজেক্টের একটি জোড়া থাকতে পারে যা থেকে জানা যায় যে জায়গাটি কখন বন্ধ হয়। কোনও জায়গা সবসময় খোলা থাকলে, উত্তরের মধ্যে বন্ধ হওয়ার বিভাগটি থাকবে না। ক্লায়েন্টরা সবসময় খোলা থাকার সময়কে 0 ভ্যালু সহ দিন এবং 0000 ভ্যালু সহ সময় এবং কোনও close না থাকা খোলা সময় হিসেবে ধরে নিতে পারেন।

আরও তথ্যের জন্য PlaceOpeningHoursPeriodDetail দেখুন।

PlaceSpecialDay

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
ঐচ্ছিক স্ট্রিং

জায়গার স্থানীয় টাইমজোনে RFC3339 ফর্ম্যাটে প্রকাশ করা তারিখ, যেমন, ২০১০-১২-৩১।

ঐচ্ছিক বুলিয়ান

এই দিনের জন্য ব্যতিক্রমী সময় থাকলে True। যদি true হয়, এর অর্থ হল এই দিনের জন্য অন্তত একটি ব্যতিক্রম রয়েছে। ব্যতিক্রমের কারণে current_opening_hours ও secondary_opening_hours-এর সাবফিল্ডে আলাদা আলাদা ভ্যালু দেখা যায়, যেমন periods, weekday_text, open_now। ব্যতিক্রমগুলি ঘণ্টার ক্ষেত্রে প্রযোজ্য এবং অন্যান্য ফিল্ড তৈরি করতে ঘণ্টা ব্যবহার করা হয়।

PlaceOpeningHoursPeriodDetail

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় নম্বর

০–৬ পর্যন্ত একটি সংখ্যা, যা সপ্তাহের দিনের সাথে সম্পর্কিত, রবিবার থেকে শুরু হয়। যেমন, ২ মানে মঙ্গলবার।

প্রয়োজনীয় স্ট্রিং

এতে ২৪-ঘণ্টা hhmm ফর্ম্যাটে দিনের সময় থাকতে পারে। ভ্যালু 0000–2359 রেঞ্জের মধ্যে হতে হবে। সেই জায়গার টাইম জোনে সময় রিপোর্ট করা হবে।

ঐচ্ছিক স্ট্রিং

জায়গার স্থানীয় টাইমজোনে RFC3339 ফর্ম্যাটে প্রকাশ করা তারিখ, যেমন, ২০১০-১২-৩১।

ঐচ্ছিক বুলিয়ান

প্রদত্ত সময়সীমা যদি সাত দিনের কাট-অফের কারণে ছোট করা হয়, তাহলে True হবে, যেখানে সময়সীমা অনুরোধের তারিখে মধ্যরাতের আগে শুরু হয় এবং/অথবা শেষ দিন মধ্যরাতে বা তার পরে শেষ হয়। এই প্রপার্টি থেকে বোঝা যায় যে খোলা বা বন্ধ থাকার সময়সীমা এই সাত দিনের কাট-অফের পরেও বাড়ানো যেতে পারে।

PlacePhoto

কোনও জায়গার ফটো। নিচের প্যাটার্নে URL ব্যবহার করে Place Photo API-এর মাধ্যমে ফটো অ্যাক্সেস করা যেতে পারে:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

আরও তথ্যের জন্য জায়গার ফটো দেখুন।

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় নম্বর

ফটোটির উচ্চতা।

প্রয়োজনীয় Array<string>

ফটোটির জন্য HTML অ্যাট্রিবিউশন।

প্রয়োজনীয় স্ট্রিং

আপনি Photo অনুরোধ করলে ফটো শনাক্ত করার জন্য ব্যবহৃত স্ট্রিং।

প্রয়োজনীয় নম্বর

ফটোটির প্রস্থ।

PlaceReview

কোনও ব্যবহারকারীর জমা দেওয়া জায়গাটির রিভিউ।

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় স্ট্রিং

যে ব্যবহারকারী রিভিউ জমা দিয়েছেন তার নাম। অনামিকা পর্যালোচনা "একজন Google ব্যবহারকারী" হিসেবে দেখানো হয়।

প্রয়োজনীয় নম্বর

এই জায়গার জন্য ব্যবহারকারীর সামগ্রিক রেটিং। এটি ১ থেকে ৫-এর মধ্যে থাকা একটি পূর্ণসংখ্যা।

প্রয়োজনীয় স্ট্রিং

বর্তমান সময়ের সাপেক্ষে টেক্সটে রিভিউ জমা দেওয়ার সময়।

প্রয়োজনীয় নম্বর

পর্যালোচনা জমা দেওয়ার সময়, যা ১ জানুয়ারি, ১৯৭০ UTC-এর মধ্যরাতের পর থেকে সেকেন্ডের সংখ্যায় পরিমাপ করা হয়।

ঐচ্ছিক স্ট্রিং

ব্যবহারকারীর Google Maps স্থানীয় গাইড প্রোফাইলের URL, যদি উপলভ্য থাকে।

ঐচ্ছিক স্ট্রিং

IETF ভাষা কোড যা রিটার্ন করা পর্যালোচনাটির ভাষা নির্দেশ করে।এই ফিল্ডে শুধুমাত্র মূল ভাষা ট্যাগ থাকে এবং দেশ বা অঞ্চল নির্দেশকারী সেকেন্ডারি ট্যাগ থাকে না। যেমন, সব ইংরেজি রিভিউকে 'en' হিসেবে ট্যাগ করা হয়, 'en-AU' বা 'en-UK' হিসেবে নয় এবং এইভাবে চলতে থাকে। শুধুমাত্র রেটিং থাকলে এবং কোনও রিভিউ টেক্সট না থাকলে এই ফিল্ড খালি থাকে।

ঐচ্ছিক স্ট্রিং

IETF ভাষা কোড যা পর্যালোচনার মূল ভাষা নির্দেশ করে। পর্যালোচনাটি অনুবাদ করা হলে, তাহলে original_language != language.এই ফিল্ডে শুধুমাত্র মূল ভাষার ট্যাগ থাকে এবং দেশ বা অঞ্চল বোঝানো গৌণ ট্যাগ থাকে না। যেমন, সব ইংরেজি রিভিউ 'en' হিসেবে ট্যাগ করা হয়েছে, 'en-AU' বা 'en-UK' হিসেবে নয় এবং আরও অনেক কিছু। এই ফিল্ডটি খালি থাকে যদি শুধুমাত্র রেটিং থাকে, কোনও রিভিউ টেক্সট না থাকে।

ঐচ্ছিক স্ট্রিং

ব্যবহারকারীর প্রোফাইল ফটোর URL, যদি উপলভ্য থাকে।

ঐচ্ছিক স্ট্রিং

ব্যবহারকারীর রিভিউ। Google Places-এর মাধ্যমে কোনও লোকেশন পর্যালোচনা করার সময়, টেক্সট রিভিউকে ঐচ্ছিক হিসেবে বিবেচনা করা হয়। তাই, এই ফিল্ডটি খালি থাকতে পারে। মনে রাখবেন, এই ফিল্ডে বেসিক HTML মার্কআপ থাকতে পারে। যেমন, এন্টিটি রেফারেন্স &amp; একটি অ্যাম্পারস্যান্ড অক্ষরকে উপস্থাপন করতে পারে।

ঐচ্ছিক বুলিয়ান

রিভিউটি যে মূল ভাষায় লেখা হয়েছে সেটি থেকে অনুবাদ করা হয়েছে কিনা তা বোঝাতে বুলিয়ান মান ব্যবহার করা হয়। কোনও রিভিউ অনুবাদ করা হলে, সেটির জন্য 'সত্য' মান ব্যবহার করা হয়। Google সাজেস্ট করে যে আপনি এই বিষয়টি ব্যবহারকারীদের জানান। যেমন, আপনি পর্যালোচনায় নিম্নলিখিত স্ট্রিং, "Google-এর মাধ্যমে অনুবাদ করা হয়েছে", যোগ করতে পারেন।