AstroWay/api v2.201.7 · ko
모든 시스템 정상 작동 중
// astrology api · POST /v1/acg/best-places

최고의 장소 API

차트의 천문지리학 라인에 대해 19개 삶의 영역 중 하나에 대해 실제 도시를 순위 매깁니다. GeoNames의 34,028개 장소가 각 영역을 구성하는 라인에 얼마나 가까이 위치하는지에 따라 점수가 매겨지며, 지지적 측면과 도전적 측면이 별도로 보고됩니다.

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

최고의 장소 API

풀의 모든 도시에 대해 엔드포인트는 선택된 카테고리 이름의 각 라인까지의 거리를 측정하고, 얼마나 가까이 위치하는지에 따라 가중치를 부여합니다. 거리는 그린 폴리라인이 아닌 천체의 시각과 고도에서 계산되어 정확해집니다: 상승 또는 하강 라인까지의 거리는 천체의 호도법상 고도이며, 천정 거리는 천체가 서 있는 지점에서의 대원 거리입니다; 자오선 라인의 오프셋은 경도의 시각이므로 지상 거리는 그것에 위도의 코사인을 곱한 값입니다. 영향력은 기본값인 1126km(짐 루이스가 사용한 700마일)인 orb에서 선형적으로 사라집니다. 지지적 총합과 도전적 총합은 별도로 유지되며, 기여하는 각 라인은 자체 거리와 함께 반환되므로 장소는 중간으로 평균화되기보다 강력하고 불안정할 수 있습니다. 결과는 두 개가 300km 이내에 오지 않도록 얇게 만들어지며, 억제된 수량이 보고됩니다.

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

얇게 만드는 것은 단순한 장식이 아닙니다. 천문지리학 라인은 곡선이므로, 그 위의 모든 정착지는 거의 동일한 점수를 받으며, 결과를 분배하지 않으면 경력 상위 10개가 70km 이내의 10개 노르웨이 도시로 반환되었는데, 그중 두 개는 세 번째 도시의 구역이었습니다. 원래 순서를 보려면 `minSeparationKm`를 0으로 설정하세요. **이것은 지오코딩이 아닙니다.** 도시 목록은 번들로 제공되며 15,000명부터 시작합니다: 더 작은 도시는 순위가 낮게 매겨지는 대신 순위에서 제외되며, 임의의 장소 이름은 해결할 수 없습니다. 자신의 특정 지점을 점수 매기려면 대신 그 좌표를 천문지리학 구역 엔드포인트에 전달하세요. 도시 이름, 좌표 및 인구는 CC BY 4.0 사용 조건 하에 사용된 GeoNames 지리 데이터베이스에서 가져옵니다; 이를 표시하는 것은 동일한 크레딧을 가지며, 이것이 모든 응답 본문에 속성이 포함되는 이유입니다.

Try the 최고의 장소 API

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

99.9% SLA · 유료 플랜 · 30일 상태 →