AstroWay/api v2.201.7 · vi
tất cả hệ thống hoạt động bình thường
// astrology api · POST /v1/acg/best-places

API tốt nhất địa điểm

Xếp hạng các thành phố thực tế so với các đường astrocartography của một biểu đồ, cho một trong mười chín lĩnh vực cuộc sống. 34,028 địa điểm từ GeoNames, được đánh giá dựa trên mức độ gần của từng địa điểm với các đường được xây dựng từ khu vực đó, với mặt hỗ trợ và mặt thách thức được báo cáo riêng biệt.

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

API tốt nhất địa điểm

Đối với mỗi thành phố trong nhóm, điểm cuối đo khoảng cách đến mỗi đường mà tên danh mục được chọn, và trọng số nó dựa trên mức độ gần của nó. Khoảng cách được tính từ góc giờ và độ cao của thiên thể thay vì so với một đường polyline vẽ, điều này làm cho nó chính xác: khoảng cách đến một đường mọc hoặc lặn là độ cao của thiên thể theo độ cung, vì khoảng cách thiên đỉnh là khoảng cách tròn lớn từ điểm mà thiên thể đứng trên; và độ lệch của đường kinh tuyến là góc giờ theo độ kinh độ, do đó khoảng cách mặt đất là đó nhân với cosin của vĩ độ. Ảnh hưởng giảm tuyến tính xuống không gì cả ở khoảng cách, mặc định là 1126 km, là 700 dặm mà Jim Lewis đã sử dụng. Tổng hỗ trợ và thách thức được giữ riêng biệt và mỗi đường đóng góp trở lại với khoảng cách riêng của nó, do đó một địa điểm có thể mạnh mẽ và hỗn loạn thay vì được trung bình hóa vào giữa. Kết quả sau đó được làm mỏng để không có hai kết quả nào trong vòng 300 km của nhau, và số lượng bị loại bỏ được báo cáo.

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

Sử dụng nó khi người dùng đã hỏi câu hỏi tiếp theo rõ ràng. Astrocartography vẽ các đường và bộ lọc danh mục nói những đường nào quan trọng cho tiền bạc hoặc tình yêu; điều này nói nơi thực sự đi. Đó là sự khác biệt giữa một bản đồ và một câu trả lời. Trong một sản phẩm, đưa kết quả thẳng vào danh sách ngắn: mỗi địa điểm mang theo tọa độ, dân số, múi giờ, và các đường chính xác đã đặt nó ở đó với khoảng tính bằng kilômét, để lý do có thể được hiển thị thay vì được khẳng định. Nơi sinh không cần thiết và không được sử dụng, vì các đường thuộc về thời điểm sinh.

// 05 / Notes

Notes

Việc làm mỏng không phải là để trang trí. Một đường astrocartography là một đường cong, do đó mỗi khu định cư dọc theo nó có điểm gần như giống nhau, và nếu không phân tán kết quả, top mười cho sự nghiệp trở thành mười thị trấn Na Uy trong vòng 70 km, trong đó hai là quận của thị trấn thứ ba. Đặt `minSeparationKm` thành 0 để xem thứ thô. **Đây không phải là địa lý hóa.** Danh sách thành phố được đóng gói và bắt đầu từ 15,000 người: một thị trấn nhỏ hơn vắng mặt trong bảng xếp hạng thay vì được xếp hạng kém, và một tên địa điểm tùy ý không thể được giải quyết. Để đánh giá một điểm cụ thể của riêng bạn, hãy chuyển tọa độ của nó đến điểm cuối các vùng astrocartography thay vào đó. Tên thành phố, tọa độ và dân số đến từ cơ sở dữ liệu địa lý GeoNames, được sử dụng theo CC BY 4.0; hiển thị chúng mang lại cùng một tín dụng, đó là lý do tại sao việc ghi nguồn được gửi trong mọi phần phản hồi thay vì chỉ ở đây.

Try the tốt nhất địa điểm API

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

99,9% SLA · gói trả phí · 30 ngày trạng thái →