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.
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.
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
}' {
"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/"
}
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| 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. |
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.
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.