واجهة API للترميز الجغرافي الأمامي
أرسل عنوانًا أو اسم مكان أو رمزًا بريديًا أو وصفًا تقريبيًا مثل «مقهى قرب Kings Cross» واحصل على الإحداثيات وعنوان منقّح وأجزائه ومربع محيط ومستوى دقة يخبرك بمدى الثقة في النقطة.
مثال
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/forward?q=221B+Baker+Street,+London&limit=1"النص الحر مقبول، وكذلك الاستعلام المنظّم إذا كانت لديك الأجزاء مسبقًا: street=221B Baker Street&city=London&country=gb. اقصر النتائج على دولة واحدة أو أكثر باستخدام country=gb,ie، أو رجّح النتائج القريبة من نقطة باستخدام proximity=lat,lon، أو من مربع باستخدام bounds.
{
"status": "ok",
"query": "221B Baker Street, London",
"results": [
{
"formatted": "221B Baker Street, London NW1 6XE, United Kingdom",
"lat": 51.523767,
"lon": -0.158555,
"type": "address",
"precision": "house",
"confidence": 0.97,
"components": {
"house_number": "221B",
"road": "Baker Street",
"neighbourhood": "Marylebone",
"city": "London",
"state": "England",
"postcode": "NW1 6XE",
"country": "United Kingdom",
"country_code": "gb"
},
"bounds": { "north": 51.523917, "south": 51.523617, "east": -0.158305, "west": -0.158805 }
}
]
}ما تحصل عليه
| الحقل | المعنى |
|---|---|
formatted | العنوان الكامل، مكتوبًا بالطريقة التي تُكتب بها العناوين في تلك الدولة. |
lat, lon | درجات عشرية، WGS 84. حتى ست خانات عشرية. |
type | ما تمت مطابقته: address أو street أو postcode أو city أو region أو country أو poi. |
precision | إحدى القيم house أو street أو postcode أو admin. راجع التغطية. |
confidence | من 0 إلى 1. مدى تأكدنا من أن هذا هو المكان الذي تقصده، بناءً على الاستعلام. وهي مستقلة عن الدقة: يمكن مطابقة استعلام عن مدينة بثقة 1 عند مستوى الدقة admin. |
components | العنوان مقسّمًا إلى أجزاء، بأسماء المفاتيح نفسها في كل دولة. لا تظهر إلا الأجزاء الموجودة. |
bounds | مربع محيط بالمعلم المطابَق: المبنى أو الشارع أو منطقة الرمز البريدي أو المدينة. |
أين تُستخدم
تنقيح عناوين العملاء
طبّق الترميز الجغرافي عند التسجيل واحفظ formatted وcomponents إلى جانب ما كتبه العميل. ارفض كل ما هو أدنى من precision: street واطلب من العميل التحقق.
وضع السجلات على الخريطة
عالج ملف CSV يضم عناوين متاجر أو عقارات دفعةً واحدة بمعدل 50 في الثانية واعرضها على الخريطة. يمنحك الحقل bounds مستوى تكبير مناسبًا لكل منها.
البحث حسب المكان
حوّل عبارة «شقق في Hackney» إلى مربع محيط واستعلم به قاعدة بياناتك. يخبرك الحقل type هل كتب المستخدم مدينة أم شارعًا أم مبنى.
الدقة
تعتمد النتائج على مستوى المنزل على توفر بيانات العناوين في تلك الدولة، وهي غير متوفرة في كل مكان. تسرد صفحة التغطية أفضل مستوى نصل إليه في كل دولة وإقليم من 249 دولة وإقليمًا. وحيث لا نستطيع مطابقة رقم المنزل نتراجع إلى الشارع، ثم الرمز البريدي، ثم المنطقة المحلية، ويوضح الحقل precision أيها استُخدم. لا نعيد أبدًا مركز دولة على أنه عنوان.
السعر والحدود
الاستدعاء الواحد طلب واحد مهما كان عدد النتائج التي يعيدها (حتى 10 باستخدام limit). لكل مفتاح 2,500 طلب مجاني يوميًا، وبعد ذلك يُخصم 0.0001 € لكل طلب من الرصيد المسبق الدفع، أو لا شيء على مفتاح Unlimited (50 € شهريًا). تفاصيل الأسعار.
هل تنتقل من مزوّد آخر؟ تجيب المضيفات البديلة المتوافقة مع Google وBing وHERE وMapbox وغيرها على طلبات الترميز الجغرافي الأمامي بتنسيقات هؤلاء المزوّدين.