بديل متوافق مع Google Maps Platform

تجيب خدمات الويب Geocoding وPlaces Autocomplete وTime Zone وElevation جميعها على المسارات نفسها في gapi.mygeocode.com، بشكل JSON نفسه الذي تعيده Google. غيّر المضيف، وضع مفتاح My Geocode في المعامل key، وتبقى بقية شيفرتك كما هي.

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

المضيف الأصلي	`maps.googleapis.com`
استخدم بدلًا منه	`gapi.mygeocode.com`
معامل المفتاح	`key` (اختياري: يحصل أي عنوان على 2,500 طلب يوميًا دون مفتاح، وضع مفتاح My Geocode هنا للاستفادة من الرصيد والباقات وسجل الاستخدام)

قبل

curl "https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_GOOGLE_KEY"

بعد

curl "https://gapi.mygeocode.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_MYGEOCODE_KEY"

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

تشترط Google حساب فوترة ومفتاحًا في كل استدعاء، وتحاسب على كل طلب في كل وحدة SKU. أما هنا فالمفتاح المجاني يغطي أول 2,500 استدعاء يوميًا، والسعر بعد ذلك 0.0001 € للطلب أو مبلغ ثابت قدره 50 € شهريًا.

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

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

نقاط النهاية

المسار على gapi.mygeocode.com	ما يفعله	مصدر البيانات
`/maps/api/geocode/json?address=...`	الترميز الجغرافي الأمامي	الترميز الجغرافي الأمامي
`/maps/api/geocode/json?latlng=lat,lng`	الترميز الجغرافي العكسي	الترميز الجغرافي العكسي
`/maps/api/place/autocomplete/json?input=...`	Places Autocomplete (اقتراحات مع الإحداثيات)	الإكمال التلقائي للعناوين
`/maps/api/timezone/json?location=lat,lng&timestamp=...`	واجهة Time Zone API	الاستعلام عن المنطقة الزمنية
`/maps/api/elevation/json?locations=lat,lng\|lat,lng`	Elevation API	الاستعلام عن الارتفاع

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

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

الاستجابة من gapi.mygeocode.com

{
  "results": [
    {
      "address_components": [
        { "long_name": "1600", "short_name": "1600", "types": ["street_number"] },
        { "long_name": "Amphitheatre Parkway", "short_name": "Amphitheatre Pkwy", "types": ["route"] },
        { "long_name": "Mountain View", "short_name": "Mountain View", "types": ["locality", "political"] },
        { "long_name": "Santa Clara County", "short_name": "Santa Clara County", "types": ["administrative_area_level_2", "political"] },
        { "long_name": "California", "short_name": "CA", "types": ["administrative_area_level_1", "political"] },
        { "long_name": "United States", "short_name": "US", "types": ["country", "political"] },
        { "long_name": "94043", "short_name": "94043", "types": ["postal_code"] }
      ],
      "formatted_address": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
      "geometry": {
        "location": { "lat": 37.4224428, "lng": -122.0842467 },
        "location_type": "ROOFTOP",
        "viewport": {
          "northeast": { "lat": 37.4237918, "lng": -122.0828977 },
          "southwest": { "lat": 37.4210938, "lng": -122.0855957 }
        }
      },
      "place_id": "mg.us.addr.5e1b2c7a9f",
      "plus_code": { "compound_code": "CWC8+W5 Mountain View, CA, USA", "global_code": "849VCWC8+W5" },
      "types": ["street_address"]
    }
  ],
  "status": "OK"
}

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

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

تطابق أجسام الأخطاء واجهة API التي استدعيتها: تجيب Time Zone API بالحقل errorMessage مع status، والواجهات الأخرى بالحقل error_message وقائمة النتائج الفارغة ثم status.
تستخدم إجابات المنطقة الزمنية ZERO_RESULTS فوق المياه المفتوحة، كما تفعل Google، وتحترم language.
تقبل Elevation المعامل locations، وخطًا متعددًا مرمّزًا بالبادئة enc:، وpath مع samples، حتى 512 نقطة كما تسمح Google، وكل نقطة تُحتسب طلبًا واحدًا هنا.

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

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

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