AstroWay/api v2.201.7 · ro
toate sistemele sunt în stare normală
// astrology api · POST /v1/acg/best-places

API-ul Celor mai bune locuri

Clasifică orașele reale în funcție de liniile astrocartografiei unui horoscop, pentru una dintre cele nouăsprezece domenii ale vieții. 34.028 de locuri din GeoNames, evaluate în funcție de cât de aproape se află fiecare de liniile din care este construit domeniul, cu partea susținătoare și cea provocatoare raportate separat.

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

API-ul Celor mai bune locuri

Pentru fiecare oraș din bază, endpoint-ul măsoară distanța până la fiecare linie pe care numele categoriei o indică, și o ponderează în funcție de cât de aproape se află. Distanța este calculată din unghiul orar și altitudinea corpului, nu împotriva unei polilinii desenate, ceea ce o face exactă: distanța până la o linie de răsărit sau apus este altitudinea corpului în grade de arc, deoarece distanța zenitului este distanța de cerc mare de la punctul de deasupra căruia se află corpul; iar deplasarea unei linii meridiane este unghiul orar în grade de longitudine, așa că distanța la sol este aceasta înmulțită cu cosinusul latitudinii. Influința scade liniar până la nimic la orb, implicit 1126 km, care sunt cele 700 de mile folosite de Jim Lewis. Totalurile susținătoare și provocatoare sunt păstrate separate, iar fiecare linie contribuitoră revine cu propria sa distanță, astfel că un loc poate fi puternic și turbulent, nu mediat. Rezultatele sunt apoi subțiate astfel încât nici două să nu fie la mai puțin de 300 km una de alta, și numărul suprimat este raportat.

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

Folosește-l când un utilizator a pus întrebarea următoare evidentă. Astrocartografia trasează liniile și un filtru de categorie spune care dintre ele contează pentru bani sau iubire; acest lucru spune unde să mergi de fapt. Este diferența dintre o hartă și un răspuns. Într-un produs, introdu rezultatul direct într-o listă scurtă: fiecare loc își poartă coordonatele, populația, fusul orar, și liniile exacte care l-au plasat acolo cu distanțele în kilometri, astfel raționamentul poate fi arătat nu doar afirmat. Locul nașterii nu este necesar și nu este folosit, deoarece liniile aparțin momentului nașterii.

// 05 / Notes

Notes

Subțierea nu este cosmetică. O linie de astrocartografie este o curbă, așa că fiecare așezare de-a lungul ei are un scor aproape identic, și fără a răspândi rezultatele, primele zece pentru carieră au revenit ca zece orașe norvegiene în interiorul a 70 km, dintre care două erau districte ale celui de-al treilea. Setează `minSeparationKm` la 0 pentru a vedea ordinea brută. **Acesta nu este geocoding.** Lista orașelor este pachetată și începe de la 15.000 de locuitori: un oraș mai mic este absent din clasament nu pentru că este slab clasat, și un nume de loc arbitrar nu poate fi rezolvat. Pentru a evalua un anumit punct al tău, trece coordonatele sale către endpoint-ul de zone de astrocartografie în schimb. Numele orașelor, coordonatele și populațiile provin din baza de date geografică GeoNames, folosită sub CC BY 4.0; afișarea lor poartă aceeași creditare, motiv pentru care atribuția apare în fiecare corp de răspuns, nu doar aici.

Try the Cele mai bune locuri API

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

99,9% SLA · planuri plătite · 30 zile status →