API de melhores lugares

Para cada cidade do conjunto, o endpoint mede a distância a cada linha que a categoria escolhida indica e pondera-a conforme a proximidade. A distância é calculada a partir do ângulo horário e da altitude do astro, e não contra uma polilinha desenhada, o que a torna exata: a distância a uma linha de nascimento ou ocaso é a altitude do astro em graus de arco, porque a distância ao zénite é a distância de grande círculo ao ponto sobre o qual o astro se encontra; e o desvio de uma linha meridiana é o ângulo horário em graus de longitude, pelo que a distância no terreno é esse valor vezes o cosseno da latitude. A influência decresce linearmente até zero no orbe, 1126 km por omissão, que são as 700 milhas que Jim Lewis usava. Os totais favoráveis e desafiantes são mantidos separados e cada linha contribuinte é devolvida com a sua própria distância, para que um lugar possa ser forte e turbulento em vez de diluído numa média. Os resultados são depois adelgaçados para que nenhum par fique a menos de 300 km um do outro, e o número suprimido é reportado.

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

Usa-o quando um utilizador fez a pergunta óbvia seguinte. A astrocartografia desenha as linhas e um filtro de categoria diz quais importam para dinheiro ou amor; isto diz para onde ir de facto. É a diferença entre um mapa e uma resposta. Num produto, alimenta o resultado diretamente para uma lista restrita: cada lugar traz as suas coordenadas, população, fuso horário e as linhas exatas que o colocaram ali, com distâncias em quilómetros, para que o raciocínio possa ser mostrado em vez de afirmado. O local de nascimento não é necessário nem é usado, porque as linhas pertencem ao momento do nascimento.

O adelgaçamento não é cosmético. Uma linha de astrocartografia é uma curva, por isso cada povoação ao longo dela pontua quase o mesmo, e sem dispersar os resultados o top dez de carreira voltava como dez vilas norueguesas dentro de 70 km, duas das quais eram bairros da terceira. Define `minSeparationKm` como 0 para veres a ordem bruta. **Isto não é geocodificação.** A lista de cidades vem incluída e começa nos 15 000 habitantes: uma vila mais pequena está ausente do ranking em vez de mal classificada, e um nome de lugar arbitrário não pode ser resolvido. Para pontuar um ponto específico teu, passa as suas coordenadas ao endpoint de zonas de astrocartografia. Os nomes das cidades, coordenadas e populações vêm da base de dados geográfica GeoNames, usada sob CC BY 4.0; exibi-los implica o mesmo crédito, razão pela qual a atribuição vai em cada corpo de resposta e não apenas aqui.