AstroWay/api v2.201.6 · cs
všechny systémy jsou v pořádku
// astrology api · POST /v1/acg/best-places

Nejlepší místa API

Porovnejte skutečné města s liniami astrokartografie, pro jeden z devatenácti oblastí života. 34 028 míst z GeoNames, skoreno podle toho, jak blízko každé leží k liniím, které oblast tvoří, s podporujícím a výzvovým stranou oddělenou samostatně.

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

Nejlepší místa API

Pro každé město v poolu endpoint měří vzdálenost k každé linii, která je vybraná kategorií, a váží ji podle toho, jak blízko leží. Vzdálenost se vypočítá z úhlové vzdálenosti těla a jeho výšky namísto proti nákresu polilinie, což činí výsledek přesným: vzdálenost k vystupující nebo stoupající linii je úhlová vzdálenost těla v stupních oblouku, protože zenitová vzdálenost je vzdálenost velkého kruhu od bodu, nad který se tělo nachází; a meridianová linie je posunutá o úhlovou vzdálenost v stupních délky, takže zemská vzdálenost je to krát kosinus zeměpisné šířky. Vliv klesá lineárně na nic na orb, 1126 km jako výchozí bod, což je 700 mil, které použil Jim Lewis. Podporující a výzvové celky jsou odděleny a každá přispívající linie se vrátí s vlastní vzdáleností, takže místo může být silné a turbulentní namísto průměrného.

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

Použijte ho, když uživatel se ptá na zřejmý další otázku. Astrokartografie kreslí linie a filtr kategorií říká, které linie jsou důležité pro peníze nebo lásku; toto říká, kde se skutečně jde. Je to rozdíl mezi mapou a odpovědí. V produktu se výsledek přímo vstupte do krátkého seznamu: každé místo nese své souřadnice, počet obyvatel, časové pásmo a přesné linie, které ho tam umístily s vzdáleností v kilometrech, takže důvody lze ukázat namísto tvrzení. Narozené místo se nepotřebuje a není použito, protože linie patří k narozenému momentu.

// 05 / Notes

Notes

Tenčí není kosmetický. Astrokartografická linie je křivka, takže každé sídlo po ní skóruje téměř stejně, a bez rozptylu výsledků se top deset pro kariéru vrátilo jako deset norských měst uvnitř 70 km, z nichž dva byly čtvrti třetího. Nastav `minSeparationKm` na 0, aby viděli čistý pořad.

Try the Nejlepší místa API

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

99,9% SLA · placené plány · 30 dní status →