جستجوی اطراف (قدیمی)

«جستجوی اطراف (قدیمی)» به شما امکان می‌دهد مکان‌ها را در منطقه‌ای مشخص جستجو کنید. می‌توانید درخواست جستجویتان را با ارائه کلیدواژه‌ها یا مشخص کردن نوع مکانی که جستجو می‌کنید پالایش کنید.

درخواست‌های «جستجوی اطراف» (قدیمی)

درخواست «جستجوی اطراف (قدیمی)» یک نشانی وب HTTP به‌شکل زیر است:

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

که در آن output می‌تواند یکی از مقادیر زیر باشد:

• json (توصیه‌شده) نشان‌دهنده خروجی در JavaScript Object Notation (JSON) است
• xml برونداد را به‌صورت XML نشان می‌دهد

پارامترهای خاصی برای شروع درخواست «جستجوی اطراف» (قدیمی) لازم است. همان‌طور که در نشانی‌های وب استاندارد است، همه پارامترها بااستفاده از نویسه اَمپرسند (&) از هم جدا می‌شوند.

پارامترهای الزامی

• مکان

  نقطه‌ای که اطلاعات مکان در اطراف آن بازیابی می‌شود. این باید به‌صورت latitude,longitude مشخص شود.

• شعاع

  فاصله‌ای (به متر) را تعریف می‌کند که نتایج مکان در آن برگردانده می‌شود. با ارسال پارامتر location و radius می‌توانید نتایج را به دایره مشخصی متمایل کنید. با این کار، به سرویس Places دستور داده می‌شود که نمایش نتایج درون آن دایره را ترجیح دهد؛ نتایج خارج از منطقه تعریف‌شده ممکن است همچنان نمایش داده شوند.

  شعاع به‌طور خودکار به حداکثر مقدار بسته به نوع جستجو و پارامترهای دیگر محدود می‌شود.

  • تکمیل خودکار: ۵۰٬۰۰۰ متر
  • جستجوی اطراف:
    • با keyword یا name: ۵۰٬۰۰۰ متر
    • بدون keyword یا name
      • تا ۵۰٬۰۰۰ متر، که به‌طور پویا براساس تراکم منطقه تنظیم می‌شود، مستقل از پارامتر rankby.
      • هنگام استفاده از rankby=distance، پارامتر شعاع پذیرفته نخواهد شد و منجر به INVALID_REQUEST می‌شود.
  • تکمیل خودکار پُرسمان: ۵۰٬۰۰۰ متر
  • جستجوی نوشتار: ۵۰٬۰۰۰ متر

پارامترهای اختیاری

• کلمه کلیدی

  رشته نوشتاری که باید جستجو شود، برای مثال: «رستوران» یا «خیابان اصلی ۱۲۳». این باید نام، نشانی، یا دسته مکان باشد. هر نوع ورودی دیگری می‌تواند خطا ایجاد کند و تضمینی برای برگرداندن نتایج معتبر وجود ندارد. سرویس Google Places مطابقت‌های نامزد را براساس این رشته برمی‌گرداند و نتایج را براساس ارتباط درک‌شده آن‌ها مرتب می‌کند.

  گنجاندن صریح اطلاعات مکان بااستفاده از این پارامتر ممکن است با پارامترهای مکان، شعاع، و rankby تداخل داشته باشد و باعث نتایج غیرمنتظره شود.

  اگر این پارامتر حذف شود، مکان‌هایی که business_status آن‌ها CLOSED_TEMPORARILY یا CLOSED_PERMANENTLY باشد برگردانده نخواهند شد.

• زبان

  زبانی که نتایج به آن برگردانده می‌شود.

  • فهرست زبان‌های پشتیبانی‌شده را ببینید. Google اغلب زبان‌های پشتیبانی‌شده را به‌روز می‌کند، بنابراین این فهرست ممکن است جامع نباشد.
  • اگر language ارائه نشده باشد، API تلاش می‌کند از زبان ترجیحی مشخص‌شده در سرصفحه Accept-Language استفاده کند.
  • این API تمام تلاش خود را می‌کند تا نشانی خیابانی ارائه دهد که هم برای کاربر و هم برای افراد محلی قابل‌خواندن باشد. برای دستیابی به این هدف، نشانی‌های خیابان را به زبان محلی برمی‌گرداند و درصورت لزوم، با رعایت زبان ترجیحی، آن‌ها را به نویسه‌ای که برای کاربر خوانا باشد نویسه‌گردانی می‌کند. همه نشانی‌های دیگر به زبان ترجیحی برگردانده می‌شوند. همه مؤلفه‌های نشانی به همان زبانی برگردانده می‌شوند که از مؤلفه اول انتخاب شده است.
  • اگر نامی به زبان ترجیحی دردسترس نباشد، API از نزدیک‌ترین مطابقت استفاده می‌کند.
  • زبان ترجیحی تأثیر کمی بر مجموعه نتایجی دارد که میانای برنامه‌سازی کاربردی برای برگرداندن انتخاب می‌کند و ترتیبی که در آن برگردانده می‌شوند. زمین‌کدیاب اختصارات را بسته به زبان به‌طور متفاوتی تفسیر می‌کند، مانند اختصارات برای انواع خیابان‌ها، یا مترادف‌هایی که ممکن است در یک زبان معتبر باشند اما در زبان دیگر معتبر نباشند. برای مثال، utca و tér در زبان مجاری مترادف خیابان هستند.

