ژئوتاژک - سامانه مدیریت و یکپارچه‌سازی اطلاعات مکانی

Address to Point (Forward Geocoding)

تبدیل آدرس متنی به مختصات جغرافیایی

Endpoint

GET /geocode/address-to-point

Query Parameters

Parameter	Type	Required	Description
`q`	string	✅	متن آدرس برای جستجو
`format`	string	❌	فرمت خروجی (پیش‌فرض: `json`)
`addressdetails`	integer	❌	نمایش جزئیات آدرس (0 یا 1)
`polygon_geojson`	integer	❌	دریافت GeoJSON مرزها (0 یا 1)
`limit`	integer	❌	تعداد نتایج (پیش‌فرض: 1000)
`bounded`	integer	❌	محدود کردن جستجو به محدوده (0 یا 1)
`accept-language`	string	❌	زبان نتایج (مثال: `fa`)

Request Example

curl 'https://service.geotajak.ir/geocode/address-to-point?q=کاشانی&format=json&addressdetails=1&polygon_geojson=1&limit=10' \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE'

Response Example

{
  "result": [
    {
      "place_id": 2206516,
      "licence": "Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
      "osm_type": "relation",
      "osm_id": 8683195,
      "boundingbox": [
        "36.8374225",
        "36.8468539",
        "54.4649279",
        "54.4776331"
      ],
      "lat": "36.8405613",
      "lon": "54.4755398",
      "display_name": "کاشانی, شهر گرگان, بخش مرکزی, شهرستان گرگان, استان گلستان, ایران",
      "class": "boundary",
      "type": "administrative",
      "importance": 0.36,
      "address": {
        "neighbourhood": "کاشانی",
        "city": "شهر گرگان",
        "district": "بخش مرکزی",
        "county": "شهرستان گرگان",
        "state": "استان گلستان",
        "ISO3166-2-lvl4": "IR-27",
        "country": "ایران",
        "country_code": "ir"
      },
      "geojson": {
        "type": "Polygon",
        "coordinates": [
          [
            [54.4649279, 36.8380597],
            [54.4650559, 36.8375006],
            ...
          ]
        ]
      }
    }
  ],
  "status": 200,
  "success": true,
  "messages": []
}

Response Fields

result: آرایه‌ای از نتایج جستجو
place_id: شناسه یکتای مکان
lat/lon: مختصات جغرافیایی
display_name: آدرس کامل
class/type: دسته‌بندی مکان
importance: اهمیت نتیجه (0 تا 1)
address: اجزای آدرس
geojson: مرزهای جغرافیایی به فرمت GeoJSON (در صورت درخواست)
boundingbox: محدوده جغرافیایی