واجهة برمجة تطبيقات أفضل الأماكن
رتب المدن الحقيقية مقابل خطوط المخطط الفلكي الجغرافي، لأحد مناطق التسعة عشر من الحياة. 34,028 مكانًا من GeoNames، يتم تقييمها بناءً على مدى قرب كل منها من الخطوط التي بُنيت منها تلك المنطقة، مع الإبلاغ عن الجانب الداعم والتحدي بشكل منفصل.
واجهة برمجة تطبيقات أفضل الأماكن
لكل مدينة في المجموعة، يقيس نقطة النهاية المسافة إلى كل خط يسمي الفئة المختارة، ويعطي وزنًا بناءً على مدى قربه. يتم حساب المسافة من زاوية الساعة والارتفاع الجسمي بدلاً من مقابل خط متعدد الأضلاع مرسوم، مما يجعلها دقيقة: المسافة إلى خط صعود أو غروب هي ارتفاع الجسم بدرجات القوس، لأن مسافة القمة هي المسافة الدائرية الكبرى من النقطة التي يقف عليها الجسم؛ وانحراف خط الزوال هو زاوية الساعة بدرجات الطول، لذا فإن المسافة الأرضية هي ذلك مضروبًا في جيب تمام خط العرض. يتضاءل التأثير خطيًا إلى لا شيء عند المدى، 1126 كيلومترًا بشكل افتراضي، وهو 700 ميل استخدمها جيم لويس. يتم الاحتفاظ بإجماليات الدعم والتحدي منفصلة، ويعود كل خط مساهم مع مسافته الخاصة، لذا يمكن أن يكون المكان قويًا ومضطربًا بدلاً من المتوسط. ثم يتم تصفية النتائج بحيث لا تكون أي اثنتين على بعد 300 كيلومترًا من بعضهما البعض، ويتم الإبلاغ عن العدد المُحذوف.
POST/v1/acg/best-places
curl -X POST https://api.astroway.info/v1/acg/best-places \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"category": "career",
"limit": 10
}'{
"ok": true,
"data": {
"type": "acg-best-places",
"orbKm": 1126,
"minSeparationKm": 300,
"suppressedAsTooClose": 99,
"maxPossibleSupportive": 12,
"pool": { "citiesConsidered": 34028, "citiesWithAnyLine": 13589 },
"places": [
{
"name": "Ålesund",
"country": "Norway",
"countryCode": "NO",
"lat": 62.4723,
"lon": 6.1549,
"population": 46747,
"supportive": 3.2529,
"challenging": 0,
"net": 3.2529,
"supportivePercent": 27.1,
"lines": [
{
"planetName": "Sun",
"angle": "MC",
"weight": 3,
"polarity": "supportive",
"distanceKm": 22,
"contribution": 2.9414
}
]
}
],
"attribution": {
"source": "GeoNames",
"licence": "CC BY 4.0",
"licenceUrl": "https://creativecommons.org/licenses/by/4.0/"
}
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | no | UTC offset in effect at the birth moment. Defaults to 0. |
| category | string | yes | One of the 19 life categories. The list is at GET /v1/acg/categories. |
| countries | string[] (ISO 3166-1 alpha-2) | no | Restrict the search. GET /v1/acg/countries lists what can be ranked and how many cities each country has. |
| minPopulation | number | no | Floor on population. The bundled set starts at 15,000, so a lower value changes nothing. |
| orbKm | number | no | How far a line reaches. Default 1126, the 700 miles Jim Lewis used. |
| minSeparationKm | number | no | Keep results at least this far apart. Default 300. Set 0 for raw score order. |
| limit | number | no | How many places to return. Default 25, maximum 100. |
| sort | "net" | "supportive" | no | Ranking key. Net (default) subtracts the challenging total; supportive ignores it for ordering only, never for reporting. |
When to use it
استخدمه عندما يسأل المستخدم السؤال التالي الواضح. المخطط الفلكي الجغرافي يرسم الخطوط، ومصنف الفئة يحدد أيها مهم للمال أو الحب؛ هذا يحدد أين يجب الذهاب بالفعل. إنه الفرق بين الخريجة والإجابة. في منتج، قم بتغذية النتيجة مباشرة في قائمة مختصرة: كل مكان يحمل إحداثياته، وسكانه، ووقته الزمني، والخطوط الدقيقة التي وضعتته هناك مع المسافات بالكيلومترات،以便 يمكن إظهار التبرير بدلاً من التأكيد. مكان الولادة ليس مطلوبًا ولا يتم استخدامه، لأن الخطوط تنتمي إلى لحظة الولادة.
Notes
التصفية ليست مجرد زخرفة. خط المخطط الفلكي الجغرافي هو منحنى، لذا يحصل كل مستوطن على طول على درجة متشابهة تقريبًا، وبدون نشر النتائج، جاء العشرة الأوائل للمهنة كعشر بلدات نرويجية داخل 70 كيلومترًا، اثنتان منها كانتا مناطق من الثالثة. اضبط `minSeparationKm` على 0 لترتيب الأصلي. **هذا ليس ترميزًا جغرافيًا.** قائمة المدن مجمعة وتبدأ من 15,000 شخص: البلدة الأصغر غائب عن الترتيب بدلاً من أن يكون ترتيبها سيئًا، ولا يمكن حل اسم مكان عشوائي. لتقييم نقطة محددة منك، مرر إحداثياتها إلى نقطة نهاية مناطق المخطط الفلكي الجغرافي بدلاً من ذلك. أسماء المدن والإحداثيات والسكان تأتي من قاعدة البيانات الجغرافية GeoNames، المستخدمة بموجب CC BY 4.0؛ عرضها يحمل نفس الاعتماد، وهو السبب في أن الاعتماد يظهر في كل جسم رد بدلاً من هنا فقط.
Try the أفضل الأماكن API
Grab a key and make your first call in under a minute.