AstroWay/api v2.201.7 · nl
alle systemen normaal
// astrology api · POST /v1/acg/best-places

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.

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

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.

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

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.

// 05 / Notes

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.

99.9% SLA · betaalde plannen · 30d status →