• maxprice

  نتایج را فقط به مکان‌های موجود در محدوده مشخص‌شده محدود می‌کند. محدوده مقادیر معتبر بین ۰ (مقرون‌به‌صرفه‌ترین) تا ۴ (گران‌ترین) است. مقدار دقیق نشان‌داده‌شده با یک مقدار خاص از منطقه‌ای به منطقه دیگر متفاوت خواهد بود.

• minprice

  نتایج را فقط به مکان‌های موجود در محدوده مشخص‌شده محدود می‌کند. محدوده مقادیر معتبر بین ۰ (مقرون‌به‌صرفه‌ترین) تا ۴ (گران‌ترین) است. مقدار دقیق نشان‌داده‌شده با یک مقدار خاص از منطقه‌ای به منطقه دیگر متفاوت خواهد بود.

• نام

  معادل keyword. مقادیر این فیلد با مقادیر فیلد keyword ترکیب می‌شود و به‌عنوان بخشی از همان رشته جستجو ارسال می‌شود.

• opennow

  فقط مکان‌هایی را برمی‌گرداند که در زمان ارسال پُرسمان برای کسب‌وکار باز هستند. اگر این پارامتر را در پُرسمان خود بگنجانید، مکان‌هایی که ساعت کاری آن‌ها در پایگاه داده Google Places مشخص نشده است برگردانده نخواهند شد.

• pagetoken

  تا ۲۰ نتیجه از جستجوی قبلاً اجراشده را برمی‌گرداند. تنظیم پارامتر pagetoken جستجویی را با همان پارامترهایی که قبلاً استفاده شده است اجرا می‌کند—همه پارامترها به‌جز pagetoken نادیده گرفته می‌شوند.

• رتبه‌بندی براساس

  ترتیب فهرست شدن نتایج را مشخص می‌کند. مقادیر ممکن عبارت‌اند از:

  • prominence (پیش‌فرض). این گزینه نتایج را براساس اهمیت آن‌ها مرتب می‌کند. رتبه‌بندی جاهای برجسته را در شعاع تعیین‌شده به جاهای اطراف که مطابقت دارند اما کمتر برجسته هستند ترجیح می‌دهد. رتبه مکان در نمایه Google، محبوبیت جهانی، و عوامل دیگر می‌تواند بر برجستگی تأثیر بگذارد. وقتی برجستگی مشخص شده باشد، پارامتر radius الزامی است.
  • distance. این گزینه نتایج جستجو را به‌ترتیب صعودی براساس فاصله آن‌ها از مکان مشخص‌شده سوگیری می‌کند. وقتی distance مشخص شده باشد، یک یا چند مورد از keyword، name، یا type الزامی است و radius مجاز نیست.

• نوع

  نتایج را به مکان‌هایی که با نوع مشخص‌شده مطابقت دارند محدود می‌کند. فقط یک نوع را می‌توانید مشخص کنید. اگر بیش‌از یک نوع ارائه دهید، API همه انواع پس‌از ورودی اول را نادیده می‌گیرد.

  • ‫type=hospital|pharmacy|doctor به type=hospital تبدیل می‌شود
  • type=hospital,pharmacy,doctor کاملاً نادیده گرفته شده است

  فهرست انواع پشتیبانی‌شده را ببینید.

  توجه: افزودن هر دو keyword و type با مقدار یکسان (keyword=cafe&type=cafe یا keyword=parking&type=parking) می‌تواند ZERO_RESULTS را به‌همراه داشته باشد.

نمونه «جستجوی اطراف» (قدیمی)

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522%2C151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?keyword=cruise
  &location=-33.8670522%2C151.1957362
  &radius=1500
  &type=restaurant
  &key=YOUR_API_KEY

