بديل متوافق مع OpenCage

تستخدم OpenCage نقطة نهاية واحدة للترميز الجغرافي الأمامي والعكسي وتعيد كتلة تعليقات توضيحية غنية. ويفعل opencage.mygeocode.com الشيء نفسه، بما في ذلك تعليقات المنطقة الزمنية والعملة ورمز الاتصال الدولي وتعليقات بنمط what3words التي يقرؤها مستخدمو OpenCage.

غيّر اسم مضيف واحدًا

المضيف الأصلي
  • api.opencagedata.com
استخدم بدلًا منهopencage.mygeocode.com
معامل المفتاحkey (اختياري: يحصل أي عنوان على 2,500 طلب يوميًا دون مفتاح، وضع مفتاح My Geocode هنا للاستفادة من الرصيد والباقات وسجل الاستخدام)
قبل
curl "https://api.opencagedata.com/geocode/v1/json?q=Colosseum+Rome&key=YOUR_OPENCAGE_KEY"
بعد
curl "https://opencage.mygeocode.com/geocode/v1/json?q=Colosseum+Rome&key=YOUR_MYGEOCODE_KEY"

لماذا ينتقل الناس

الطلب نفسه، وشكل الاستجابة نفسه، و2,500 طلب مجاني يوميًا لكل مفتاح دون اشتراط الإسناد ودون بند يقصر الاستخدام على الأغراض غير التجارية.

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

اطّلع على الأسعار احصل على مفتاح مجاني

نقاط النهاية

المسار على opencage.mygeocode.comما يفعلهمصدر البيانات
/geocode/v1/json?q=...الترميز الجغرافي الأماميالترميز الجغرافي الأمامي
/geocode/v1/json?q=lat,lngالترميز الجغرافي العكسيالترميز الجغرافي العكسي
/geocode/v1/geojson?q=...مخرجات GeoJSONالترميز الجغرافي الأمامي

مثال على الاستجابة

هذا ما يعيده الطلب أعلاه. أسماء الحقول والتداخل والأنواع تتبع OpenCage. البيانات وحدها خاصة بنا.

الاستجابة من opencage.mygeocode.com
{
  "documentation": "https://www.mygeocode.com/compatibility/opencage/",
  "licenses": [ { "name": "My Geocode Terms", "url": "https://www.mygeocode.com/terms/" } ],
  "rate": { "limit": 2500, "remaining": 2483, "reset": 1756339200 },
  "results": [
    {
      "annotations": {
        "DMS": { "lat": "41° 53' 24.72'' N", "lng": "12° 29' 31.92'' E" },
        "callingcode": 39,
        "currency": { "iso_code": "EUR", "name": "Euro", "symbol": "€" },
        "flag": "🇮🇹",
        "timezone": { "name": "Europe/Rome", "now_in_dst": 1, "offset_sec": 7200, "offset_string": "+0200", "short_name": "CEST" }
      },
      "bounds": {
        "northeast": { "lat": 41.8905, "lng": 12.4932 },
        "southwest": { "lat": 41.8897, "lng": 12.4914 }
      },
      "components": {
        "ISO_3166-1_alpha-2": "IT",
        "ISO_3166-1_alpha-3": "ITA",
        "_category": "travel/tourism",
        "_type": "attraction",
        "attraction": "Colosseo",
        "city": "Roma",
        "continent": "Europe",
        "country": "Italia",
        "country_code": "it",
        "postcode": "00184",
        "road": "Piazza del Colosseo",
        "state": "Lazio"
      },
      "confidence": 9,
      "formatted": "Colosseo, Piazza del Colosseo, 00184 Roma RM, Italia",
      "geometry": { "lat": 41.8902, "lng": 12.4922 }
    }
  ],
  "status": { "code": 200, "message": "OK" },
  "total_results": 1
}

التفاصيل والاختلافات

لا حاجة إلى مفتاح لأول 2,500 طلب يوميًا. لاستخدام مفتاح My Geocode، ضعه حيث كان مفتاح OpenCage: معامل الاستعلام key. كما تعمل الترويسة X-API-Key وAuthorization: Bearer ومصادقة HTTP Basic (المفتاح بوصفه اسم المستخدم) على كل مضيف، لذا تستمر مكتبات العملاء التي تصادق بطريقتها الخاصة في العمل دون تغيير.

أسطر حقوق النشر وأسماء التراخيص وروابط الشروط والخصوصية في الاستجابة خاصة بنا لا بالمزوّد الأصلي. وكل ما عدا ذلك يحافظ على الشكل الأصلي.

  • تعرض الكتلة rate حصتك المجانية الفعلية وما تبقى منها وموعد إعادة تعيينها.
  • تُقدَّم نقطتا النهاية json وgeojson كلتاهما.
  • لا توجد نقطة نهاية للدفعات، لأن الأصل لا يتضمن واحدة. للأعمال الكبيرة استخدم POST /v1/forward أو /v1/reverse على api.mygeocode.com (حتى 100 في كل استدعاء، وكل عنصر طلب واحد).

إذا كان عميلك يعتمد على حقل أو سلوك غير مذكور هنا، أخبرنا. تُصلَح فجوات التوافق بسرعة لأنها عادةً صغيرة.

مضيفات بديلة متوافقة أخرى

كيف تعمل البدائل المتوافقة، والنظرة العامة، والبدائل المتوافقة لمكتبات JavaScript.