بديل متوافق مع Mapbox Geocoding

تجيب كل من واجهة Geocoding API الأقدم v5 ونقاط النهاية الحالية v6 على mapbox.mygeocode.com. النتائج مجموعات GeoJSON FeatureCollection بمصفوفات context نفسها وقيم place_type نفسها وترتيب الإحداثيات نفسه الذي تعتمد عليه عملاء Mapbox.

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

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

قبل

curl "https://api.mapbox.com/geocoding/v5/mapbox.places/1%20Market%20St%20San%20Francisco.json?access_token=YOUR_MAPBOX_TOKEN"

بعد

curl "https://mapbox.mygeocode.com/geocoding/v5/mapbox.places/1%20Market%20St%20San%20Francisco.json?access_token=YOUR_MYGEOCODE_KEY"

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

تحاسب Mapbox على الترميز الجغرافي المؤقت والدائم بشكل مختلف، وتربط الاستخدام بحساب مسجّلة فيه بطاقة. أما هنا فالنتائج ملكك تحتفظ بها، وأول 2,500 طلب يوميًا لكل مفتاح مجانية.

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

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

نقاط النهاية

المسار على mapbox.mygeocode.com	ما يفعله	مصدر البيانات
`/geocoding/v5/mapbox.places/{query}.json`	الترميز الجغرافي الأمامي، v5	الترميز الجغرافي الأمامي
`/geocoding/v5/mapbox.places/{lon},{lat}.json`	الترميز الجغرافي العكسي، v5	الترميز الجغرافي العكسي
`/search/geocode/v6/forward?q=...`	الترميز الجغرافي الأمامي، v6	الترميز الجغرافي الأمامي
`/search/geocode/v6/reverse?longitude=...&latitude=...`	الترميز الجغرافي العكسي، v6	الترميز الجغرافي العكسي
`/search/searchbox/v1/suggest?q=...`	اقتراحات Search Box	الإكمال التلقائي للعناوين

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

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

الاستجابة من mapbox.mygeocode.com (v5)

{
  "type": "FeatureCollection",
  "query": ["1", "market", "st", "san", "francisco"],
  "features": [
    {
      "id": "address.mg.us.4d2e8b10",
      "type": "Feature",
      "place_type": ["address"],
      "relevance": 1,
      "properties": { "accuracy": "rooftop" },
      "text": "Market Street",
      "place_name": "1 Market Street, San Francisco, California 94105, United States",
      "center": [-122.394626, 37.793858],
      "geometry": { "type": "Point", "coordinates": [-122.394626, 37.793858] },
      "address": "1",
      "context": [
        { "id": "neighborhood.mg.us.fidi", "text": "Financial District" },
        { "id": "postcode.mg.us.94105", "text": "94105" },
        { "id": "place.mg.us.sanfrancisco", "wikidata": "Q62", "text": "San Francisco" },
        { "id": "region.mg.us.ca", "short_code": "US-CA", "text": "California" },
        { "id": "country.mg.us", "short_code": "us", "text": "United States" }
      ]
    }
  ],
  "attribution": "My Geocode, https://www.mygeocode.com/terms/"
}

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

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

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

تُوجَّه نقاط نهاية v5 Places ونقاط نهاية البحث v6 كلها، إلى جانب نقطة النهاية suggest الخاصة بخدمة Search Box.
يجيب POST /search/geocode/v6/batch مع مصفوفة JSON تضم حتى 1,000 كائن استعلام (أمامي q أو عكسي longitude/latitude) بالبنية {"batch": [...]} مع FeatureCollection واحدة لكل استعلام، كما تفعل Mapbox، وكل استعلام يُحتسب طلبًا واحدًا، كما تحتسبه Mapbox.

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

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

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