AstroWay/api v2.201.7 · de
alle Systeme in Ordnung
// astrology api · POST /v1/acg/best-places

Beste Orte API

Ordnet reale Städte nach den astrogeografischen Linien eines Horoskopes für eines von neunzehn Lebensbereichen. 34.028 Orte aus GeoNames, bewertet nach der Nähe zu den Linien, aus denen der Bereich besteht, mit separater Berichterstattung über unterstützende und herausfordernde Seiten.

Endpunkt
POST /v1/acg/best-places
Kosten
50 Credits
Latenz
~72 ms
Stufe
Tier 3
// 01 / Was es berechnet

Beste Orte API

Für jede Stadt im Pool misst der Endpunkt die Entfernung zu jeder Linie, die der gewählte Kategorie entspricht, und gewichtet sie nach der Nähe. Die Entfernung wird aus dem Stundenwinkel und der Höhe des Himmelskörpers berechnet, nicht gegen eine gezeichnete Polylinie, was sie exakt macht: Die Entfernung zu einer auf- oder untergehenden Linie ist die Höhe des Himmelskörpers in Grad Bogenmaß, da der Zenitabstand der Großkreisabstand vom Punkt ist, über dem der Himmelskörper steht; und der Versatz einer Meridianlinie ist der Stundenwinkel in geografischen Längengraden, sodass die Entfernung auf der Erdoberfläche das Produkt aus diesem Wert und dem Kosinus der Breite ist. Der Einfluss nimmt linear ab und erreicht am Orb (standardmäßig 1126 km, was den 700 Meilen entspricht, die Jim Lewis verwendete) null. Unterstützende und herausfordernde Summen werden getrennt gehalten und jede beitragende Linie wird mit ihrer eigenen Entfernung zurückgegeben, sodass ein Ort stark und turbulent sein kann, anstatt in den Mittelwert eingerechnet zu werden. Die Ergebnisse werden dann verdünnt, sodass keine zwei innerhalb von 300 km voneinander liegen, und die unterdrückte Anzahl wird gemeldet.

// 02 / Live-Anfrage

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
}'
Antwort (Auszug)
{
  "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 / Parameter

Parameter

nametypeErforderlich
date string (YYYY-MM-DD) ja Birth date.
time string (HH:MM:SS) ja Local clock time at birth.
timezoneOffset number (hours) nein UTC offset in effect at the birth moment. Defaults to 0.
category string ja One of the 19 life categories. The list is at GET /v1/acg/categories.
countries string[] (ISO 3166-1 alpha-2) nein Restrict the search. GET /v1/acg/countries lists what can be ranked and how many cities each country has.
minPopulation number nein Floor on population. The bundled set starts at 15,000, so a lower value changes nothing.
orbKm number nein How far a line reaches. Default 1126, the 700 miles Jim Lewis used.
minSeparationKm number nein Keep results at least this far apart. Default 300. Set 0 for raw score order.
limit number nein How many places to return. Default 25, maximum 100.
sort "net" | "supportive" nein Ranking key. Net (default) subtracts the challenging total; supportive ignores it for ordering only, never for reporting.
// 04 / Wann verwenden

Wann verwenden

Verwenden Sie es, wenn ein Benutzer die offensichtliche nächste Frage gestellt hat. Astrogeografie zeichnet die Linien und ein Kategoriefilter sagt, welche für Geld oder Liebe relevant sind; dies sagt, wo man tatsächlich hingehen soll. Es ist der Unterschied zwischen einer Karte und einer Antwort. In einem Produkt können Sie das Ergebnis direkt in eine Kurzliste einfügen: Jeder Ort trägt seine Koordinaten, Bevölkerung, Zeitzone und die genauen Linien bei, die ihn dorthin platziert haben, mit Entfernungen in Kilometern, sodass die Begründung gezeigt werden kann, anstatt nur behauptet zu werden. Der Geburtsort wird nicht benötigt und nicht verwendet, da die Linien dem Geburtsmoment gehören.

// 05 / Hinweise

Hinweise

Die Verdünnung ist nicht kosmetisch. Eine astrogeografische Linie ist eine Kurve, sodass jede Siedlung entlang davon fast die gleiche Punktzahl erhält, und ohne die Ergebnisse zu verteilen, kamen die Top Ten für Karriere als zehn norwegische Städte innerhalb von 70 km zurück, von denen zwei Bezirke der dritten waren. Setzen Sie `minSeparationKm` auf 0, um die ursprüngliche Reihenfolge zu sehen. **Dies ist keine Geokodierung.** Die Stadtliste ist gebündelt und beginnt bei 15.000 Einwohnern: Eine kleinere Stadt fehlt in der Rangliste, anstatt schlecht platziert zu sein, und ein beliebiger Ortsname kann nicht aufgelöst werden. Um einen bestimmten Punkt Ihrer eigenen zu bewerten, übergeben Sie stattdessen seine Koordinaten an den Endpunkt der astrogeografischen Zonen. Stadtnamen, Koordinaten und Bevölkerungsdaten stammen aus der GeoNames-Geodatenbank, die unter CC BY 4.0 verwendet wird; deren Anzeige erfolgt unter derselben Lizenz, weshalb die Zuordnung in jeder Antwort enthalten ist und nicht nur hier.

Beste Orte-API ausprobieren

Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.

99,9% SLA · kostenpflichtige Tarife · 30 Tage Status →