الترميز الجغرافي العكسي

تُدخل إحداثيات فتحصل على أقرب عنوان، أو على المنطقة أو الإقليم أو الدولة إن كان هذا كل ما تريده.

المعاملات

مثال

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/reverse?lat=41.8902&lon=12.4922&lang=it"

const url = new URL("https://api.mygeocode.com/v1/reverse");
url.searchParams.set("lat", 41.8902);
url.searchParams.set("lon", 12.4922);
url.searchParams.set("lang", "it");

const { result } = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
console.log(result ? result.formatted : "nothing nearby");

import requests

r = requests.get("https://api.mygeocode.com/v1/reverse",
                 params={"lat": 41.8902, "lon": 12.4922, "lang": "it"}, headers={"X-API-Key": "YOUR_KEY"}, timeout=10)
result = r.json()["result"]
print(result["formatted"] if result else "nothing nearby")

{
  "status": "ok",
  "lat": 41.8902,
  "lon": 12.4922,
  "result": {
    "formatted": "Piazza del Colosseo 1, 00184 Roma RM, Italia",
    "lat": 41.890251,
    "lon": 12.492373,
    "distance_m": 9,
    "type": "address",
    "precision": "house",
    "place_id": "it.addr.5d09aa31",
    "components": {
      "house_number": "1",
      "road": "Piazza del Colosseo",
      "suburb": "Municipio Roma I",
      "city": "Roma",
      "county": "Roma",
      "state": "Lazio",
      "postcode": "00184",
      "country": "Italia",
      "country_code": "it"
    }
  }
}

حقول الاستجابة

ملاحظات

• القيمة الكبيرة في distance_m إشارة. قد تبعد نقطة في حديقة 300 م عن أقرب عنوان، وفي هذه الحالة يكون عرض الحي أفضل عادةً من عرض العنوان.
• يجيب level=country في نحو جزء من الألف من الثانية، وهو أرخص طريقة للإجابة عن سؤال «في أي دولة تقع هذه النقطة».
• النقاط الواقعة في البحر تعيد null على مستوى address، وضمن المياه الإقليمية تعيد الدولة على مستوى country.

الاستعلام نفسه بصيغ المزوّدين الآخرين

إذا كان لديك كود مكتوب بالفعل لأحد هؤلاء المزوّدين فاحتفظ به: يقبل المضيف البديل المتوافق المسار والمعاملات نفسها ويجيب بشكل استجابة ذلك المزوّد، وخلفه نقطة النهاية هذه. راجع كيف تعمل المضيفات البديلة المتوافقة.

الاستعلامات المجمّعة

أرسل جسم JSON إلى المسار نفسه بطريقة POST يحتوي على coords، وهي مصفوفة تضم حتى 100 زوج [lat, lon]، وستحمل الإجابة مصفوفة results فيها إدخال واحد لكل زوج بترتيب الإرسال. يُحتسب كل إدخال طلبًا واحدًا، والدفعة الأكبر مما تبقى من الحصة تُرفض كاملة.

$ curl -X POST "https://api.mygeocode.com/v1/reverse" -H "Content-Type: application/json" -d '{"coords": [[52.5163, 13.3777], [47.3769, 8.5417]]}'

الأخطاء

400 invalid_request عندما يكون lat أو lon مفقودًا أو خارج النطاق، أو لا يكون level إحدى القيم المدرجة.