AstroWay/api v2.201.7 · hu
minden rendszer működik rendben
// astrology api · POST /v1/acg/best-places

Legjobb helyek API

Rangsorold a valódi városokat a horoszkóp astrocartográfiai vonalaihoz, egy kilenctizenegy életterülethez. 34 028 hely a GeoNames-ből, pontozva attól, mennyire közel vannak a vonalakhoz, amelyek az adott területet alkotják, a támogató és a kihívást jelentő oldal külön jelentve.

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

Legjobb helyek API

Az egyes városoknál az endpoint megméri a távolságot minden vonalhoz, amit a kiválasztott kategória megnevez, és súlyozza, mennyire közel esik. A távolságot a test óraszöge és magassága alapján számítjuk, nem egy rajzolt vonallal, így pontos: a felkelő vagy nyugvó vonal távolsága a test magassága fokban, mert a zenit távolság a nagy kör távolság a test felett álló ponttól; a meridián vonal eltolása az óraszög fokban, így a földi távolság ez szorozva a szélesség koszinuszával. A hatás lineárisan csökken nulláig az alapértelmezett 1126 km-nél, ami Jim Lewis 700 mérföldje. A támogató és a kihívást jelentő összegek külön vannak, és minden hozzájáruló vonal saját távolsággal visszatér, így egy hely erős és turbulens lehet, nem csak középre átlagolva. A találatok ezután ritkítva vannak, hogy ne legyen két hely 300 km-nél közelebb, és a kiszűrt számot jelentjük.

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

Használd, amikor a felhasználó felteszi a nyilvánvaló következő kérdést. Az astrocartography megrajzolja a vonalakat, és egy kategória szűrő megmondja, melyek számítanak pénz vagy szerelem esetén; ez megmondja, hova menj valójában. Ez a különbség egy térkép és egy válasz között. Egy termékben a eredményt közvetlenül egy shortlistba tedd: minden hely tartalmazza a koordinátáit, népességét, időzónáját és a pontos vonalakat, amik oda vezettek, kilométerben megadott távolságokkal, így a gondolatmenet is látható, nem csak állított. A születési hely nem szükséges és nem is használjuk, mert a vonalak a születési pillanathoz tartoznak.

// 05 / Notes

Notes

Az elvékesítés nem csak díszítés. Egy astrocartography vonal egy görbe, így minden település rajta majdnem ugyanazt a pontszámot kapja, és ha nem szórjuk szét az eredményeket, a karrier top tíz tíz norvég város lett 70 km-en belül, köztük kettő a harmadik kerületében. Állítsd a `minSeparationKm`-t 0-ra, hogy lásd a nyers sorrendet. **Ez nem geokódolás.** A városlista be van csomagolva és 15 000 főtől indul: egy kisebb település hiányzik a ranglistáról, nem rosszul rangsorolt, és egy tetszőleges helynév nem oldható fel. Ha a saját pontodat szeretnéd pontozni, add át a koordinátáit az astrocartography zones endpointnak. A városneveket, koordinátákat és népességet a GeoNames földrajzi adatbázisból vesszük, CC BY 4.0 licenc alatt; a megjelenítés ugyanazt a kreditálást igényli, ezért a forrás minden választestben szerepel, nem csak itt.

Try the Legjobb helyek API

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

99,9% SLA · fizetős csomagok · 30 nap állapot →