My Geocode

بديل متوافق مع Bing Maps REST Services

توقف Microsoft خدمة Bing Maps for Enterprise. توقفت المفاتيح المجانية والأساسية عن العمل في 30 يونيو 2025، وتنتهي اتفاقيات المؤسسات في 30 يونيو 2028. إذا كانت لديك شيفرة مبنية على خدمات REST المسماة Locations أو Autosuggest أو Time Zone أو Elevation، فوجّهها إلى bing.mygeocode.com واحتفظ بطريقة تحليل الاستجابات نفسها.

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

المضيف الأصلي
  • dev.virtualearth.net
استخدم بدلًا منهbing.mygeocode.com
معامل المفتاحkey (اختياري: يحصل أي عنوان على 2,500 طلب يوميًا دون مفتاح، وضع مفتاح My Geocode هنا للاستفادة من الرصيد والباقات وسجل الاستخدام)
قبل
curl "https://dev.virtualearth.net/REST/v1/Locations?q=1%20Microsoft%20Way%2C%20Redmond%2C%20WA&key=YOUR_BING_KEY"
بعد
curl "https://bing.mygeocode.com/REST/v1/Locations?q=1%20Microsoft%20Way%2C%20Redmond%2C%20WA&key=YOUR_MYGEOCODE_KEY"

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

نقاط نهاية Bing ستختفي وفق جدول زمني محدد. الانتقال إلى Azure Maps يعني أشكال استجابة جديدة وشيفرة عميل جديدة. أما تغيير اسم مضيف واحد فلا يعني ذلك.

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

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

نقاط النهاية

المسار على bing.mygeocode.comما يفعلهمصدر البيانات
/REST/v1/Locations?q=...البحث عن موقع باستعلامالترميز الجغرافي الأمامي
/REST/v1/Locations?countryRegion=...&locality=...&addressLine=...البحث عن موقع بعنوان منظّمالترميز الجغرافي الأمامي
/REST/v1/Locations/{lat},{lon}البحث عن موقع بنقطة (عكسي)الترميز الجغرافي العكسي
/REST/v1/Autosuggest?query=...الاقتراح التلقائيالإكمال التلقائي للعناوين
/REST/v1/TimeZone/{lat},{lon}المنطقة الزمنية حسب النقطةالاستعلام عن المنطقة الزمنية
/REST/v1/Elevation/List?points=lat,lon,lat,lonالارتفاعات لقائمة من النقاطالاستعلام عن الارتفاع

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

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

الاستجابة من bing.mygeocode.com
{
  "authenticationResultCode": "ValidCredentials",
  "brandLogoUri": "https://www.mygeocode.com/assets/img/logo.svg",
  "copyright": "Copyright My Geocode",
  "resourceSets": [
    {
      "estimatedTotal": 1,
      "resources": [
        {
          "__type": "Location:http://schemas.microsoft.com/search/local/ws/rest/v1",
          "bbox": [47.635742, -122.140518, 47.643468, -122.125237],
          "name": "1 Microsoft Way, Redmond, WA 98052",
          "point": { "type": "Point", "coordinates": [47.639605, -122.129877] },
          "address": {
            "addressLine": "1 Microsoft Way",
            "adminDistrict": "WA",
            "adminDistrict2": "King County",
            "countryRegion": "United States",
            "formattedAddress": "1 Microsoft Way, Redmond, WA 98052",
            "locality": "Redmond",
            "postalCode": "98052"
          },
          "confidence": "High",
          "entityType": "Address",
          "geocodePoints": [
            { "type": "Point", "coordinates": [47.639605, -122.129877], "calculationMethod": "Rooftop", "usageTypes": ["Display"] }
          ],
          "matchCodes": ["Good"]
        }
      ]
    }
  ],
  "statusCode": 200,
  "statusDescription": "OK",
  "traceId": "mg-7f2a9c1e4b"
}

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

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

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

  • تقبل طلبات الارتفاع النقاط في سلسلة الاستعلام، أو في جسم نموذج، أو في جسم text/plain الذي توثّقه Bing.
  • يجيب Elevation/SeaLevel بالقيمة 404: فالارتفاعات هنا محسوبة أصلًا فوق متوسط مستوى سطح البحر، لذا لا توجد إزاحة جيويد يجب تطبيقها.
  • تتضمن إجابات المنطقة الزمنية الكائن dstRule، مع كتابة القاعدة بالطريقة التي تكتبها بها قاعدة بيانات المناطق الزمنية (Sun>=8، lastSun) ومقدار التعديل بالدقائق.
  • يحتسب estimatedTotal الموارد في المجموعة، كما تفعل Bing.
  • يأخذ TimeZone?query= زوجًا من خط العرض وخط الطول.
  • تأخذ Elevation List وPolyline وBounds حتى 1,024 نقطة، كما تفعل Bing، وكل نقطة تُحتسب طلبًا واحدًا هنا.

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

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

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