AstroWay/api v2.202.3 · fr
tous les systèmes sont opérationnels
// astrology api · POST /v1/acg/best-places

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.

Endpoint
POST /v1/acg/best-places
Cost
50 credits
Latency
~72 ms
Tier
Tier 3
// 01 / What it computes

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é.

// 02 / Live request

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
}'
Response (excerpt)
{
  "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/"
    }
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
// 04 / When to use it

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.

// 05 / Notes

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.

99,9% SLA · forfaits payants · 30 j statut →