Beste plaatsen API
Rangschik echte steden tegen de astrocartografische lijnen van een kaart, voor één van de negentien levensgebieden. 34.028 plaatsen uit GeoNames, gescoord op basis van hoe dicht elke bij de lijnen van dat gebied zit, waarbij zowel de ondersteunende als de uitdagende kant apart gerapporteerd worden.
Beste plaatsen API
Voor elke stad in de pool meet het eindpunt de afstand tot elke lijn die de gekozen categorieën noemen, en weegt deze op basis van hoe dicht deze valt. De afstand wordt berekend op basis van het lichaam's uurhoek en hoogte in plaats van tegen een getekende polylijn, wat het exact maakt: de afstand tot een opkomende of ondergaande lijn is het lichaam's hoogte in graden boog, omdat zenitafstand de grootcirkelafstand is vanaf het punt waar het lichaam boven staat; en de offset van een meridiaanlijn is de uurhoek in graden lengtegraad, dus de grondafstand is dat keer de cosinus van de breedtegraad. De invloed neemt lineair af tot niets bij de orb, standaard 1126 km, wat de 700 mijlen is die Jim Lewis gebruikte. Ondersteunende en uitdagende totalen worden apart gehouden en elke bijdragende lijn komt terug met zijn eigen afstand, zodat een plaats sterk en turbulent kan zijn in plaats van gemiddeld in het midden te worden geplaatst. De resultaten worden vervolgens dunner gemaakt zodat er geen twee binnen 300 km van elkaar zijn, en het aantal onderdrukte wordt gerapporteerd.
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
Gebruik het wanneer een gebruiker de volgende logische vraag heeft gesteld. Astrocartografie tekent de lijnen en een categoriefilter zegt welke er belangrijk zijn voor geld of liefde; dit zegt waar je daadwerkelijk naartoe moet gaan. Het is het verschil tussen een kaart en een antwoord. In een product kun je het resultaat direct in een shortlist voeden: elke plaats heeft zijn coördinaten, bevolking, tijdzone, en de exacte lijnen die het daar plaatsen met afstanden in kilometers, zodat de redenering getoond kan worden in plaats van alleen geclaimd te worden. De geboorteplaats is niet nodig en wordt niet gebruikt, omdat de lijnen bij het geboortemoment horen.
Notes
Het dunner maken is niet cosmetisch. Een astrocartografische lijn is een curve, dus elke nederzetting langs deze lijn scoort bijna hetzelfde, en zonder de resultaten te verspreiden kwamen de top tien voor carrière terug als tien Noorse steden binnen 70 km, waarvan twee districten van de derde. Zet `minSeparationKm` op 0 om de ruiste volgorde te zien. **Dit is geen geocoding.** De stadlijst is gebundeld en begint bij 15.000 inwoners: een kleinere stad ontbreekt in de ranglijst in plaats van slecht te scoren, en een willekeurige plaatsnaam kan niet worden opgelost. Om een specifiek punt van uzelf te scoren, geeft u in plaats daarvan de coördinaten door aan het astrocartografische zones-eindpunt. Stadsnamen, coördinaten en bevolkingscijfers komen uit de GeoNames geografische database, gebruikt onder CC BY 4.0; het weergeven ervan draagt dezelfde vermelding, wat de reden is waarom de toewijzing in elke antwoordtekst wordt meegestuurd in plaats van alleen hier.
Try the Beste plaatsen API
Grab a key and make your first call in under a minute.