توجه: در این مثال، باید key را با کلید میانای برنامه‌سازی کاربردی خودتان جایگزین کنید تا درخواست در برنامه‌تان کار کند.

پاسخ‌های «جستجوی اطراف» (قدیمی)

مثال زیر پاسخ جستجوی اطراف (قدیمی) را نشان می‌دهد.

{
  "html_attributions": [],
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8587323, "lng": 151.2100055 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85739847010727, "lng": 151.2112436298927 },
                "southwest":
                  { "lat": -33.86009812989271, "lng": 151.2085439701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet",
        "name": "Cruise Bar",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 608,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uECvJIZuXT-uLDYm4DPbrV7gXVPeplbTWUgcOJ6rnfc4bUYCEAwPU_AmXGIaj0PDhWPbmrjQC8hhuXRJQjnA1-iREGEn7I0ZneHg5OP1mDT7lYVpa1hUPoz7cn8iCGBN9MynjOPSUe-UooRrFw2XEXOLgRJ-uKr6tGQUp77CWVocpcoG",
              "width": 1080,
            },
          ],
        "place_id": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "plus_code":
          {
            "compound_code": "46R6+G2 The Rocks, New South Wales",
            "global_code": "4RRH46R6+G2",
          },
        "price_level": 2,
        "rating": 4,
        "reference": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "scope": "GOOGLE",
        "types":
          ["bar", "restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 1269,
        "vicinity": "Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8675219, "lng": 151.2016502 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86614532010728, "lng": 151.2031259298927 },
                "southwest":
                  { "lat": -33.86884497989272, "lng": 151.2004262701072 },
              },
          },
        "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",
        "name": "Sydney Harbour Dinner Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 835,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEBVsYnNcrpRixtrlHBztigZh70CwYkNWZzQnqJ39SjeBo_wvgKf-kXc6tgaMLBdQrRKmxmSKjOezoZrv-sHKVbTX0OI48HBqYYVnQiZQ-WGeuQDsLEPwX7LaVPa68nUAxX114Zpqt7bryoO9wL4qXdgEnopbOp5WWLALhKEHoIEH7f7",
              "width": 1200,
            },
          ],
        "place_id": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "plus_code":
          {
            "compound_code": "46J2+XM Sydney, New South Wales",
            "global_code": "4RRH46J2+XM",
          },
        "rating": 4.8,
        "reference": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 9,
        "vicinity": "32 The Promenade, Sydney",
      },
      // ...
    ],
  "status": "OK",
}
    

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Cruise Bar</name>
  <vicinity>Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8587323</lat>
    <lng>151.2100055</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8600981</lat>
     <lng>151.2085440</lng>
    </southwest>
    <northeast>
     <lat>-33.8573985</lat>
     <lng>151.2112436</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png</icon>
  <reference>ChIJi6C1MxquEmsR9-c-3O48ykI</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEALIq4sgBHhIYWWapOH2NV1T2I7YdOiLzEH7z-483I764cId1sZkbzSq-hVYTk1PQeaHuZzlRfA7-ilwJ3QWon4b37ePd-PBwZbOwFZHxhYs0Cs7jRSgMHWfOzGivp6ZFG4iupyz50qS5pBZT1WbA2ufacTq_U21TtgffQD31wKRPQk</photo_reference>
   <width>1080</width>
   <height>608</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112582655193348962755&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>1269</user_ratings_total>
  <place_id>ChIJi6C1MxquEmsR9-c-3O48ykI</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46R6+G2</global_code>
   <compound_code>46R6+G2 The Rocks, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Sydney Harbour Dinner Cruises</name>
  <vicinity>32 The Promenade, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675219</lat>
    <lng>151.2016502</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8688450</lat>
     <lng>151.2004263</lng>
    </southwest>
    <northeast>
     <lat>-33.8661453</lat>
     <lng>151.2031259</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.8</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJM1mOVTS6EmsRKaDzrTsgids</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB5jH7GXdcozv1Y5HX18syo4f128S58NVUnqBbLJMpWbC39K49wp-wzsLOsUT8QKDaag6ISFL8hl1vVuig4jkc5fMMkWKiqw5PY-ebcWZ5tI3gEXEYGGoG_mDAulaMLudUpSwgBx2_RLnA0SSiugqqQUTYlkGyCZSe8HSyngVczy6XN</photo_reference>
   <width>1200</width>
   <height>835</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/109764923610545394994&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>9</user_ratings_total>
  <place_id>ChIJM1mOVTS6EmsRKaDzrTsgids</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+XM</global_code>
   <compound_code>46J2+XM Sydney, New South Wales</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>
 <!-- ... -->
</PlaceSearchResponse>

    

PlacesNearbySearchResponse

