بديل متوافق مع HERE Geocoding and Search

توزّع HERE واجهة API للبحث على عدة مضيفات. وتندمج جميعها في here.mygeocode.com، الذي يجيب بمصفوفة items نفسها وكائن address وكائن position اللذين تقرؤهما عملاء HERE.

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

المضيف الأصلي	`geocode.search.hereapi.com` `revgeocode.search.hereapi.com` `autosuggest.search.hereapi.com` `autocomplete.search.hereapi.com`
استخدم بدلًا منه	`here.mygeocode.com`
معامل المفتاح	`apiKey` (اختياري: يحصل أي عنوان على 2,500 طلب يوميًا دون مفتاح، وضع مفتاح My Geocode هنا للاستفادة من الرصيد والباقات وسجل الاستخدام)

قبل

curl "https://geocode.search.hereapi.com/v1/geocode?q=Invalidenstra%C3%9Fe+116+Berlin&apiKey=YOUR_HERE_KEY"

بعد

curl "https://here.mygeocode.com/v1/geocode?q=Invalidenstra%C3%9Fe+116+Berlin&apiKey=YOUR_MYGEOCODE_KEY"

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

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

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

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

نقاط النهاية

المسار على here.mygeocode.com	ما يفعله	مصدر البيانات
`/v1/geocode?q=...`	الترميز الجغرافي	الترميز الجغرافي الأمامي
`/v1/geocode?qq=street=...;city=...`	الترميز الجغرافي باستعلام مؤهَّل	الترميز الجغرافي الأمامي
`/v1/revgeocode?at=lat,lng`	الترميز الجغرافي العكسي	الترميز الجغرافي العكسي
`/v1/autosuggest?q=...&at=lat,lng`	الاقتراح التلقائي	الإكمال التلقائي للعناوين
`/v1/autocomplete?q=...`	الإكمال التلقائي	الإكمال التلقائي للعناوين

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

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

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

{
  "items": [
    {
      "title": "Invalidenstraße 116, 10115 Berlin, Deutschland",
      "id": "mg.de.addr.9a3f1c77",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Invalidenstraße 116, 10115 Berlin, Deutschland",
        "countryCode": "DEU",
        "countryName": "Deutschland",
        "stateCode": "BE",
        "state": "Berlin",
        "countyCode": "B",
        "county": "Berlin",
        "city": "Berlin",
        "district": "Mitte",
        "street": "Invalidenstraße",
        "postalCode": "10115",
        "houseNumber": "116"
      },
      "position": { "lat": 52.53041, "lng": 13.38527 },
      "access": [ { "lat": 52.53039, "lng": 13.38533 } ],
      "mapView": { "west": 13.38393, "south": 52.52951, "east": 13.38661, "north": 52.53131 },
      "scoring": {
        "queryScore": 1.0,
        "fieldScore": { "city": 1.0, "streets": [1.0], "houseNumber": 1.0, "postalCode": 1.0 }
      }
    }
  ]
}

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

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

تستخدم الأخطاء حقول title وstatus وcode وcause وaction الخاصة بخدمة HERE مع معرّف ارتباط.
لا توجد نقطة نهاية للدفعات، لأن الأصل لا يتضمن واحدة. للأعمال الكبيرة استخدم POST /v1/forward أو /v1/reverse على api.mygeocode.com (حتى 100 في كل استدعاء، وكل عنصر طلب واحد).

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

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

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