AstroWay/api v2.173.1 · ar
جميع الأنظمة تعمل بشكل طبيعي
// astrology api · POST /v1/geodetic

واجهة برمجة تطبيقات الرسم البياني المكافئ الجيوديسي

الرسم البياني الجيوديسي يستمد الأربع زوايا من الجغرافيا فقط. درجة صفر من برج الحمل مثبتة على خط غرينتش، وكل درجة من خط الطول تصبح درجة من دائرة البروج، وأي مكان على الأكتسب سماء الوسط والصعود دون الحاجة إلى وقت الميلاد على الإطلاق.

Endpoint
POST /v1/geodetic
Cost
10 credits
Latency
~121 ms
Tier
Tier 1
// 01 / What it computes

واجهة برمجة تطبيقات الرسم البياني المكافئ الجيوديسي

مع إعطاء خط عرض وخط طول، يعيد نقطة النهاية السماء الجيوديسية الوسطى، القاع، الصعود والغروب في درجات دائرة البروج، مع فهرس البرجة والدرجة داخل البرجة للسماء الوسطى والصعود. تدعم مدرستان. مدرسة سفاريا (الافتراضية) تعكس خط الطول الأرضي مباشرة على خط الطول البروجي، لذا فإن 30.52 درجة شرق هي 0 درجة 31 دقيقة من الثور. تطبيق جوندرو تصحيح الميل، والذي يغير موضع الصعود بالنسبة لقيمة سفاريا ويحتاج إلى إما سنة أو ميل صريح بالدرجات. لأن لا شيء عن الشخص يدخل في الحساب، فإن نفس الإحداثيات تعيد دائمًا نفس الزوايا، مما يجعل نقطة النهاية رخيصة للتخزين المؤقت والمرساة الطبيعية للميزة القائمة على المكان بدلاً من الميزة القائمة على الشخص.

// 02 / Live request

POST/v1/geodetic

curl -X POST https://api.astroway.info/v1/geodetic \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "latitude": 50.45,
  "longitude": 30.52,
  "method": "sepharial"
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "mc": 30.52,
    "ic": 210.52,
    "asc": 317.7269,
    "dsc": 137.7269,
    "mcSign": 1,
    "mcDegree": 0.52,
    "ascSign": 10,
    "ascDegree": 17.7269,
    "method": "sepharial"
  }
}
// 03 / Parameters

Parameters

nametypeRequired
latitude number yes Place latitude, decimal degrees (north positive).
longitude number yes Place longitude, decimal degrees (east positive). This is what drives the geodetic MC.
method string no sepharial (default) maps longitude directly onto the zodiac; johndro applies an obliquity correction.
year number no Year used for the obliquity value in the johndro method. Ignored by sepharial.
obliquity number no Explicit obliquity in degrees, overriding the year-derived value.
// 04 / When to use it

When to use it

استخدم الرسم البياني الجيوديسي في العمل الروتيني، حيث يكون الموضوع دولة أو مدينة أو حدثًا بدلاً من شخص. الاستخدامات النموذجية هي اختبار ما إذا كان خسوف أو دخول يقع على الزوايا الجيوديسية للعاصمة، أو بناء صفحة ملف تعريف لدولة تحتاج إلى رسم بياني لكن ليس لها وقت تأسيس دفاعي، ومقارنة الجغرافيا الفلكية بطريقة مستقلة تمامًا. كما أنه يحل مشكلة عملية في المنتجات الاستهلاكية: عندما لا يكون لدى المستخدم وقت ميلاد، تتدهور معظم نقاط نهاية الرسوم البيانية بشكل سيء، لكن الرسم البياني الجيوديسي لمدينته الحالية لا يزال محددًا بالكامل ويقول شيئًا محددًا عن المكان. الاستجابة صغيرة ومحددة، لذا تكلفة مكالمة من المستوى الأول وهي آمنة للحساب لقائمة كاملة من المدن في عملية واحدة.

// 05 / Notes

Notes

سفاريا وجوندرو يختلفان بالتصميم، وليس بالخطأ؛ يتم إرجاع كليهما عند الطلب بدلاً من تقديم أحدهما كمرجع. يرجع التقنية إلى سفاريا في أوائل القرن العشرين وقام بتطويرها إدوارد جوندرو. لأن الإطار الجيوديسي مثبت على خط غرينتش، تكون النتائج مستقرة عبر الزم ولا تتطلب البحث في الجداول الفلكية، وهذا هو السبب في أن هذه هي نقطة النهاية الوحيدة في عائلة الجغرافيا الفلكية التي لا تعتمد على الجداول الفلكية السويسرية.

Try the الرسم البياني الجيوديسي API

Grab a key and make your first call in under a minute.

99.9% SLA · الخطط المدفوعة · 30d الحالة →