گەشەپێدەران
لەگەڵ تەریقی دروستی بکە.
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',));Endpoint ەکان
API گشتییەکان لە ژێر /v1 دا، لە هەمان پسپۆرنامەی OpenAPI خوێندراونەتەوە کە API ی پێ دەپشکنرێت.
| ڕێگا | ڕێڕەو | بەرهەم |
|---|---|---|
| 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_ لە ناو پەڕە یان ئەپێکدا دەنێردرێن، بۆیە سنووردارن نەک نهێنی: بە ماڵپەڕەکانت، بە ناسنامەی ئەپەکانت و بەو API یانەی هەڵیاندەبژێریت.
کلیلە نهێنییەکان
کلیلەکانی tareky_sk_ لەسەر سێرڤەرەکانت دەمێننەوە، دەتوانرێت بە ناونیشانەکانت سنووردار بکرێن، و هەرگیز لە بەستەرێکدا وەرناگیرێن.
گۆڕینی کلیل
کلیلێکی گۆڕدراو ٢٤ کاتژمێر کار دەکات، بۆ ئەوەی کلیلە نوێیەکە بێ ڕاوەستان دابنێیت.
سنوور و هەڵەکان
هەموو پلانێک سنووری چرکە و خولەکی هەیە لە پێش بەشێکی مانگانە. لە سەرووی سنوورێکەوە API وەڵامی 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 ەوە
وێنەی جێگیر، ڕێنمایی، ماتریکس، گونجاندنی ڕێگا و tilequery هەمان ڕێڕەو، پارامیتەر و وەڵامی هاوتاکانیان لە Mapbox دا وەردەگرن، و کلیلی گشتی وەک تۆکنی Mapbox لە access_token دا دەنێردرێت. بۆ زۆربەی کۆد گواستنەوەکە گۆڕینی ناونیشانە.
// 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 بکە و حەوت ئامرازی تەنها-خوێندنەوە وەردەگرێت: گەڕان، شوێنە نزیکەکان، گەڕانی پێچەوانە، ڕێگا، پلانی گواستنەوەی گشتی، وێنەی نەخشە و ڕووداوەکان. وەک هەر بانگکردنێک دەژمێردرێت.
- SDK ی TypeScriptلە گەشەپێداندایەداواکاری و وەڵامی جۆرکراو بۆ هەموو کۆتاییەک، لەگەڵ یاریدەدەر بۆ بەستەری ستایل و وێنەی نەخشە. لە گەشەپێداندایە: هێشتا بڵاو نەکراوەتەوە.
- پاکێجی ڕێنماییلە گەشەپێداندایەپێشکەوتنی ڕێگا، دووبارە ڕێنمایی، داڕشتنی دەنگی عەرەبی و ناوی مانۆڕەکانی CarPlay و Android Auto لە یەک پاکێجدا. لە گەشەپێداندایە: هێشتا بڵاو نەکراوەتەوە.
بەڵگەنامە
هەموو endpoint ێک لەگەڵ پارامیتەر، وەڵام و هەڵەکانی، کە لە پسپۆرنامەی OpenAPI ەوە دروستکراون.
سەرچاوەی API بکەرەوەیارمەتی
پرسیارەکان دەربارەی API دەگەنە ئەو ئەندازیارانەی دروستی دەکەن.
لەسەر نەخشەی خودی عێراق دروستی بکە.
پێمان بڵێ چی دروست دەکەیت. لە ماوەی دەستگەیشتنی زوودا کلیلەکان بە دەست دەدەین، و یەک جار ئیمەیڵت بۆ دەنێرین کاتێک کلیلەکانت ئامادە دەبن.

