مستندات

جست‌وجو در مستندات

نام اندپوینت، موضوع یا کلیدواژه را بنویسید

جست‌وجوی شهر

جست‌وجوی شهر با تکمیل خودکار (type-ahead) روی یک پایگاه جهانی نام‌های جغرافیایی. نام شهر پیداشده، کشور و مختصات آن را برمی‌گرداند.

GET/Geo/cities/search

دسترسی عمومی، بدون نیاز به نشست

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

پارامترهای مسیر#

ندارد.

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

نامنوعالزامیپیش‌فرضتوضیح
qstringالزامی-متن تایپ‌شده، بین ۱ تا ۱۲۸ کاراکتر.
limitintegerاختیاری10حداکثر تعداد نتایج، بین ۱ تا ۵۰.
countrystringاختیاری-محدودکردن نتایج به یک کد کشور دوحرفی، مثلاً FR.

درخواست#

curl "https://api.simorghapi.com/api/Geo/cities/search?q=munch&limit=5&country=DE"
const params = new URLSearchParams({ q: "munch", limit: "5", country: "DE" });
const res = await fetch("https://api.simorghapi.com/api/Geo/cities/search?" + params);
const data = await res.json();
import requests

res = requests.get(
    "https://api.simorghapi.com/api/Geo/cities/search",
    params={"q": "munch", "limit": 5, "country": "DE"},
)

data = res.json()

پاسخ#

فیلدنوعتوضیح
dataarray of objectشهرهای منطبق، به ترتیب از بهترین تطابق. جزئیات در ادامه.
metaobjectquery، count، limit.
data[] object
فیلدنوعتوضیح
termstringنام جایگزینی که با متن شما تطبیق داده شد.
namestringنام رسمی شهر.
asciinamestringشکل ASCII نام.
geonameidintegerشناسهٔ پایدار شهر در پایگاه نام‌های جغرافیایی.
country_codestringکد دوحرفی کشور.
admin1_codestringکد تقسیمات کشوری سطح اول (استان/ایالت).
populationintegerجمعیت شهر.
latitude / longitudenumberمختصات جغرافیایی.
feature_codestringکد نوع عارضهٔ جغرافیایی.
timezonestringمنطقهٔ زمانی IANA.
{
  "data": [
    {
      "term": "Munchen",
      "name": "Munich",
      "asciiname": "Munich",
      "geonameid": 2867714,
      "country_code": "DE",
      "admin1_code": "02",
      "population": 1260391,
      "latitude": 48.13743,
      "longitude": 11.57549,
      "feature_code": "PPLA",
      "timezone": "Europe/Berlin"
    }
  ],
  "meta": { "query": "munch", "count": 1, "limit": 5 }
}
ویرایش این صفحه در گیت‌هابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.