جستوجوی شهر
جستوجوی شهر با تکمیل خودکار (type-ahead) روی یک پایگاه جهانی نامهای جغرافیایی. نام شهر پیداشده، کشور و مختصات آن را برمیگرداند.
GET/Geo/cities/search
دسترسی عمومی، بدون نیاز به نشست
این یک جستوجوی جغرافیایی عمومی است که روی نام شهرها و نامهای جایگزین شناختهشدهٔ آنها به زبانهای مختلف تطبیق داده میشود و به موجودی هتل یا پرواز وابسته نیست. برای یافتن مقصد هتلی قابل رزرو، بهجای آن از جستوجوی مکان هتل استفاده کنید.
پارامترهای مسیر#
ندارد.
پارامترهای کوئری#
| نام | نوع | الزامی | پیشفرض | توضیح |
|---|---|---|---|---|
q | string | الزامی | - | متن تایپشده، بین ۱ تا ۱۲۸ کاراکتر. |
limit | integer | اختیاری | 10 | حداکثر تعداد نتایج، بین ۱ تا ۵۰. |
country | string | اختیاری | - | محدودکردن نتایج به یک کد کشور دوحرفی، مثلاً 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()پاسخ#
| فیلد | نوع | توضیح |
|---|---|---|
data | array of object | شهرهای منطبق، به ترتیب از بهترین تطابق. جزئیات در ادامه. |
meta | object | query، count، limit. |
{
"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 }
}ویرایش این صفحه در گیتهابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.