API des meilleurs endroits
Classe les vraies villes selon les lignes d'astrocartographie d'une carte, pour l'une des dix-neuf sphères de vie. 34 028 lieux provenant de GeoNames, notés selon leur proximité aux lignes dont dépend chaque sphère, avec les côtés soutenant et challengeant indiqués séparément.
API des meilleurs endroits
Pour chaque ville du pool, l'endpoint mesure la distance à chaque ligne nommée par la catégorie choisie, et la pondère selon la proximité. La distance est calculée à partir de l'angle horaire et de l'altitude du corps plutôt que d'une polyligne dessinée, ce qui la rend exacte : la distance à une ligne de lever ou de coucher est l'altitude du corps en degrés d'arc, car la distance zénithale est la distance orthodromique depuis le point où le corps se trouve au-dessus ; et le décalage d'une ligne méridienne est l'angle horaire en degrés de longitude, donc la distance au sol est ce résultat multiplié par le cosinus de la latitude. L'influence décroît linéairement jusqu'à zéro à l'orb, 1126 km par défaut, soit les 700 miles utilisées par Jim Lewis. Les totaux soutenant et challengeant sont séparés et chaque ligne contributive revient avec sa propre distance, ainsi un lieu peut être fort et turbulent plutôt que moyenné. Les résultats sont ensuite épurés pour qu'aucun ne soit à moins de 300 km l'un de l'autre, et le nombre supprimé est indiqué.
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
Utilise-le quand un utilisateur pose la question évidente suivante. L'astrocartographie trace les lignes et un filtre de catégorie indique celles qui comptent pour l'argent ou l'amour ; celui-ci indique où aller réellement. C’est la différence entre une carte et une réponse. Dans un produit, injecte le résultat directement dans une shortlist : chaque lieu fournit ses coordonnées, sa population, son fuseau horaire, et les lignes exactes qui le placent là avec les distances en kilomètres, ainsi le raisonnement peut être montré plutôt qu'affirmé. Le lieu de naissance n’est pas nécessaire et n’est pas utilisé, car les lignes appartiennent au moment de naissance.
Notes
L'épuration n’est pas cosmétique. Une ligne d'astrocartographie est une courbe, donc chaque peuplement le long de celle-ci obtient presque le même score, et sans étaler les résultats les dix meilleurs pour la carrière étaient dix villes norvégiennes dans un rayon de 70 km, dont deux faisaient partie du même district. Mets `minSeparationKm` à 0 pour voir l’ordre brut. **This is not geocoding.** La liste des villes est fournie et commence à 15 000 habitants : une petite ville est absente du classement plutôt que mal classée, et un nom de lieu arbitraire ne peut pas être résolu. Pour noter un point précis que tu possèdes, envoie ses coordonnées à l'endpoint des zones d'astrocartographie à la place. Les noms de villes, leurs coordonnées et leurs populations proviennent de la base de données géographique GeoNames, utilisée sous CC BY 4.0 ; les afficher implique le même crédit, d’où l’attribution dans chaque corps de réponse et pas seulement ici.
Try the Meilleurs endroits API
Grab a key and make your first call in under a minute.