Nejlepší místa API
Porovnejte skutečné města s liniami astrokartografie, pro jeden z devatenácti oblastí života. 34 028 míst z GeoNames, skoreno podle toho, jak blízko každé leží k liniím, které oblast tvoří, s podporujícím a výzvovým stranou oddělenou samostatně.
Nejlepší místa API
Pro každé město v poolu endpoint měří vzdálenost k každé linii, která je vybraná kategorií, a váží ji podle toho, jak blízko leží. Vzdálenost se vypočítá z úhlové vzdálenosti těla a jeho výšky namísto proti nákresu polilinie, což činí výsledek přesným: vzdálenost k vystupující nebo stoupající linii je úhlová vzdálenost těla v stupních oblouku, protože zenitová vzdálenost je vzdálenost velkého kruhu od bodu, nad který se tělo nachází; a meridianová linie je posunutá o úhlovou vzdálenost v stupních délky, takže zemská vzdálenost je to krát kosinus zeměpisné šířky. Vliv klesá lineárně na nic na orb, 1126 km jako výchozí bod, což je 700 mil, které použil Jim Lewis. Podporující a výzvové celky jsou odděleny a každá přispívající linie se vrátí s vlastní vzdáleností, takže místo může být silné a turbulentní namísto průměrného.
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
Použijte ho, když uživatel se ptá na zřejmý další otázku. Astrokartografie kreslí linie a filtr kategorií říká, které linie jsou důležité pro peníze nebo lásku; toto říká, kde se skutečně jde. Je to rozdíl mezi mapou a odpovědí. V produktu se výsledek přímo vstupte do krátkého seznamu: každé místo nese své souřadnice, počet obyvatel, časové pásmo a přesné linie, které ho tam umístily s vzdáleností v kilometrech, takže důvody lze ukázat namísto tvrzení. Narozené místo se nepotřebuje a není použito, protože linie patří k narozenému momentu.
Notes
Tenčí není kosmetický. Astrokartografická linie je křivka, takže každé sídlo po ní skóruje téměř stejně, a bez rozptylu výsledků se top deset pro kariéru vrátilo jako deset norských měst uvnitř 70 km, z nichž dva byly čtvrti třetího. Nastav `minSeparationKm` na 0, aby viděli čistý pořad.
Try the Nejlepší místa API
Grab a key and make your first call in under a minute.