최고의 장소 API
차트의 천문지리학 라인에 대해 19개 삶의 영역 중 하나에 대해 실제 도시를 순위 매깁니다. GeoNames의 34,028개 장소가 각 영역을 구성하는 라인에 얼마나 가까이 위치하는지에 따라 점수가 매겨지며, 지지적 측면과 도전적 측면이 별도로 보고됩니다.
최고의 장소 API
풀의 모든 도시에 대해 엔드포인트는 선택된 카테고리 이름의 각 라인까지의 거리를 측정하고, 얼마나 가까이 위치하는지에 따라 가중치를 부여합니다. 거리는 그린 폴리라인이 아닌 천체의 시각과 고도에서 계산되어 정확해집니다: 상승 또는 하강 라인까지의 거리는 천체의 호도법상 고도이며, 천정 거리는 천체가 서 있는 지점에서의 대원 거리입니다; 자오선 라인의 오프셋은 경도의 시각이므로 지상 거리는 그것에 위도의 코사인을 곱한 값입니다. 영향력은 기본값인 1126km(짐 루이스가 사용한 700마일)인 orb에서 선형적으로 사라집니다. 지지적 총합과 도전적 총합은 별도로 유지되며, 기여하는 각 라인은 자체 거리와 함께 반환되므로 장소는 중간으로 평균화되기보다 강력하고 불안정할 수 있습니다. 결과는 두 개가 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개 노르웨이 도시로 반환되었는데, 그중 두 개는 세 번째 도시의 구역이었습니다. 원래 순서를 보려면 `minSeparationKm`를 0으로 설정하세요. **이것은 지오코딩이 아닙니다.** 도시 목록은 번들로 제공되며 15,000명부터 시작합니다: 더 작은 도시는 순위가 낮게 매겨지는 대신 순위에서 제외되며, 임의의 장소 이름은 해결할 수 없습니다. 자신의 특정 지점을 점수 매기려면 대신 그 좌표를 천문지리학 구역 엔드포인트에 전달하세요. 도시 이름, 좌표 및 인구는 CC BY 4.0 사용 조건 하에 사용된 GeoNames 지리 데이터베이스에서 가져옵니다; 이를 표시하는 것은 동일한 크레딧을 가지며, 이것이 모든 응답 본문에 속성이 포함되는 이유입니다.
Try the 최고의 장소 API
Grab a key and make your first call in under a minute.