واجهة API للترميز الجغرافي العكسي
أرسل خط عرض وخط طول واحصل على أقرب عنوان، مع الشارع والمدينة والمنطقة والرمز البريدي والدولة مفصّلة، بالإضافة إلى بُعد العنوان عن النقطة التي أرسلتها. اطلب إجابة أقل تفصيلًا باستخدام level عندما تريد المدينة أو الدولة فقط.
مثال
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/reverse?lat=48.8584&lon=2.2945"تقع النقطة على بعد أمتار قليلة من قاعدة برج إيفل. الاستجابة هي أقرب عنوان بريدي، ويخبرك distance_m بأنه على بعد 12 مترًا. ولو كان أقرب عنوان على بعد 400 مترًا، من نقطة داخل حديقة مثلًا، لرأيت ذلك أيضًا ولأمكنك أن تقرر عرض الحي بدلًا منه.
أضف level=city لتخطي العنوان والحصول على المنطقة المحلية مباشرة، أو level=country لاستعلام سريع عن الدولة.
{
"status": "ok",
"lat": 48.8584,
"lon": 2.2945,
"result": {
"formatted": "5 Avenue Anatole France, 75007 Paris, France",
"lat": 48.85837,
"lon": 2.29448,
"distance_m": 12,
"type": "address",
"precision": "house",
"components": {
"house_number": "5",
"road": "Avenue Anatole France",
"suburb": "7th Arrondissement",
"city": "Paris",
"state": "Ile-de-France",
"postcode": "75007",
"country": "France",
"country_code": "fr"
}
}
}ما تحصل عليه
| الحقل | المعنى |
|---|---|
result.formatted | أقرب عنوان بتنسيق تلك الدولة. |
result.lat, result.lon | موقع العنوان نفسه، لا النقطة التي أرسلتها. |
result.distance_m | المسافة بالأمتار بين نقطتك والعنوان. الرقم الكبير يعني أنك لست فعلًا عند عنوان. |
result.precision | إحدى القيم house أو street أو postcode أو admin، بحسب ما يوجد قرب النقطة في تلك الدولة. |
result.components | أجزاء العنوان بالمفاتيح نفسها المستخدمة في الترميز الجغرافي الأمامي. |
قيمة result هي null | لا شيء ضمن 5 كم من النقطة. محيط مفتوح، القارة القطبية الجنوبية. تبقى الحالة ok. |
أين تُستخدم
تسمية نقاط GPS
حوّل موقع الجهاز إلى «قرب 5 Avenue Anatole France» لسجل أو إيصال أو تعليق على صورة. استخدم distance_m للتبديل بين «عند» و«قرب».
الإعدادات الافتراضية المحلية
املأ الدولة أو العملة أو اللغة مسبقًا من موقع الزائر باستخدام level=country. استخدمه مع الاستعلام عن IP عندما لا تتوفر لديك إحداثيات.
التوصيل والعمل الميداني
حوّل المكان الذي توقف فيه السائق فعلًا إلى عنوان وقارنه بالمكان الذي حدده الطلب.
السعر والحدود
استدعاء واحد، طلب واحد. لكل مفتاح 2,500 طلب مجاني يوميًا، وبعد ذلك يُخصم 0.0001 € لكل طلب من الرصيد المسبق الدفع، أو لا شيء على مفتاح Unlimited (50 € شهريًا). الأسعار. تجيب المضيفات البديلة المتوافقة على الطلبات العكسية بتنسيقات Google وNominatim وMapbox وتنسيقات أخرى.