curl -s "https://navvo.io/api/v1/geo/pluscode?lat=31.94920&lng=35.89970&length=10" \
  -H "x-api-key: nvvo_YOUR_KEY"

{
  "provider": "navvo-addressing",
  "code": "8G3QXW36+H6",
  "lat": 31.9492,
  "lng": 35.8997
}

# رمز كامل — لا حاجة لمرجع
curl -s "https://navvo.io/api/v1/geo/pluscode/decode?code=8G3QXW36%2BH6" \
  -H "x-api-key: nvvo_YOUR_KEY"

# رمز قصير/محلي — مرِّر نقطة مرجعية قريبة
curl -s "https://navvo.io/api/v1/geo/pluscode/decode?code=XW36%2BH6&lat=31.95&lng=35.90" \
  -H "x-api-key: nvvo_YOUR_KEY"

{
  "provider": "navvo-addressing",
  "code": "8G3QXW36+H6",
  "lat": 31.949125,
  "lng": 35.899625,
  "bounds": {
    "south": 31.94906,
    "west": 35.89956,
    "north": 31.94919,
    "east": 35.89969
  }
}

curl -s "https://navvo.io/api/v1/geo/address?lat=31.94920&lng=35.89970" \
  -H "x-api-key: nvvo_YOUR_KEY"

{
  "provider": "navvo-addressing",
  "lat": 31.9492,
  "lng": 35.8997,
  "plusCode": "8G3QXW36+H6",
  "shortCode": "XW36+H6",
  "locality": "عبدون، عمّان",
  "localAddress": "XW36+H6 عبدون، عمّان",
  "shareUrl": "https://navvo.io/a/8G3QXW36+H6"
}

curl -s -X POST "https://navvo.io/api/v1/geo/address/batch" \
  -H "x-api-key: $NAVVO_API_KEY" -H "content-type: application/json" \
  -d '{ "points": [ {"lat":31.9539,"lng":35.9106}, {"lat":29.532,"lng":35.006} ], "length": 10 }'

{
  "provider": "navvo-addressing", "count": 2, "resolved": 2,
  "results": [
    { "lat": 31.9539, "lng": 35.9106, "ok": true, "plusCode": "8G3QXW36+H6", "shortCode": "XW36+H6", "locality": "منطقة زهران, عمان", "localAddress": "XW36+H6 منطقة زهران, عمان" }
  ]
}

# إدخال بالعربيزي — أبجدية الدردشة برقم يحلّ محلّ حرف عربي
curl -s "https://navvo.io/api/v1/geocode/autocomplete?q=shar3%20abdali&limit=5" \
  -H "x-api-key: nvvo_YOUR_KEY"

{
  "provider": "navvo-geocode",
  "query": "shar3 abdali",
  "normalizedQuery": "شارع العبدلي",
  "suggestions": [
    {
      "id": "way/98765432",
      "label": "شارع العبدلي، عمّان",
      "name": "شارع العبدلي",
      "lat": 31.96374,
      "lng": 35.92213,
      "type": "road",
      "category": "highway"
    }
  ]
}