واجهة API للاستعلام عن الرمز البريدي

حوّل الرمز البريدي إلى المكان الذي ينتمي إليه: البلدة أو المدينة والمنطقة والدولة وإحداثية. تغطي رموز ZIP والرموز البريدية في المملكة المتحدة وكندا ورموز PIN الهندية والرموز البريدية اليابانية 郵便番号 وما يعادلها في 160 دولة. مفيدة وحدها لنماذج العناوين، وكطريقة سريعة ورخيصة لتحديد موقع سجل عندما لا يتوفر لديك سوى الرمز البريدي.

GEThttps://api.mygeocode.com/v1/postcode?code=...&country=...

جرّبها في العرض التجريبي المرجع الكامل

مثال

الطلب

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/postcode?code=10001&country=us"

# UK postcodes resolve to a street or a handful of buildings
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/postcode?code=SW1A+1AA&country=gb"

أرسل country دائمًا عندما تعرفها. الرموز البريدية ليست فريدة بين الدول: الرمز 10001 موجود في نيويورك وفي عدة دول أخرى. ودون تحديد الدولة ستحصل على نتائج من كل دولة يوجد فيها الرمز، مرتبة من الأكثر سكانًا.

التنسيق متسامح. تُوحَّد المسافات والشرطات وحالة الأحرف، لذا فإن sw1a1aa وSW1A 1AA متطابقان.

الاستجابة

{
  "status": "ok",
  "postcode": "10001",
  "country_code": "US",
  "results": [
    {
      "postcode": "10001",
      "place": "New York",
      "region": "New York",
      "region_code": "NY",
      "country": "United States",
      "country_code": "US",
      "lat": 40.7484,
      "lon": -73.9967
    }
  ]
}

ما تحصل عليه

الحقل	المعنى
`results`	إدخال واحد لكل مكان يغطيه الرمز. معظم الرموز تقابل مكانًا واحدًا، وبعض الرموز الريفية تغطي عدة قرى وتعيد عدة إدخالات.
`place`	اسم البلدة أو المدينة أو المنطقة المحلية كما تستخدمه هيئة البريد.
`region`, `region_code`	الولاية أو المقاطعة أو الإقليم ورمزها وفق ISO 3166-2 إن وُجد.
`lat`, `lon`	النقطة التي تنشرها هيئة البريد للرمز إن وُجدت، وإلا فمركز العناوين التي نحتفظ بها له.

أين تُستخدم

نماذج العناوين

اطلب الرمز البريدي أولًا واملأ المدينة والمنطقة تلقائيًا. يكتب المستخدمون أقل ويرتكبون أخطاء أقل.

مناطق التوصيل والتسعير

حدّد المستودع الذي يخدم العميل أو فئة الشحن المطبقة من إحداثيات الرمز البريدي.

رسم بيانات الاستبيانات على الخريطة

يمكن رسم مجموعات البيانات التي لا تسجّل سوى الرمز البريدي على الخريطة بدقة الرمز البريدي، وهي غالبًا أقصى ما تسمح به الخصوصية على أي حال.

السعر والحدود

استدعاء واحد، طلب واحد، بغض النظر عن عدد الأماكن التي يغطيها الرمز. لكل مفتاح 2,500 طلب مجاني يوميًا، وبعد ذلك يُخصم 0.0001 € لكل طلب من الرصيد المسبق الدفع، أو لا شيء على مفتاح Unlimited (50 € شهريًا). الأسعار. للعنوان الكامل مع رقم المنزل، استخدم الترميز الجغرافي الأمامي بدلًا من ذلك.