GeoTajak Geocoding Services API

مستندات API سرویس‌های جغرافیایی GeoTajak Cloud

Base URL

https://service.geotajak.ir

Authentication

تمامی درخواست‌ها نیاز به توکن احراز هویت دارند که باید در هدر Authorization ارسال شود:

Authorization: Bearer YOUR_TOKEN_HERE

Point to Address (Reverse Geocoding)

تبدیل مختصات جغرافیایی (latitude/longitude) به آدرس متنی

Endpoint

GET /geocode/point-to-address

Query Parameters

Parameter	Type	Required	Description
`lat`	float	✅	عرض جغرافیایی (Latitude)
`lon`	float	✅	طول جغرافیایی (Longitude)
`result_format`	string	❌	فرمت خروجی (پیش‌فرض: `json`)

Request Example

curl 'https://service.geotajak.ir/geocode/point-to-address?lat=36.84102863574198&lon=54.475080541522374&result_format=json' \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE'

Response Example

{
  "result": {
    "place_id": 744522,
    "osm_type": "way",
    "osm_id": 384824785,
    "lat": "36.84103117699143",
    "lon": "54.47509387632518",
    "display_name": "شهید زراعت گری, کاشانی, شهر گرگان, بخش مرکزی, شهرستان گرگان, استان گلستان, 49157-77797, ایران",
    "address": {
      "road": "شهید زراعت گری",
      "neighbourhood": "کاشانی",
      "city": "شهر گرگان",
      "district": "بخش مرکزی",
      "county": "شهرستان گرگان",
      "state": "استان گلستان",
      "ISO3166-2-lvl4": "IR-27",
      "postcode": "49157-77797",
      "country": "ایران",
      "country_code": "ir"
    },
    "boundingbox": [
      "36.8395669",
      "36.841974",
      "54.4749142",
      "54.475373"
    ]
  },
  "status": 200,
  "success": true,
  "messages": []
}

Response Fields

place_id: شناسه یکتای مکان
osm_type: نوع شیء در OpenStreetMap (way, node, relation)
osm_id: شناسه OpenStreetMap
lat/lon: مختصات دقیق
display_name: آدرس کامل به صورت متنی
address: اجزای آدرس به صورت ساختاریافته
- road: نام خیابان
- neighbourhood: محله
- city: شهر
- district: بخش
- county: شهرستان
- state: استان
- postcode: کد پستی
- country: کشور
- country_code: کد کشور (ISO)
boundingbox: محدوده جغرافیایی [min_lat, max_lat, min_lon, max_lon]