API de mejores lugares

Para cada ciudad en el grupo, el endpoint mide la distancia a cada línea que nombra la categoría elegida, y la pondera según lo cerca que esté. La distancia se calcula desde el ángulo horario y la altitud del cuerpo en lugar de contra una polilínea dibujada, lo que la hace exacta: la distancia a una línea de salida o puesta es la altitud del cuerpo en grados de arco, porque la distancia cenital es la distancia de gran círculo desde el punto sobre el que se encuentra el cuerpo; y el desplazamiento de una línea meridiana es el ángulo horario en grados de longitud, por lo que la distancia terrestre es eso multiplicado por el coseno de la latitud. La influencia disminuye linealmente hasta cero en la órbita, 1126 km por defecto, que son las 700 millas que Jim Lewis usó. Los totales de apoyo y desafío se mantienen separados y cada línea contribuyente vuelve con su propia distancia, por lo que un lugar puede ser fuerte y turbulento en lugar de promediarse en el medio. Los resultados luego se reducen para que no haya dos dentro de 300 km entre sí, y se informa el número suprimido.

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

Úsalo cuando un usuario ha hecho la siguiente pregunta obvia. La astrocartografía dibuja las líneas y un filtro de categoría dice cuáles importan para el dinero o el amor; esto dice dónde realmente ir. Es la diferencia entre un mapa y una respuesta. En un producto, introduce el resultado directamente en una lista corta: cada lugar lleva sus coordenadas, población, huso horario y las líneas exactas que lo colocan con distancias en kilómetros, para que se pueda mostrar el razonamiento en lugar de afirmarlo. El lugar de nacimiento no es necesario ni se usa, porque las líneas pertenecen al momento del nacimiento.

El recorte no es cosmético. Una línea de astrocartografía es una curva, por lo que cada asentamiento a lo largo de ella obtiene casi la misma puntuación, y sin extender los resultados, los diez primeros para la carrera volvieron como diez ciudades noruegas dentro de 70 km, dos de las cuales eran distritos de la tercera. Establece `minSeparationKm` en 0 para ver el orden bruto. **Esto no es geocodificación.** La lista de ciudades está agrupada y comienza en 15,000 personas: una ciudad más pequeña está ausente de la clasificación en lugar de clasificarse mal, y un nombre de lugar arbitrario no se puede resolver. Para puntuar un punto específico tuyo, pasa sus coordenadas al endpoint de zonas de astrocartografía en su lugar. Los nombres de ciudades, coordenadas y poblaciones provienen de la base de datos geográfica GeoNames, utilizada bajo CC BY 4.0; mostrarlos lleva el mismo crédito, por lo que la atribución se incluye en cada cuerpo de respuesta en lugar de solo aquí.