PlacesSearchStatus

رمزهای وضعیت برگردانده‌شده توسط سرویس.

• OK که نشان می‌دهد درخواست API موفقیت‌آمیز بوده است.
• ZERO_RESULTS نشان می‌دهد که جستجو موفقیت‌آمیز بوده است اما نتیجه‌ای برنگردانده است. این اتفاق ممکن است زمانی رخ دهد که جستجو به latlng در مکانی دور منتقل شده باشد.
• INVALID_REQUEST نشان می‌دهد که درخواست میانای برنامه‌سازی کاربردی بدشکل بوده است، معمولاً به‌دلیل نبود پارامتر پُرسمان الزامی (location یا radius).
• OVER_QUERY_LIMIT که نشان‌دهنده هریک از موارد زیر باشد:
  • از حد مجاز «پرس‌وجو در ثانیه» فراتر رفته‌اید.
  • صدور صورت‌حساب در حسابتان فعال نشده است.
  • از اعتبار ماهانه ۲۰۰ دلاری یا سقف استفاده خودتحمیلی فراتر رفته‌اید.
  • روش پرداخت ارائه‌شده دیگر معتبر نیست (برای مثال، کارت اعتباری منقضی شده است).
  برای اطلاعات بیشتر درباره نحوه رفع این خطا، پرسشگان Maps را ببینید.
• REQUEST_DENIED که نشان می‌دهد درخواستتان رد شده است، معمولاً به‌دلیل:
  • درخواست فاقد کلید میانای برنامه‌سازی کاربردی است.
  • پارامتر key نامعتبر است.
• UNKNOWN_ERROR که نشان‌دهنده خطای ناشناخته است.

جا

پاسخ‌های «جستجوی جاها» زیرمجموعه زیر از فیلدهای جا را برمی‌گرداند. همه مشخصه‌ها برای همه انواع مکان دردسترس نیستند. برای بازیابی فیلدهایی که «جستجوی جاها» برنمی‌گرداند، مثل address_components،‏ formatted_phone_number، reviews، یا website، place_id برگردانده‌شده را در درخواست جزئیات جا (قدیمی) ارسال کنید. برای اطلاع از دردسترس بودن فیلد و سطوح قیمت‌گذاری در نقاط پایانی، به فیلدهای داده مکان (قدیمی) مراجعه کنید.

دسترسی به نتایج تکمیلی

به‌طور پیش‌فرض، هر پاسخ حداکثر ۲۰ نتیجه establishment به‌ازای هر پُرسمان برمی‌گرداند؛ بااین‌حال، هر جستجو می‌تواند تا ۶۰ نتیجه برگرداند که در سه صفحه تقسیم شده‌اند. اگر جستجوی شما بیش‌از ۲۰ نتیجه داشته باشد، پاسخ جستجو شامل مقدار دیگری خواهد بود — next_page_token. مقدار next_page_token را به پارامتر pagetoken درخواست جدید منتقل کنید تا مجموعه بعدی نتایج را ببینید.

• اگر next_page_token تهی باشد یا برگردانده نشود، دراین‌صورت نتیجه دیگری وجود ندارد.
• تکرار درخواست با همان next_page_token صفحه بعدی نتایج را برمی‌گرداند.
• تنظیم pagetoken باعث می‌شود هر پارامتر دیگری نادیده گرفته شود.
• می‌توانید تا دو بار پس‌از پُرسمان اصلی، صفحه جدیدی درخواست کنید.
• هر درخواست، ازجمله درخواست بااستفاده از next_page_token، به‌عنوان یک درخواست واحد در محدودیت‌های استفاده شما محسوب می‌شود و به‌طور جداگانه هزینه آن دریافت می‌شود.
• بین زمان صدور next_page_token و زمان معتبر شدن آن چند ثانیه تأخیر وجود دارد. درخواست صفحه بعدی قبل‌از دردسترس بودن آن، پاسخ INVALID_REQUEST را برمی‌گرداند. درخواست‌های دارای next_page_token همیشه مشمول هزینه می‌شوند.

برای مثال، در پُرسمان زیر، رستوران‌های نزدیک دارلینگ هاربر در سیدنی استرالیا را جستجو می‌کنیم و نتایج را براساس فاصله رتبه‌بندی می‌کنیم. می‌توانید ببینید که پاسخ حاوی ویژگی next_page_token است.

{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [...]
   "status" : "OK"
}

برای دیدن مجموعه بعدی نتایج، می‌توانید پُرسمان جدیدی ارسال کنید و نتیجه next_page_token را به پارامتر pagetoken منتقل کنید. برای مثال:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY