AstroWay/api v2.201.7 · el
όλες οι υπηρεσίες λειτουργούν κανονικά
// astrology api · POST /v1/acg/best-places

Best places API

Κατηγοριοποιήστε πραγματικές πόλεις κατά τις γραμμές αστρογραφίας ενός χάρτη, για μία από τις δεκαεννιά περιοχές της ζωής. 34.028 τόποι από το GeoNames, βαθμολογημένοι με βάση το πόσο κοντά βρίσκεται κάθε ένας στις γραμμές από τις οποίες αποτελείται η περιοχή, με την υποστηρικτική και την προκλητική πλευρά να αναφέρονται ξεχωριστά.

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

Best places API

Για κάθε πόλη στην λίστα, το endpoint μετρά την απόσταση από κάθε γραμμή που ονομάζει η επιλεγμένη κατηγορία, και την ζυγίζει με βάση το πόσο κοντά πέφτει. Η απόσταση υπολογίζεται από την γωνιακή ώρα και το υψόμετρο του σώματος αντί για μια σχεδιασμένη πολυγραμμή, κάνοντας την ακριβή: η απόσταση από μια γραμμή ανατολής ή δύσης είναι το υψόμετρο του σώματος σε μοίρες τόξου, γιατί η απόσταση από τον ζενίθ είναι η μεγάλη κύκλων απόσταση από το σημείο που στέκεται το σώμα· και η απόκλιση μιας γραμμής μεσημβρίας είναι η γωνιακή ώρα σε μοίρες γεωγραφικού μήκους, οπότε η απόσταση στο έδαφος είναι αυτό πολλαπλασιασμένο με συνημίτονο του γεωγραφικού πλάτους. Η επιρροή μειώνεται γραμμικά μέχρι το μηδέν στο όριο, 1126 km από προεπιλογή, που είναι τα 700 μίλια που χρησιμοποίησε ο Jim Lewis. Οι υποστηρικτικοί και προκλητικοί συνολικοί όποιες διατηρούνται ξεχωριστά και κάθε συνεισφέρουσα γραμμή επιστρέφει με τη δική της απόσταση, οπότε ένας τόπος μπορεί να είναι δυνατός και ταραχώδης αντί να υπολογιστεί στη μέση. Τα αποτελέσματα στη συνέχεια αραιώνονται ώστε κανένα δύο να μην είναι εντός 300 km το ένα από το άλλο, και ο αριθμός που αποκλείστηκε αναφέρεται.

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

Χρησιμοποιήστε το όταν ένας χρήστης έχει κάνει την προφανή επόμενη ερώτηση. Η αστρογραφία σχεδιάζει τις γραμμές και ένας φίλτρο κατηγοριών λέει ποιες έχουν σημασία για χρήματα ή αγάπη· αυτό λέει πού να πάτε στην πραγματικότητα. Είναι η διαφορά μεταξύ ενός χάρτη και μιας απάντησης. Σε ένα προϊόν, τροφοδοτήστε το αποτέλεσμα απευθείας σε μια σύντομη λίστα: κάθε τόπος φέρνει τις συντεταγμένες του, τον πληθυσμό, την ζώνη ώρας, και τις ακριβείς γραμμές που τον τοποθετούν με απόσταση σε χιλιόμετρα, ώστε η λογική να μπορεί να δείχνεται αντί να ισχυρίζεται. Η γενέτειρα δεν χρειάζεται και δεν χρησιμοποιείται, γιατί οι γραμμές ανήκουν στη στιγμή της γέννησης.

// 05 / Notes

Notes

Η αραιώ δεν είναι κοσμητική. Μια γραμμή αστρογραφίας είναι μια καμπύλη, οπότε κάθε οικισμός κατά μήκος της βαθμολογείται σχεδόν το ίδιο, και χωρίς να διανέμεται τα αποτελέσματα, τα δέκα κορυφαία για την καριέρα επέστρεψαν ως δέκα νορβηγικές πόλεις εντός 70 km, δύο από τις οποίες ήταν περιοχές της τρίτης. Ορίστε το `minSeparationKm` σε 0 για να δείτε την ακατέργαστη σειρά. **Αυτό δεν είναι γεωκωδικοποίηση.** Η λίστα πόλεων είναι ενσωματωμένη και ξεκινά από 15.000 κατοίκους: μια μικρότερη πόλη είναι απουσιάζει από την κατάταξη αντί να βαθμολογείται κακά, και ένα τυχαίο τοπωνύμη δεν μπορεί να επιλυθεί. Για να βαθμολογήσετε ένα συγκεκριμένο σημείο δικό σας, περάστε τις συντεταγμένες του στο endpoint των ζωνών αστρογραφίας αντί. Τα ονόματα πόλεων, οι συντεταγμένες και οι πληθυσμοί προέρχονται από τη γεωγραφική βάση δεδομένων GeoNames, χρησιμοποιούμενη υπό CC BY 4.0· η εμφάνισή τους φέρνει την ίδια αναφορά, γι' αυτό η αναφορά εμφανίζεται σε κάθε σώμα απάντησης αντί μόνο εδώ.

Try the Καλύτεροι τόποι API

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

99.9% SLA · επί πληρωμή πλάνα · 30 ημέρες κατάσταση →