ベストな場所 API
チャートの占星術地図上の線に対して、19の生活領域の一つについて、実際の都市をランク付けします。GeoNamesから34,028の場所があり、各場所がその領域を構成する線にどれだけ近いかによってスコアリングされ、支援的側面と挑戦的側面がそれぞれ報告されます。
ベストな場所 API
プール内の各都市について、エンドポイントは選択されたカテゴリ名の各線までの距離を測定し、その近さに応じて重み付けします。距離は描かれたポリラインではなく、天体の時角と高度から計算されるため、正確になります:昇線または没線までの距離は天体の高度(弧度)であり、天頂距離は天体が位置する点からの大円距離です;子午線のオフセットは経度の時角(度)なので、地上距離はその緯度の余弦をかけたものです。影響はオーブ(デフォルト1126km、ジム・ルイスが使用した700マイル)で線形的にゼロに減衰します。支援的合計と挑戦的合計は別々に保持され、寄与する各線は独自の距離を持ちます。これにより、場所は中間に平均化されるのではなく、強力で不安定なものになります。結果は、どの二つも300km以内にならないようにスリム化され、抑制された数が報告されます。
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
ユーザーが当然の次の質問をしたときに使用します。占星術地図は線を描き、カテゴリフィルターはお金や愛に関連するものを示します;これは実際にどこに行くべきかを示します。これは地図と答えの違いです。製品では、結果を直接短いリストに投入します:各場所は座標、人口、タイムゾーン、そしてそこに位置させる正確な線とキロメートル単位の距離を持ちます。これにより、主張されるのではなく、理由を示すことができます。出生地は必要なく、使用されません。なぜなら、線は出生の瞬間に属するからです。
Notes
スリム化は見た目のためではありません。占星術地図の線は曲線なので、沿線のすべての集落はほぼ同じスコアを持ち、結果を広げないと、キャリアのトップ10は70km以内のノルウェーの10の町として返され、そのうち2つは3番目の町の地区でした。`minSeparationKm`を0に設定して、元の順序を確認してください。**これはジオコーディングではありません。**都市リストはバンドルされており、15,000人から始まります:小さな町はランクが低いのではなく、ランキングから欠落しており、任意の場所名は解決できません。自分の特定のポイントをスコアリングするには、代わりにその座標を占星術地図ゾーンエンドポイントに渡してください。都市名、座標、人口はGeoNames地理データベースからのもので、CC BY 4.0の下で使用されています;それらを表示することは同じクレジットを持ち、これがなぜクレジットがここだけでなくすべてのレスポンスボディに含まれる理由です。
Try the ベストな場所 API
Grab a key and make your first call in under a minute.