جست‌وجوی مقصد

پیش از جست‌وجوی هتل، عبارتی را که مسافر تایپ کرده به یک مقصد تبدیل کنید. جست‌وجوی مکان، شهرها، محله‌ها و هتل‌های منطبق را برمی‌گرداند؛ هرکدام با یک شناسهٔ ثابت که آن را به جست‌وجوی موجودی می‌دهید.

جست‌وجوی مکان‌ها#

GET/v3/HAPI/hotels/places

به اسکوپ hotels:read نیاز دارد.

پارامترهای کوئری#

نام	نوع	الزامی	توضیح
`query`	string	الزامی	عبارتی که مسافر تایپ کرده، مثلاً `dubai`.
`limit`	integer	اختیاری	حداکثر تعداد نتایج، بین 1 تا 100 (پیش‌فرض 20).
`type`	string	اختیاری	فیلتر: `city`، `region`، `country`، `hotel`، `landmark`، `district`.

curl "https://api.simorghapi.com/v3/HAPI/hotels/places?query=dubai&type=city" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

پاسخ#

{
  "object": "hotel_place_list",
  "count": 2,
  "data": [
    {
      "id": "1019782831",
      "name": "Dubai",
      "type": "city",
      "country": "United Arab Emirates",
      "coordinates": { "lat": 25.20, "lng": 55.27 }
    },
    {
      "id": "3038948",
      "name": "Dubai Marina",
      "type": "district",
      "country": "United Arab Emirates",
      "coordinates": null
    }
  ]
}

شناسه را به‌عنوان مقصد به کار ببرید. id مکانی از نوع city همان city_id برای جست‌وجوی موجودی است و id مکانی از نوع hotel همان hotel_id.

ویرایش این صفحه در گیت‌هابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.