AstroWay/api v2.201.6 · it
tutti i sistemi sono operativi
// astrology api · POST /v1/acg/best-places

API Migliori luoghi

Classifica città reali rispetto alle linee di astrocartografia di un tema, per una delle diciannove aree della vita. 34,028 luoghi da GeoNames, valutati in base a quanto vicino si trova ciascuna alle linee da cui quell'area è costruita, con il lato supportivo e quello sfidante riportati separatamente.

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

API Migliori luoghi

Per ogni città nel pool, l'endpoint misura la distanza a ciascuna linea denominata dalla categoria scelta, e la pesa in base a quanto vicino si trova. La distanza è calcolata dall'angolo orario e dall'altitudine del corpo celeste piuttosto che rispetto a una polilinea disegnata, il che la rende esatta: la distanza a una linea di levata o tramonto è l'altitudine del corpo in gradi di arco, perché la distanza zenitale è la distanza del cerchio massimo dal punto in cui si trova il corpo; e lo scostamento di una linea meridiana è l'angolo orario in gradi di longitudine, quindi la distanza terrestre è quella moltiplicata per il coseno della latitudine. L'influenza diminuisce linearmente fino a zero all'orbite, 1126 km per impostazione predefinita, che sono i 700 miglia usate da Jim Lewis. I totali supportivi e sfidanti sono mantenuti separati e ogni linea contributiva torna con la propria distanza, quindi un luogo può essere forte e turbolento invece che mediato nel mezzo. I risultati vengono poi filtrati in modo che nessuno sia entro 300 km l'uno dall'altro, e il numero soppresso viene riportato.

// 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

Usalo quando un utente ha posto la domanda ovvia successiva. L'astrocartografia traccia le linee e un filtro di categoria dice quali sono importanti per il denaro o l'amore; questo dice dove andare effettivamente. È la differenza tra una mappa e una risposta. In un prodotto, inserisci direttamente il risultato in una lista breve: ogni luogo porta con sé le sue coordinate, popolazione, fuso orario e le linee esatte che lo posizionano con distanze in chilometri, in modo che il ragionamento possa essere mostrato anziché affermato. Il luogo di nascita non è necessario e non viene utilizzato, perché le linee appartengono al momento della nascita.

// 05 / Notes

Notes

Il filtraggio non è cosmetico. Una linea di astrocartografia è una curva, quindi ogni insediamento lungo di essa ha quasi lo stesso punteggio, e senza distribuire i risultati, i primi dieci per la carriera sono tornati come dieci città norvegesi entro 70 km, due delle quali erano distretti della terza. Imposta `minSeparationKm` su 0 per vedere l'ordine grezzo. **Questo non è geocoding.** L'elenco delle città è raggruppato e inizia a 15.000 persone: una città più piccola è assente dalla classifica anziché classificata male, e un nome di luogo arbitrario non può essere risolto. Per valutare un punto specifico tuo, passa le sue coordinate all'endpoint delle zone di astrocartografia invece. I nomi delle città, le coordinate e le popolazioni provengono dal database geografico GeoNames, utilizzato sotto CC BY 4.0; mostrarli porta lo stesso credito, per cui l'attribuzione viene inclusa in ogni corpo di risposta anziché solo qui.

Try the Migliori luoghi API

Grab a key and make your first call in under a minute.

99.9% SLA · piani a pagamento · 30d stato →