بديل متوافق مع TomTom Search

تجيب نقاط النهاية Geocode وReverse Geocode وFuzzy Search الخاصة بخدمة TomTom على tomtom.mygeocode.com بالبنية نفسها للملخص والنتائج، بما في ذلك الحقل freeformAddress الذي تعرضه معظم عمليات التكامل.

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

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

قبل

curl "https://api.tomtom.com/search/2/geocode/Avenida%20Paulista%201578%20S%C3%A3o%20Paulo.json?key=YOUR_TOMTOM_KEY"

بعد

curl "https://tomtom.mygeocode.com/search/2/geocode/Avenida%20Paulista%201578%20S%C3%A3o%20Paulo.json?key=YOUR_MYGEOCODE_KEY"

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

المستوى المجاني في TomTom هو 2,500 معاملة يوميًا، مثل حصتنا، لكن المعاملة هناك قد تكلّف عدة أرصدة. أما هنا فكل استدعاء طلب واحد، وللاستخدام المدفوع خيار بسعر ثابت.

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

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

نقاط النهاية

المسار على tomtom.mygeocode.com	ما يفعله	مصدر البيانات
`/search/2/geocode/{query}.json`	الترميز الجغرافي	الترميز الجغرافي الأمامي
`/search/2/structuredGeocode.json?countryCode=...&streetName=...`	ترميز جغرافي منظّم	الترميز الجغرافي الأمامي
`/search/2/reverseGeocode/{lat},{lon}.json`	الترميز الجغرافي العكسي	الترميز الجغرافي العكسي
`/search/2/search/{query}.json?typeahead=true`	بحث تقريبي مع اقتراحات أثناء الكتابة	الإكمال التلقائي للعناوين

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

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

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

{
  "summary": {
    "query": "avenida paulista 1578 sao paulo",
    "queryType": "NON_NEAR",
    "queryTime": 21,
    "numResults": 1,
    "offset": 0,
    "totalResults": 1,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "Point Address",
      "id": "mg.br.addr.7d1a55f2",
      "score": 11.98,
      "address": {
        "streetNumber": "1578",
        "streetName": "Avenida Paulista",
        "municipalitySubdivision": "Bela Vista",
        "municipality": "São Paulo",
        "countrySecondarySubdivision": "São Paulo",
        "countrySubdivision": "São Paulo",
        "countrySubdivisionCode": "SP",
        "postalCode": "01310-200",
        "countryCode": "BR",
        "country": "Brasil",
        "countryCodeISO3": "BRA",
        "freeformAddress": "Avenida Paulista 1578, Bela Vista, São Paulo, SP 01310-200",
        "localName": "São Paulo"
      },
      "position": { "lat": -23.561414, "lon": -46.655881 },
      "viewport": {
        "topLeftPoint": { "lat": -23.560514, "lon": -46.656881 },
        "btmRightPoint": { "lat": -23.562314, "lon": -46.654881 }
      }
    }
  ]
}

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

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

يُوجَّه الترميز الجغرافي الحر والمنظّم والعكسي كله، بالإضافة إلى نقطة نهاية search.
تحافظ الإجابات على شكل summary وresults الخاص بخدمة TomTom.
يعمل Batch Search بالطريقتين. يجيب POST /search/2/batch/sync.json على ما يصل إلى 100 من batchItems دفعة واحدة بشكل TomTom (statusCode وresponse لكل عنصر، وsummary). ويأخذ POST /search/2/batch.json حتى 10,000، ويجيب بالرمز 202 مع ترويسة Location، وتُجلب النتيجة من هناك. كل عنصر في الدفعة يُحتسب طلبًا واحدًا، كما تحتسبه TomTom، والدفعة الأكبر مما تبقى من الحصة تُرفض بالكامل مع الرمز 429 الخاص بخدمة TomTom، وجلب نتيجة محفوظة لا يُحتسب.

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

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

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