AstroWay/api v2.201.7 · id
semua sistem normal
// astrology api · POST /v1/acg/best-places

API tempat terbaik

Peringkatkan kota nyata terhadap garis astrocartography dari sebuah carta, untuk salah satu dari sembilan belas area kehidupan. 34,028 tempat dari GeoNames, dinilai berdasarkan seberapa dekat setiap tempat duduk dengan garis yang area tersebut dibangun dari, dengan sisi pendukung dan sisi tantangan dilaporkan secara terpisah.

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

API tempat terbaik

Untuk setiap kota di dalam kumpulan, endpoint mengukur jarak ke setiap garis yang kategori yang dipilih namai, dan memberi bobotnya berdasarkan seberapa dekat jatuhnya. Jarak dihitung dari sudut jam dan ketinggian benda daripada terhadap poligaris yang digambar, yang membuatnya tepat: jarak ke garis terbit atau terbenam adalah ketinggian benda dalam derajat busur, karena jarak zenith adalah jarak lingkaran besar dari titik di mana benda berdiri; dan pergeseran garis meridian adalah sudut jam dalam derajat bujur, sehingga jarak daratan adalah itu dikalikan dengan kosinus lintang. Pengaruh menurun linear menjadi nol di orb, 1126 km secara default, yang merupakan 700 mil yang digunakan Jim Lewis. Total pendukung dan tantangan dipisahkan dan setiap garis kontributor kembali dengan jaraknya sendiri, sehingga sebuah tempat bisa kuat dan bergejolak daripada diratakan ke tengah. Hasil kemudian diencerkan sehingga tidak ada dua yang dalam jarak 300 km satu sama lain, dan jumlah yang disempitkan dilaporkan.

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

Gunakannya ketika pengguna telah bertanya pertanyaan berikutnya yang jelas. Astrocartography menggambar garis dan filter kategori mengatakan mana yang penting untuk uang atau cinta; ini mengatakan ke mana sebenarnya harus pergi. Ini adalah perbedaan antara peta dan jawaban. Dalam sebuah produk, masukkan hasilnya langsung ke dalam daftar pendek: setiap tempat membawa koordinatnya, populasi, zona waktu, dan garis tepat yang menempatkannya di sana dengan jarak dalam kilometer, sehingga alasan dapat ditunjukkan daripada ditegaskan. Tempat lahir tidak diperlukan dan tidak digunakan, karena garis-garis itu milik saat lahir.

// 05 / Notes

Notes

Pengenceran bukanlah hal kosmetik. Garis astrocartography adalah kurva, jadi setiap pemukiman di sepanjangnya mendapat skor hampir sama, dan tanpa menyebarkan hasil, sepuluh teratas untuk karier kembali sebagai sepuluh kota Norwegia di dalam 70 km, dua di antaranya adalah distrik dari ketiga. Tetapkan `minSeparationKm` ke 0 untuk melihat urutan mentah. **Ini bukan geokoding.** Daftar kota dibundel dan dimulai dari 15,000 orang: kota yang lebih kecil tidak ada dalam peringkat daripada diperingkat buruk, dan nama tempat sembarang tidak dapat dipecahkan. Untuk menilai titik tertentu Anda sendiri, lewatkan koordinatnya ke endpoint zona astrocartography sebagai gantinya. Nama kota, koordinat dan populasi berasal dari basis data geografis GeoNames, digunakan di bawah CC BY 4.0; menampilkannya membawa kredit yang sama, itulah mengapa atribusi dikirim di setiap badan respons daripada hanya di sini.

Try the Tempat terbaik API

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

99.9% SLA · paket berbayar · 30d status →