گەشەپێدەران

لەگەڵ تەریقی دروستی بکە.

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',
));

Endpoint ەکان

API گشتییەکان لە ژێر ‎/v1 دا، لە هەمان پسپۆرنامەی OpenAPI خوێندراونەتەوە کە API ی پێ دەپشکنرێت.

Endpoint ەکان
ڕێگاڕێڕەوبەرهەم
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فیدی ڕووداوەکاندەستگەیشتنی زوو

کلیلەکان

سنوور و هەڵەکان

هەموو پلانێک سنووری چرکە و خولەکی هەیە لە پێش بەشێکی مانگانە. لە سەرووی سنوورێکەوە API وەڵامی 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 ەوە

وێنەی جێگیر، ڕێنمایی، ماتریکس، گونجاندنی ڕێگا و tilequery هەمان ڕێڕەو، پارامیتەر و وەڵامی هاوتاکانیان لە Mapbox دا وەردەگرن، و کلیلی گشتی وەک تۆکنی Mapbox لە access_token دا دەنێردرێت. بۆ زۆربەی کۆد گواستنەوەکە گۆڕینی ناونیشانە.

زۆربەی گواستنەوەکە گۆڕینی میوانخانەکەیە
// 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'

بەڵگەنامە

هەموو endpoint ێک لەگەڵ پارامیتەر، وەڵام و هەڵەکانی، کە لە پسپۆرنامەی OpenAPI ەوە دروستکراون.

سەرچاوەی API بکەرەوە

یارمەتی

پرسیارەکان دەربارەی API دەگەنە ئەو ئەندازیارانەی دروستی دەکەن.

لەسەر نەخشەی خودی عێراق دروستی بکە.

پێمان بڵێ چی دروست دەکەیت. لە ماوەی دەستگەیشتنی زوودا کلیلەکان بە دەست دەدەین، و یەک جار ئیمەیڵت بۆ دەنێرین کاتێک کلیلەکانت ئامادە دەبن.

هذه الصفحة متوفرة بالعربية أيضًا.

اقرأها بالعربية

This page is also in English.

Read it in English