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