المطوّرون

ابنِ مع طريقي.

HTTPS وJSON عاديان، وأشكال طلبات تفهمها شيفرتك المكتوبة لـMapbox وOSRM، وشكل واحد للأخطاء في كل مكان. هذا كل ما تحتاجه للبدء.

البدء السريع

  1. ١احصل على مفتاحخلال الوصول المبكر نُصدر المفاتيح يدوياً. مفتاح tareky_pk_ العام للمتصفحات والتطبيقات؛ ومفتاح tareky_sk_ السري يبقى على خادمك.
  2. ٢أرسل طلباًأرسل المفتاح السري كرمز Bearer، أو المفتاح العام في access_token. كل جواب يحمل ما تبقّى من حدودك.
  3. ٣ارسم خريطةحمّل رابط نمط في MapLibre GL JS v6، الذي يشكّل العربية بنفسه. تحميل الخريطة وحدة واحدة؛ وبلاطاتها مجانية.
البدء السريع
مفتاح سري، من الخادم
# Directions, in Mapbox Directions’ shape
curl -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 use
curl -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())
})
دون حزمة SDK
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موجز الحوادثوصول مبكر

المفاتيح

الحدود والأخطاء

لكل خطة حدود في الثانية وفي الدقيقة أمام حصة شهرية. عند تجاوز حدّ تجيب الواجهة 429 مع Retry-After، وكل استجابة تقول أين تقف.

كل استجابة تحمل

  • X-RateLimit-Limit
  • X-RateLimit-Remaining
  • X-RateLimit-Reset
  • X-Quota-Limit
  • X-Quota-Remaining
  • Retry-After

لكل خطأ الشكل نفسه

429 Too Many Requests
{
"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 images
const 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 response
const base = 'https://api.mapbox.com/directions/v5/mapbox'
const base = 'https://api.tareky.com/v1/directions'

التوثيق

كل نقطة نهاية بمعاملاتها وأجوبتها وأخطائها، مولَّدة من مواصفة OpenAPI.

افتح مرجع الواجهات

مساعدة

الأسئلة عن الواجهات تصل إلى المهندسين الذين يبنونها.

ابنِ على خريطة العراق الخاصة به.

أخبرنا بما تبنيه. خلال الوصول المبكر نُصدر المفاتيح يدوياً، ونراسلك مرة واحدة حين تجهز مفاتيحك.

This page is also in English.

Read it in English

ئەم پەڕەیە بە کوردیش هەیە.

بە کوردی بیخوێنەوە