API найкращих місць
Ранжування справжніх міст за астрокартографічними лініями карти для однієї з дев'ятнадцяти сфер життя. 34 028 місць із GeoNames, оцінених за близькістю до ліній, з яких складається ця сфера, з окремо поданими підтримувальною та напруженою сторонами.
API найкращих місць
Для кожного міста ендпоінт вимірює відстань до кожної лінії, яку називає обрана категорія, і зважує її за близькістю. Відстань рахується з часового кута й висоти світила, а не по намальованій полілінії, і тому вона точна: відстань до лінії сходу чи заходу дорівнює висоті світила в градусах дуги, бо зенітна відстань це і є відстань по великому колу від точки, над якою світило стоїть; а зсув меридіанної лінії це часовий кут у градусах довготи, тож відстань по землі дорівнює йому, помноженому на косинус широти. Вплив спадає лінійно до нуля на орбісі, за замовчуванням 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/"
}
}
}Параметри
| name | type | Обов’язк. | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | так | Birth date. |
| time | string (HH:MM:SS) | так | Local clock time at birth. |
| timezoneOffset | number (hours) | ні | UTC offset in effect at the birth moment. Defaults to 0. |
| category | string | так | One of the 19 life categories. The list is at GET /v1/acg/categories. |
| countries | string[] (ISO 3166-1 alpha-2) | ні | Restrict the search. GET /v1/acg/countries lists what can be ranked and how many cities each country has. |
| minPopulation | number | ні | Floor on population. The bundled set starts at 15,000, so a lower value changes nothing. |
| orbKm | number | ні | How far a line reaches. Default 1126, the 700 miles Jim Lewis used. |
| minSeparationKm | number | ні | Keep results at least this far apart. Default 300. Set 0 for raw score order. |
| limit | number | ні | How many places to return. Default 25, maximum 100. |
| sort | "net" | "supportive" | ні | Ranking key. Net (default) subtracts the challenging total; supportive ignores it for ordering only, never for reporting. |
Коли використовувати
Беріть тоді, коли користувач поставив очевидне наступне питання. Астрокартографія малює лінії, фільтр за категорією каже, які з них важать для грошей чи кохання, а це каже, куди власне їхати. Різниця між картою і відповіддю. У продукті результат лягає прямо в короткий список: кожне місце несе координати, населення, часовий пояс і точний перелік ліній, які його туди привели, з відстанями в кілометрах, тож міркування можна показати, а не проголосити. Місце народження не потрібне й не використовується, бо лінії належать моменту народження.
Нотатки
Проріджування тут не косметика. Астрокартографічна лінія це крива, тож кожен населений пункт уздовж неї має майже однаковий бал, і без рознесення перша десятка для кар'єри поверталася десятьма норвезькими містечками в межах 70 км, два з яких були районами третього. Поставте `minSeparationKm` у 0, щоб побачити сирий порядок. **Це не геокодування.** Список міст вбудований і починається з 15 000 мешканців: менше містечко відсутнє в ранжуванні, а не погано оцінене, і довільну назву місця розпізнати неможливо. Щоб оцінити власну конкретну точку, передайте її координати в ендпоінт зон астрокартографії. Назви міст, координати й населення взято з географічної бази GeoNames за ліцензією CC BY 4.0; показ цих даних тягне за собою те саме зазначення авторства, тому атрибуція їде в тілі кожної відповіді, а не лише тут.
Спробуйте Найкращі місця API
Отримайте ключ і зробіть перший виклик за хвилину.