طلب POST واحد لكل أداة، وكلها مولَّدة من المانيفست نفسه الذي تعمل عليه أدوات التطبيق. وتُشتق هذه الصفحة من الفهرس الحي: فالأسماء والمعاملات والأعلام لا يمكن أن تنحرف عن الخادم.
عنوان الأساس نفسه، والمصادقة نفسها، والمظروف نفسه — لكل أداة.
كل أداة طلب POST واحد تحت عنوان أساس الواجهة. والمصادقة ومظروف الاستجابة موثَّقان في المرجع؛ وتضيف هذه الصفحة ما يختلف من أداة لأخرى: الحقول والسقوف والاستجابة.
POST https://haiyz.net/api/enterprise/v1/gis/buffer
X-Api-Key: haiyz_pk_live_xxxxxxxxxxxx
X-Api-Secret: haiyz_sk_live_xxxxxxxxxxxxxxxxxxxxxxxxشكلان: ملف مخزَّن، أو ناتج JSON مباشر.
الأدوات المنتجة للملفات تخزّن الناتج وتجيب بالمظروف القياسي: مفتاح التخزين، واسم ملف الناتج المقترح، ومفتاح مدخلك، وحقول ناتج كل أداة، وكتلة استخدام. وتضمّن أدوات المتجهات عدد المعالم ونظام إحداثيات الناتج ونوع الهندسة:
keyoutputFilenameinputKeyusagefeatureCountcrsgeometryTypeتُجلب البايتات على حدة: بالمفتاح المعاد في التطبيق، أو من عنوان أثر التشغيل في الواجهة البرمجية (GET /runs/{runId}) — وContent-Disposition يحمل اسم الملف.
أدوات JSON (تحويل الإحداثيات، والقياس، والنقطة في المضلع…) تعيد ناتجها مباشرة في data — دون ملف مخزَّن ما لم تنص الأداة على غير ذلك.
عن X-Output-Filename وX-CRS
حواجز أمان تسبق أي حد خاص بالأداة.
1 tools
POST /validate-convertتحقق من صحة وحوّل ملفات Shapefile وGeoJSON وKML.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
sourceCrsrepairedCountbbox1 tools
POST /extract-exifاعرف أين ومتى وفي أي اتجاه التُقطت كل صورة، واحصل على الصور طبقةَ نقاط.
| Field | Type | Required | Details |
|---|---|---|---|
files | file | yes | كرر الحقل مرة لكل ملف |
imagesinputKeysgeotaggedCounttotalCountgeojsonOutput12 tools
POST /line-to-polygonحوّل سلسلة إحداثيات إلى مضلّع مغلق واحسب المساحة الجيوديسية والمحيط وإحصائيات الشكل.
| Field | Type | Required | Details |
|---|---|---|---|
coordinates | array | yes | مصفوفة أزواج [lon, lat] — ثلاثة على الأقل |
POST /line-to-polygon/file| Field | Type | Required | Details |
|---|---|---|---|
file | file | yes |
keyinputKeystatsusagePOST /simplifyقلّل عدد رؤوس الطبقة بتفاوت يُحدَّد بالأمتار، مع الحفاظ على الحدود المشتركة بين المضلّعات المتجاورة.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
methodالطريقة | string | optional | douglas | coverage · default douglas |
tolerance_mالتفاوت | number | optional | min 0.001 · max 100000 · default 10 · بالوحدة المحددة في `unit`؛ الحدّان الأدنى والأعلى بالأمتار |
unitوحدة المسافة | string | optional | m | km | ft | mi · default m |
preserve_topologyالحفاظ على الطوبولوجيا (تجنّب التقاطعات الذاتية) | boolean | optional | default true |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
verticesBeforeverticesAfterinputFeatureCountmethodأرسل tolerance_m (على الأرض وبالوحدة unit). وما زال الحقل القديم tolerance بالدرجات مقروءًا إن لم يُرسل tolerance_m.
POST /bounding-shapeارسم الحد الذي يحيط بمعالمك — مُغلَّفًا محدّبًا أو مقعّرًا أو مستطيل النطاق أو دائرة — حول الطبقة كلها أو كل مجموعة أو كل معلم.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
shapeالشكل | string | optional | convex | concave | envelope | circle · default convex |
ratioدرجة الإحكام | number | optional | min 0.05 · max 1 · default 0.3 |
scopeيُرسم حول | string | optional | layer | group | feature · default layer |
byالتجميع حسب عمود | string | optional | max 5 · قائمة JSON بأسماء أعمدة من `file`، مثل ["district","use"] |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCountgroupFieldskippedCountما زال المساران القديمان /convex-hull و/concave-hull يجيبان كما كانا، والأعمال الجديدة تستدعي /bounding-shape. والحقل by مطلوب عندما تكون قيمة scope هي group.
POST /centroidsاستبدل كل معلم بنقطة مركزه — حوّل المضلّعات أو الخطوط إلى طبقة نقاط.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
methodموضع النقطة | string | optional | centroid | inside · default centroid |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputGeometryTypePOST /bufferأنشئ نطاقات عازلة حول النقاط أو الخطوط أو المضلّعات — بمسافة واحدة، أو بمسافة كل معلم من عمود، أو على هيئة حلقات — مقيسة على الأرض.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
distance_byتحديد المسافة | string | optional | value | column | rings · default value |
distance_mمسافة النطاق العازل | number | optional | min -100000 · max 100000 · default 100 · بالوحدة المحددة في `unit`؛ الحدّان الأدنى والأعلى بالأمتار |
distance_fieldعمود المسافة | string | yes | اسم عمود يُقرأ من `file` |
ringsمسافات الحلقات | string | yes | |
unitوحدة المسافة | string | optional | m | km | ft | mi · default m |
dissolveدمج النطاقات المتداخلة في شكل واحد | boolean | optional | default false |
dissolve_byالدمج حسب عمود | string | optional | اسم عمود يُقرأ من `file` |
cap_styleشكل أطراف النطاق العازل | string | optional | round | flat | square · default round |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
dissolveddistanceMinputFeatureCountringCountskippedCountأرسل أحد الحقول distance_m أو distance_field أو rings. يمكن أن يكون distance_m سالبًا لتقليص المضلّعات، والصفر مرفوض.
POST /dissolveادمج المعالم التي تشترك في قيم عمود أو أكثر في شكل واحد، مع الإحصاءات التي تختارها.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
byالتجميع حسب عمود | string | optional | max 5 · قائمة JSON بأسماء أعمدة من `file`، مثل ["district","use"] |
statsالإحصاءات | string | optional | قائمة JSON من الإحصاءات على أعمدة `file`، لكل منها field وop؛ وقيمة op إحدى: sum | mean | min | max | median | std | range | first | last | unique | join · 20 على الأكثر |
single_partمعلم لكل جزء متصل | boolean | optional | default false |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCountgroupsgroupFieldPOST /clipاقتطع الطبقة وفق طبقة حدود، مع الإبقاء على الأجزاء الواقعة داخلها فقط.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
maskحدود القص (مضلّعات) | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCountdroppedCountPOST /eraseإزالة أجزاء الطبقة الواقعة داخل طبقة المحو — عكس أداة القص، فيبقى ما يقع خارجها.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
maskطبقة المحو (مضلّعات) | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCountchangedCountdroppedCountPOST /random-pointsوضع نقاط عشوائية داخل المضلّعات — عدد لكل مضلّع أو للطبقة كلها، مع تباعد اختياري وبذرة تكرّر النتيجة.
| Field | Type | Required | Details |
|---|---|---|---|
fileطبقة المضلّعات | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
countعدد النقاط | number | optional | min 1 · max 10000 · default 10 |
perالعدد لكل | string | optional | polygon | layer · default polygon |
min_distance_mأقل تباعد | number | optional | min 0 · max 100000 · default 0 |
seedالبذرة (اختيارية) | string | optional | |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCountrequestedCountpointCountPOST /explodeفكّك المعالم المركّبة إلى معلم مستقل لكل جزء، بحيث يقع كل مضلّع أو خط في صف خاص به.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCountmultipartCountpartsCreatedPOST /repairأصلح الأشكال الهندسية غير الصالحة — التقاطعات الذاتية والحلقات غير المغلقة والأشكال الفارغة — ليُفتح الملف دون أخطاء في أي نظام معلومات جغرافية.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCountinvalidBeforeinvalidAfterdroppedCountPOST /gridأنشئ شبكة منتظمة من الخلايا المربّعة تغطي نطاق الطبقة، بحجم خلية تحدّده بالأمتار.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
cell_size_mحجم الخلية | number | optional | min 1 · max 5000000 · default 1000 |
clip_to_extentقصّ الشبكة على حدود البيانات | boolean | optional | default false |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCountrowscolscellSizeM2 tools
POST /distance-bearingاحسب المسافة الجيوديسية والاتجاه الأمامي/الخلفي بين سلسلة من النقاط.
| Field | Type | Required | Details |
|---|---|---|---|
points | array | yes | مصفوفة كائنات { lon, lat } — اثنان على الأقل |
segmentstotal_distance_mtotal_distance_kmstraight_distance_mstraight_distance_kmis_closedpoint_countsegment_countPOST /area-lengthاكتب المساحة والمحيط والطول وموقع المركز وعدد الرؤوس والأجزاء في أعمدة — محسوبة على المجسم الأرضي وبالوحدات التي تختارها.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
propertiesما يُحسب | string | optional | area | perimeter | length | centroid | vertices | parts · min 1 · default area,perimeter,length |
area_unitوحدة المساحة | string | optional | m2 | km2 | ha | ft2 | ac · default m2 |
length_unitوحدة الطول | string | optional | m | km | ft | mi · default m |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCounttotalAreaM2totalLengthMmeasuredAreasmeasuredLengthspropertiesمن دون properties تكتب الأداة الأعمدة area_m2 وarea_km2 وarea_ha وlength_m وlength_km كما كانت أداة المساحة والطول.
5 tools
POST /mergeادمج من 2 إلى 5 ملفات جغرافية (shapefile أو GeoJSON أو KML) في طبقة واحدة بنظام إحداثيات موحّد — مع وسم كل معلم بملفه المصدر.
| Field | Type | Required | Details |
|---|---|---|---|
filesالملفات المراد دمجها (2–5) | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) · 2–5 files |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
fileCountPOST /intersectاقطع طبقتين إحداهما بالأخرى وأبقِ الأجزاء المشتركة بينهما، ويحمل كل جزء أعمدة الطبقتين.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
overlayطبقة التراكب (مضلّعات) | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
prefixبادئة للأعمدة المضافة (اختياري) | string | optional | |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCountoverlayFeatureCountيجب أن تكون طبقة التراكب مضلّعات، والاتحاد يتطلب مضلّعات في الطبقتين.
POST /unionاجمع طبقتَي مضلّعات في كل الأجزاء التي تغطيها أيٌّ منهما، ويحمل كل جزء أعمدة الطبقة التي جاء منها.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
overlayطبقة التراكب (مضلّعات) | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
prefixبادئة للأعمدة المضافة (اختياري) | string | optional | |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCountoverlayFeatureCountيجب أن تكون طبقة التراكب مضلّعات، والاتحاد يتطلب مضلّعات في الطبقتين.
POST /inside-checkالتحقق من وقوع كل معلم داخل طبقة مضلّعات — كليًا أو جزئيًا أو بنسبة — وفي أي منطقة يقع.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
referenceالطبقة المرجعية (مضلّعات) | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
ruleيجتاز عندما | string | optional | inside | partial | percent · default inside |
percentالنسبة داخلها | number | optional | min 0 · max 100 · default 50 |
match_fieldsحقول تُذكر من الطبقة المرجعية (اختيارية) | string | optional | |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
insideCountpartialCountoutsideCountpassedCountPOST /spatial-joinاربط خصائص طبقة بأخرى وفق الموقع — بالعلاقة المكانية، أو بأقرب معلم، أو ضمن مسافة.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف المُدخَل | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
joinالطبقة المصدر للربط | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
predicateالعلاقة المكانية | string | optional | intersects | within | contains | crosses | touches | overlaps | nearest | dwithin · default intersects |
distance_mالمسافة | number | optional | min 0.001 · max 5000000 · بالوحدة المحددة في `unit`؛ الحدّان الأدنى والأعلى بالأمتار |
unitوحدة المسافة | string | optional | m | km | ft | mi · default m |
matchالصفوف لكل معلم مدخل | string | optional | all | first | largest | summary · default all |
fieldsالأعمدة المطلوب جلبها | string | optional | قائمة JSON بأسماء أعمدة من `join`، مثل ["district","use"] · 20 على الأكثر |
statsالإحصاءات | string | optional | قائمة JSON من الإحصاءات على أعمدة `join`، لكل منها field وop؛ وقيمة op إحدى: sum | mean | min | max | median | std | range | first | last | unique | join · 20 على الأكثر |
prefixبادئة للأعمدة المضافة (اختياري) | string | optional | |
howالمعالم التي تبقى | string | optional | inner | left · default inner |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCountjoinFeatureCountmatchedCountunmatchedCountmatchTotalpredicatematchالحقل distance_m مطلوب مع dwithin واختياري مع nearest، وكلاهما يكتب distance_m على الأرض. وتُحسب stats عندما تكون قيمة match هي summary.
1 tools
POST /raster-inspectارفع ملف GeoTIFF/DEM لمعرفة نظام إحداثياته وحدوده ودقته وإحصائيات كل نطاق (band)، مع معاينة سريعة.
| Field | Type | Required | Details |
|---|---|---|---|
file | file | yes |
inputKeypreviewKeypreviewPngB64crswidthheightbandCountresolutionboundsbandsusage2 tools
POST /cog-optimizeافحص ملف GeoTIFF وفق بنية Cloud-Optimized GeoTIFF — التقسيم إلى بلاطات، والمستويات المصغّرة، وترتيب الفهارس والبيانات — واطّلع على كل ملاحظة، ثم نزّل نسخة محسّنة.
| Field | Type | Required | Details |
|---|---|---|---|
fileالملف الشبكي (GeoTIFF) | file | yes | GeoTIFF (بامتداد .tif أو .tiff أو .geotiff) |
validfindingsoptimizedValidwasAlreadyCogissueswidthheightbandCountoriginalTiledoriginalOverviewCountoriginalCompressionoptimizedOverviewCountoptimizedCompressionالحقل valid هو الحكم على الملف كما أُرسل (ويكرره wasAlreadyCog). ويسرد findings كل ملاحظة بثلاثة حقول: code و level و message، وقيمة level إحدى error أو warning أو note؛ والملف الذي بلا مستويات مصغّرة صالح مع تنبيه، كما يقرر مدقق GDAL. يُفحص من الترويسة والفهارس: التقسيم إلى بلاطات، والمستويات المصغّرة، وترتيب الفهارس والبيانات. ولا يُفحص: بايتات البداية والنهاية لكل بلاطة، ولا فهارس القناع الداخلي.
POST /zonal-statsلخّص قيم الراستر داخل كل منطقة مضلّعة — المتوسط والأدنى والأعلى والمجموع والعدد لكل معلم.
| Field | Type | Required | Details |
|---|---|---|---|
fileمضلّعات المناطق | file | yes | بيانات جغرافية متجهية (انظر قائمة الامتدادات المقبولة أعلاه) |
rasterالملف الشبكي (GeoTIFF) | file | yes | GeoTIFF (بامتداد .tif أو .tiff أو .geotiff) |
target_formatصيغة الإخراج | string | yes | geojson | shp | kml | gml | gpkg | fgb | kmz | parquet |
bandالنطاق الشبكي | number | optional | min 1 · max 100 · default 1 |
statsالإحصاءات | string | optional | min | max | mean | median | std | sum | count · min 1 · default min,max,mean,count |
all_touchedاحتساب كل خلية تلمسها المنطقة | boolean | optional | default false |
zero_is_nodataاعتبار 0 بلا بيانات | boolean | optional | default true |
source_crsنظام إحداثيات الملف | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
output_crsنظام إحداثيات الناتج | string | optional | رمز مرجعي مثل EPSG:32638؛ راجع «أنظمة الإحداثيات في أدوات Hyz» |
inputFeatureCountzoneszonesWithDatabandstats5 tools
POST /remove-backgroundأزل خلفية الصورة تلقائيًا — اتركها شفافة، أو ضع لونًا خلف العنصر الرئيسي، أو خذ القناع.
| Field | Type | Required | Details |
|---|---|---|---|
fileالصورة | file | yes | PNG وJPEG وWebP وBMP |
outputالناتج | string | optional | image | mask · default image |
backgroundما خلف العنصر | string | optional | transparent | white | black | color · default transparent |
background_colorاللون | string | yes | |
refineتنظيف الحواف | boolean | optional | default false |
mattingالحفاظ على الحواف الناعمة (الشعر والفرو) | boolean | optional | default false |
outputbackgroundPOST /enhance-qualityأعد ترميز الصورة بجودة تختارها — أخف للويب، أو بالدقة الكاملة مع تكبير اختياري 2× لأعضاء Pro.
| Field | Type | Required | Details |
|---|---|---|---|
fileالصورة | file | yes | PNG وJPEG وWebP وBMP وTIFF وGIF |
upscaleتكبير 2× | boolean | optional | default false |
POST /convert-formatحوّل صورة بين PNG وJPG وWebP وBMP وTIFF وGIF.
| Field | Type | Required | Details |
|---|---|---|---|
fileالصورة | file | yes | PNG وJPEG وWebP وBMP وTIFF وGIF |
target_formatالصيغة المستهدفة | string | optional | png | jpeg | webp | bmp | tiff | gif · default png |
POST /image-watermarkأضف علامة مائية نصية أو شعارًا إلى صورة أو تصميم.
| Field | Type | Required | Details |
|---|---|---|---|
fileالصورة | file | yes | PNG وJPEG وWebP وBMP وTIFF وGIF |
wm_modeنوع العلامة المائية | string | optional | text | image · default text |
textنص العلامة المائية | string | yes | |
logoالصورة المراد ختمها | file | yes | PNG وJPEG وWebP وBMP وTIFF وGIF |
positionالموضع | string | optional | diagonal | center | top-left | top-right | bottom-left | bottom-right · default bottom-right |
opacityالشفافية | number | optional | min 0.05 · max 1 · default 0.4 |
قدّم واحدًا فقط من text أو logo — والمحرك يرفض كليهما معًا أو غيابهما معًا.
POST /merge-imagesاجمع عدة صور في صورة واحدة — عموديًا أو أفقيًا أو كشبكة.
| Field | Type | Required | Details |
|---|---|---|---|
filesالصور | file | yes | PNG وJPEG وWebP وBMP وTIFF وGIF · 2–12 files |
layoutالتخطيط | string | optional | vertical | horizontal | grid · default vertical |
fileCountwidthheight11 tools
POST /ocrاقرأ نص صورة ممسوحة أو ملف PDF — بالعربية أو الإنجليزية أو كلتيهما — واحصل عليه نصًّا أو ملف PDF قابلاً للبحث.
| Field | Type | Required | Details |
|---|---|---|---|
file | file | yes | صورة، أو ملف PDF من صفحات ممسوحة (حتى 30 صفحة) |
lang | string | optional | eng | ara | eng+ara · default eng |
mode | string | optional | auto | block | sparse · default auto |
output | string | optional | text | pdf · default text |
orientation | boolean | optional | default true |
keypdfKeyinputKeytextlangcharCountpageCountconfidencelowConfidencerotatedPagespagesusageقيمة confidence من 0 إلى 100 لكل صفحة وللمستند كله، وتكون lowConfidence صحيحة تحت 60. ومع output=pdf يُخزَّن ملف PDF القابل للبحث ويعود مفتاحه في pdfKey.
POST /pdf-to-wordحوّل نص وتنسيق ملف PDF إلى مستند Word قابل للتحرير.
| Field | Type | Required | Details |
|---|---|---|---|
fileملف PDF | file | yes |
POST /document-signضع صورة توقيعك على ملف PDF — ارسمه أو ارفعه أو استخدم توقيعاً محفوظاً — ومعه اسمك والتاريخ. هو ختم وليس توقيعاً رقمياً معتمداً.
| Field | Type | Required | Details |
|---|---|---|---|
file | file | yes | |
signature | file | yes | PNG only |
placements | json-string | yes | سلسلة JSON: مصفوفة صناديق { page, x, y, w, h } بكسور الصفحة (0–1) |
caption | string | optional | سطر واحد تحت كل ختم — اسم وتاريخ؛ حتى 120 حرفًا |
placementCounthadDigitalSignaturecaptionedهذه الأداة تطبع صورة توقيع في الصفحات — وليست توقيعًا رقميًا موثَّقًا. وتكون hadDigitalSignature صحيحة إذا كان الملف يحمل توقيعًا رقميًا، وهو ما يُبطل الختمُ التحققَ منه.
POST /merge-pdfادمج حتى 20 ملف PDF في مستند واحد بالترتيب الذي تختاره.
| Field | Type | Required | Details |
|---|---|---|---|
filesملفات PDF (2–20) | file | yes | PDF · 2–20 files |
fileCountpageCountPOST /split-pdfاستخرج صفحات أو نطاقات صفحات من ملف PDF — جزءًا واحدًا أو عدة أجزاء.
| Field | Type | Required | Details |
|---|---|---|---|
fileملف PDF | file | yes | |
rangesالصفحات المطلوب استخراجها | string | yes |
partCountالنطاق الواحد يعيد PDF؛ وعدة نطاقات تعيد ZIP (والاسم الحقيقي في outputFilename).
POST /compress-pdfقلّل حجم ملف PDF عبر إعادة ترميز الصور وتنظيف بنية الملف.
| Field | Type | Required | Details |
|---|---|---|---|
fileملف PDF | file | yes | |
qualityالجودة | string | optional | screen | ebook | print · default ebook |
pageCountoriginalBytescompressedBytesalreadyOptimizedPOST /pdf-to-imagesحوّل كل صفحة من ملف PDF إلى صورة PNG عالية الجودة.
| Field | Type | Required | Details |
|---|---|---|---|
fileملف PDF | file | yes | |
dpiالدقة (DPI) | string | optional | 72 | 150 | 300 · default 150 |
pageCountتعيد دائمًا ملف ZIP من صور الصفحات.
POST /pdf-watermarkأضف نصًا أو شعارًا على كل صفحة من ملف PDF.
| Field | Type | Required | Details |
|---|---|---|---|
fileملف PDF | file | yes | |
wm_modeنوع العلامة المائية | string | optional | text | image · default text |
textنص العلامة المائية | string | yes | |
logoالصورة المراد ختمها | file | yes | PNG وJPEG وWebP وBMP وTIFF وGIF |
positionالموضع | string | optional | diagonal | center | top-left | top-right | bottom-left | bottom-right · default diagonal |
opacityالشفافية | number | optional | min 0.05 · max 1 · default 0.15 |
pageCountقدّم واحدًا فقط من text أو logo — والمحرك يرفض كليهما معًا أو غيابهما معًا.
POST /images-to-pdfحوّل الصور والمستندات الممسوحة إلى ملف PDF واحد، صورة في كل صفحة.
| Field | Type | Required | Details |
|---|---|---|---|
filesالصور | file | yes | PNG وJPEG وWebP وBMP وTIFF وGIF · 1–20 files |
page_modeحجم الصفحة | string | optional | a4 | fit · default a4 |
pageCountfileCountPOST /fill-pdfاكتب في حقول نموذج PDF نفسها ونزّل المستند المعبّأ.
| Field | Type | Required | Details |
|---|---|---|---|
file | file | yes | |
values | json-string | yes | سلسلة JSON: كائن من اسم حقل AcroForm ← القيمة (حتى حد قيم النموذج) |
flatten | string | optional | true | false · default false |
fieldCountfilledCountflattenedPOST /rotate-pagesصحّح اتجاه الصفحات واحذف غير المرغوب منها مباشرة على المصغّرات.
| Field | Type | Required | Details |
|---|---|---|---|
file | file | yes | |
operations | json-string | yes | سلسلة JSON: { "rotations": { "<page>": 90|180|270 }, "delete": [pages] } — الصفحات تبدأ من 0؛ وعملية واحدة على الأقل |
pageCountrotatedCountdeletedCountفي المانيفست، لا في الفهرس.
أداتان بلا صفحة مستقلة ولا تظهران في الفهرس المتصفَّح — تُستدعيان من داخل أسطح أخرى، وعبر الواجهة. وهما مقيّدتان ومحتسبتان كسائر الأدوات.
POST /workspace-exportتحويل الطبقات الظاهرة في مساحة العمل إلى Shapefile أو KML أو CSV.
| Field | Type | Required | Details |
|---|---|---|---|
file | file | yes | طبقة مساحة العمل بصيغة GeoJSON |
target_format | string | yes | shp | kml | csv | geojson |
base_name | string | optional |
featureCounttruncatedFieldsPOST /map-exportإنشاء لوحة خريطة جاهزة للطباعة تتضمن عنواناً ومفتاحاً وسهم الشمال.
| Field | Type | Required | Details |
|---|---|---|---|
image | file | yes | كرر الحقل مرة لكل ملفلقطة PNG واحدة لكل كتلة خريطة، مكررة |
logo | file | optional | |
spec | json-string | yes | سلسلة JSON تصف الورقة: الصفحة (a4|a3|letter) والاتجاه والعنوان وعناصر مفتاح الخريطة والإسناد ووسم نظام الإحداثيات وغيرها |