المطوّرون
ابنِ مع طريقي.
HTTPS وJSON عاديان، وأشكال طلبات تفهمها شيفرتك المكتوبة لـMapbox وOSRM، وشكل واحد للأخطاء في كل مكان. هذا كل ما تحتاجه للبدء.
البدء السريع
- ١احصل على مفتاحخلال الوصول المبكر نُصدر المفاتيح يدوياً. مفتاح tareky_pk_ العام للمتصفحات والتطبيقات؛ ومفتاح tareky_sk_ السري يبقى على خادمك.
- ٢أرسل طلباًأرسل المفتاح السري كرمز Bearer، أو المفتاح العام في access_token. كل جواب يحمل ما تبقّى من حدودك.
- ٣ارسم خريطةحمّل رابط نمط في MapLibre GL JS v6، الذي يشكّل العربية بنفسه. تحميل الخريطة وحدة واحدة؛ وبلاطاتها مجانية.
# Directions, in Mapbox Directions’ shapecurl -H "Authorization: Bearer $TAREKY_SECRET_KEY" \ "https://api.tareky.com/v1/directions/driving/44.4183,33.3049;44.3650,33.3118" # Search: الكراده finds الكرادةcurl -H "Authorization: Bearer $TAREKY_SECRET_KEY" \ --get "https://api.tareky.com/v1/locations/geocode" --data-urlencode "q=الكراده" # An address people actually usecurl -H "Authorization: Bearer $TAREKY_SECRET_KEY" \ "https://api.tareky.com/v1/locations/reverse-geocode?lng=44.3661&lat=33.3152"import maplibregl from 'maplibre-gl' // v6 shapes Arabic natively const map = new maplibregl.Map({ container: 'map', // one map load is billed here; the tiles are free style: `https://api.tareky.com/v1/styles/light?lang=ar&access_token=${pk}`, center: [44.3661, 33.3152], zoom: 12,}) map.on('click', async ({ lngLat }) => { const place = await fetch(`https://api.tareky.com/v1/locations/reverse-geocode ?lng=${lngLat.lng}&lat=${lngLat.lat}&access_token=${pk}`).then((r) => r.json())})import 'package:http/http.dart' as http; // A static map is an image URL; a tareky_pk_ key is safe to ship.Image.network( 'https://api.tareky.com/v1/static-map/light/' '44.0091,36.1911,13/[email protected]?lang=ar&access_token=$pk',); final eta = await http.get(Uri.parse( 'https://api.tareky.com/v1/matrix/driving/' '44.0091,36.1911;44.0217,36.2012?access_token=$pk',));نقاط النهاية
الواجهات العامة تحت /v1، مقروءة من مواصفة OpenAPI نفسها التي تُفحص الواجهة مقابلها.
| الطريقة | المسار | المنتج |
|---|---|---|
| GET | /v1/locations/reverse-geocode | البحث العكسيوصول مبكر |
| GET | /v1/locations/search | البحث والترميز الجغرافيوصول مبكر |
| POST | /v1/locations/geo-coding | البحث العكسيوصول مبكر |
| GET | /v1/locations/geocode | البحث والترميز الجغرافيوصول مبكر |
| POST | /v1/tokens | المفاتيح والصلاحيات والحدودوصول مبكر |
| GET | /v1/poi/nearby | الأماكن القريبةوصول مبكر |
| GET | /v1/poi/in-bounds | الأماكن القريبةوصول مبكر |
| POST | /v1/poi/along-route | الأماكن القريبةوصول مبكر |
| GET | /v1/directions/{profile}/{coordinates} | الاتجاهاتوصول مبكر |
| GET | /v1/matrix/{profile}/{coordinates} | مصفوفة الأزمنةوصول مبكر |
| GET | /v1/match/{profile}/{coordinates} | مطابقة المساروصول مبكر |
| GET | /v1/optimize/{profile}/{coordinates} | تحسين الرحلةوصول مبكر |
| GET | /v1/traffic/tiles/{z}/{x}/{y} | حركة المرور المباشرةغير متاح بعد |
| GET | /v1/traffic/flow | حركة المرور المباشرةغير متاح بعد |
| GET | /v1/traffic/historical | حركة المرور المباشرةغير متاح بعد |
| GET | /v1/traffic/snapshot | حركة المرور المباشرةغير متاح بعد |
| GET | /v1/static-map/{theme}/{coords}/{size} | الخرائط الثابتةوصول مبكر |
| GET | /v1/geofences | السياجات الجغرافية والأجهزةقيد التطوير |
| POST | /v1/geofences | السياجات الجغرافية والأجهزةقيد التطوير |
| POST | /v1/geofences/import | السياجات الجغرافية والأجهزةقيد التطوير |
| GET | /v1/geofences/{id} | السياجات الجغرافية والأجهزةقيد التطوير |
| DELETE | /v1/geofences/{id} | السياجات الجغرافية والأجهزةقيد التطوير |
| POST | /v1/tracking/devices/{externalId}/positions | السياجات الجغرافية والأجهزةقيد التطوير |
| GET | /v1/tracking/devices/{externalId} | السياجات الجغرافية والأجهزةقيد التطوير |
| POST | /v1/tracking/devices/{externalId}/shares | روابط التتبّعقيد التطوير |
| GET | /v1/styles/glyphs/{handle}/{fontstack}/{file} | الخطوط والأيقوناتقيد التطوير |
| GET | /v1/tilesets/{id} | مجموعات المربعاتقيد التطوير |
| POST | /v1/tilesets/{name}/uploads | مجموعات المربعاتقيد التطوير |
| POST | /v1/tilesets/{name}/builds | مجموعات المربعاتقيد التطوير |
| GET | /v1/tilesets/{name}/builds/{jobId} | مجموعات المربعاتقيد التطوير |
| GET | /v1/styles/{theme} | أنماط الخرائطوصول مبكر |
| GET | /v1/styles/{handle}/{styleId} | الأنماط المخصّصة وStudioقيد التطوير |
| GET | /v1/styles/{handle}/{styleId}/sprites/{file} | الأنماط المخصّصة وStudioقيد التطوير |
| GET | /v1/styles/{handle}/{styleId}/static/{coords}/{size} | الأنماط المخصّصة وStudioقيد التطوير |
| GET | /v1/styles/{handle}/{styleId}/tiles/{z}/{x}/{y} | الأنماط المخصّصة وStudioقيد التطوير |
| GET | /v1/tiles/{theme}/{z}/{x}/{y} | الطبقات النقطيةوصول مبكر |
| GET | /v1/tilequery/{point} | الاستعلام عن المربعاتوصول مبكر |
| GET | /v1/transit/plan/{points} | تخطيط رحلات النقل العاموصول مبكر |
| GET | /v1/transit/{points} | تخطيط رحلات النقل العاموصول مبكر |
| GET | /v1/feeds/cifs.json | موجز الحوادثوصول مبكر |
| GET | /v1/feeds/incidents.geojson | موجز الحوادثوصول مبكر |
| POST | /v1/feeds/incidents | موجز الحوادثوصول مبكر |
المفاتيح
المفاتيح العامة
مفاتيح tareky_pk_ تُشحن داخل صفحة أو تطبيق، فهي مقيّدة لا سرية: بمواقعك وبمعرّفات تطبيقاتك وبالواجهات التي تختارها.
المفاتيح السرية
مفاتيح tareky_sk_ تبقى على خوادمك، ويمكن تقييدها بعناوينك، ولا تُقبل في رابط أبداً.
التدوير
المفتاح المدوَّر يبقى صالحاً ٢٤ ساعة، فتنشر الجديد دون انقطاع.
الحدود والأخطاء
لكل خطة حدود في الثانية وفي الدقيقة أمام حصة شهرية. عند تجاوز حدّ تجيب الواجهة 429 مع Retry-After، وكل استجابة تقول أين تقف.
كل استجابة تحمل
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Reset
- X-Quota-Limit
- X-Quota-Remaining
- Retry-After
لكل خطأ الشكل نفسه
{ "error": { "code": "quota_exceeded", "message": "Monthly quota exhausted for this app", "status": 429, "docsUrl": "https://docs.tareky.com/errors/#quota_exceeded" }, "requestId": "…"}الانتقال من Mapbox
الصور الثابتة والاتجاهات والمصفوفة ومطابقة المسار واستعلام المعالم تأخذ المسارات والمعاملات والأجوبة نفسها التي في نظيراتها لدى Mapbox، والمفتاح العام يُرسل في access_token كرمز Mapbox. في أغلب الشيفرة الانتقال هو تغيير العنوان.
// Mapbox static imagesconst url = `https://api.mapbox.com/styles/v1/mapbox/dark-v11/static/ ${lng},${lat},${zoom}/720x420@2x?access_token=${token}`const url = `https://api.tareky.com/v1/static-map/dark/ ${lng},${lat},${zoom}/[email protected]?lang=ar&access_token=${pk}` // Directions: same path, same responseconst base = 'https://api.mapbox.com/directions/v5/mapbox'const base = 'https://api.tareky.com/v1/directions'الأدوات
- خادم MCPوصول مبكروجّه مساعداً ذكياً إلى نقطة MCP بمفتاحك فيحصل على سبع أدوات للقراءة فقط: البحث، والأماكن القريبة، والبحث العكسي، والاتجاهات، وخطط النقل العام، وصور الخرائط، والحوادث. يُحتسب كأي طلب.
- مكتبة TypeScriptقيد التطويرطلبات واستجابات مُنمَّطة لكل نقطة نهاية، مع أدوات مساعدة لروابط الأنماط وصور الخرائط. قيد التطوير: لم تُنشر بعد.
- حزمة الملاحةقيد التطويرتقدّم المسار، وإعادة التوجيه، وصياغة الصوت العربي، وأسماء مناورات CarPlay وAndroid Auto في حزمة واحدة. قيد التطوير: لم تُنشر بعد.
ابنِ على خريطة العراق الخاصة به.
أخبرنا بما تبنيه. خلال الوصول المبكر نُصدر المفاتيح يدوياً، ونراسلك مرة واحدة حين تجهز مفاتيحك.

