FreeAstroAPIАстрокартография APIЛинии, перемещение и рейтинг города
Создайте точку поиска точки отклонения, часы передатчиков и астрологические продукты world-map с плотными линиями WGS84 GeoJSON, изогнутыми путями geodesic-style ASC и DSC, меридианами MC и IC, пересечениями геометрий паранов и сводками переносных карт.
Создан для картографических продуктов и рабочих процессов переезда
Поверхность астрокартографии разделена на понятные строительные блоки, поэтому команды могут отображать карты, ранжировать города, оценивать один пункт назначения или создавать сводные данные перемещенных карт без объединения нескольких пользовательских конвейеров.
Линии Map-Ready
Верните плотный WGS84 GeoJSON, чтобы внешний интерфейс мог рисовать приложения MC, IC, ASC и DSC непосредственно на 2D-картах без этапов перестроения.
Горячие точки Парана
Комбинации внешнего парана с метаданными focus-aware и геометрическими полосами GeoJSON для продвинутых наблюдений астрокартографии и пользовательского интерфейса самых дальних точек.
Городской подсчет очков
Оцените одно известное направление в пяти общественных сферах и объясните, откуда взялась эта оценка.
Рейтинговые направления
Ищите и оценивайте города по критериям карьеры, романтики, дома, здоровья или духовной направленности, не создавая собственную систему ранжирования.
Конечные точки
Начните с одной конечной точки обзора или объедините площадь поверхности, чтобы получить более широкие возможности перемещения и картографирования.
Городская проверка
/api/v1/western/astrocartography/city-checkОцените один город по сферам карьеры, романтики, дома, здоровья и духовности в одном запросе.
Рекомендации
/api/v1/western/astrocartography/recommendationsРанжируйте города-кандидаты по выбранному направлению, чтобы пользователи могли изучить лучшие направления, прежде чем выбрать одно из них.
Lines
/api/v1/western/astrocartography/linesВозвращает плотную геометрию линий WGS84 GeoJSON для прямого рендеринга 2D-карт, наложений full-chart и картографических продуктов без решения пути client-side.
Паранс
/api/v1/western/astrocartography/paransПредоставляйте перекрестки парана и темы с наиболее сильным фокусом для анализа горячих точек, расширенных слоев карты и анализа местоположения.
Переезд
/api/v1/western/astrocartography/relocationСоздайте перемещенную диаграмму и сводную информацию о перемещении, настроенную для оценки перемещения и пользовательского интерфейса сравнения пунктов назначения.
Начните с одного графика, затем нарисуйте все
Конечная точка линии — это самая быстрая отправная точка для картографических продуктов. Он возвращает плотную геометрию WGS84 GeoJSON, которую можно визуализировать напрямую, включая изогнутые пути ASC и DSC, вертикальные дорожки MC и IC, а также точки пересечения GeoJSON по запросу.
Один контракт геометрии для каждой линии
MC, IC, ASC и DSC действуют как GeoJSON, поэтому один рендерер может нарисовать полную диаграмму.
Включены изогнутые траектории geodesic-style.
ASC и DSC позиционируются как последовательность координат ready-to-draw вместо подсказок завершения.
Переезды остаются map-native
Если этот вариант включен, пересечения будут возвращаться в виде точек GeoJSON, которые непосредственно влияют на уровень ваших карт.
{
"meta": {
"geometry_format": "geojson",
"coordinate_reference_system": "WGS84",
"coordinate_order": "longitude_latitude",
"line_sample_step_degrees": 0.25,
"crossing_count": 2
},
"lines": [
{
"id": "sun:asc",
"body": "sun",
"angle": "asc",
"geometry": {
"type": "LineString",
"coordinates": [
[-159.2, -68.0],
[-124.8, -48.0],
[-101.5, -32.0],
[-72.6, 0.0],
[-43.4, 32.0],
[15.4, 68.0]
]
}
},
{
"id": "venus:asc",
"body": "venus",
"angle": "asc",
"geometry": {
"type": "MultiLineString",
"coordinates": [
[[121.4, -62.0], [171.5, -20.0]],
[[-178.4, -8.0], [-123.4, 54.0]]
]
}
}
],
"crossings": [
{
"id": "sun:mc|moon:dsc",
"geometry": {
"type": "Point",
"coordinates": [-22.7, 0.0]
}
}
],
"notes": {
"rendering": "The payload is already dense enough for direct MapLibre or Mapbox drawing."
}
}Отрисовывайте астрокартографию в виде диаграммы, а не в виде скользкой карты.
В этом режиме используется метод визуализации прямоугольных диаграмм с фиксированной мировой рамкой, сеткой, метками рамок и способом построения линий. Он разработан так, чтобы быть ближе к классическому программному резерву для астрокартографии, сохраняя при этом ту же геометрию API.
Демонстрация классической диаграммы
Прямоугольный вид карты, построенный на основе полезной нагрузки линий астрокартографии.
Chart-first Рендеринг
В данном представлении вместо скользящей карты используется фиксированная прямоугольная мировая диаграмма. Это намного ближе к классическому программному обеспечению для астрокартографии, поскольку геометрия отображается в виде диаграмм, а не в виде наложений фрагментов интерактивной карты. Когда API возвращает «chart_families», средства визуализации используют их как непрерывные направляющие кривые AC/DC под точными линиями ветвления.
Проекция: тарелка карре / равноугольная
Геометрия: geojson, WGS84
Покажите рекомендуемый город и линии, обосновывающие его.
Полезный контракт по рекомендациям делает больше, чем просто ранжирует город. Он также получает координаты пункта назначения, пояснения блоков city-scoped и точные идентификаторы линий, которые средства визуализации должны отобразить для этого города.
Пример карты рекомендаций
Ранжированный список городов, его координаты и точные линии, на которые ссылается выбранный город. map_line_ids.
Как клиент использует полезную нагрузку
Прочтите ранжированные координаты города из ответа на рекомендации, затем определите координаты выбранного города. map_line_ids against map.lines для рисования только соответствующих наложений.
Why Amiens высоко оценен
Mercury MC is the strongest supportive line for this career search, with 3 nearby contributing line(s). Интерфейс переключает видимые наложения карты непосредственно с карты этого города. map_line_ids вместо того, чтобы гадать, какие глобальные линии имеют значение.
Топ рекомендуемых городов
Карьерный фокусПример ответа на рекомендации
В этом примере показан реальный ранжированный список городов, который позволяет зрителю переключать активный город из того же массива «результатов». Интерфейс использует map_line_ids нескольких городов для разрешения видимых линий без нарушения геометрии.
{
"results": [
{
"city": {
"name": "Amiens",
"country": "FR",
"state": "Hauts-de-France",
"lat": 49.9,
"lng": 2.3,
"timezone": "Europe/Paris",
"population": 143086
},
"city_visual_explanation": {
"explanation_mode": "line_plus_paran",
"map_line_ids": [
"mercury:mc",
"neptune:mc",
"sun:mc",
"mars:dsc",
"true_node:mc",
"venus:asc",
"pluto:mc"
],
"primary_lines": [
{
"body": "mercury",
"angle": "mc",
"distance_km": 9,
"line_id": "mercury:mc",
"is_close": true,
"visual_strength": "high",
"source_focuses": [
"career"
]
},
{
"body": "neptune",
"angle": "mc",
"distance_km": 116.8,
"line_id": "neptune:mc",
"is_close": true,
"visual_strength": "high",
"source_focuses": [
"career"
]
}
],
"primary_parans": [
{
"id": "mars:dsc:true_node:mc:49.281",
"body_a": "mars",
"event_a": "dsc",
"body_b": "true_node",
"event_b": "mc",
"distance_km": 68.9,
"is_close": true,
"visual_strength": "high",
"source_focuses": [
"career"
]
}
]
},
"match_tier": "strong",
"rank": 1,
"score": 120.62,
"signal_strength": "strong",
"summary": "Mercury MC is the strongest supportive line for this career search, with 3 nearby contributing line(s)."
},
{
"city": {
"name": "Albert",
"country": "FR",
"state": "Hauts-de-France",
"lat": 50.00091,
"lng": 2.65096,
"timezone": "Europe/Paris",
"population": 10588
},
"city_visual_explanation": {
"explanation_mode": "line_plus_paran",
"map_line_ids": [
"mercury:mc",
"neptune:mc",
"sun:mc",
"mars:dsc",
"true_node:mc",
"venus:asc",
"pluto:mc"
],
"primary_lines": [
{
"body": "mercury",
"angle": "mc",
"distance_km": 16.1,
"line_id": "mercury:mc",
"is_close": true,
"visual_strength": "high",
"source_focuses": [
"career"
]
},
{
"body": "neptune",
"angle": "mc",
"distance_km": 91.5,
"line_id": "neptune:mc",
"is_close": true,
"visual_strength": "high",
"source_focuses": [
"career"
]
}
],
"primary_parans": [
{
"id": "mars:dsc:true_node:mc:49.281",
"body_a": "mars",
"event_a": "dsc",
"body_b": "true_node",
"event_b": "mc",
"distance_km": 80.1,
"is_close": false,
"visual_strength": "medium",
"source_focuses": [
"career"
]
}
]
},
"match_tier": "strong",
"rank": 2,
"score": 120.47,
"signal_strength": "strong",
"summary": "Mercury MC is the strongest supportive line for this career search, with 3 nearby contributing line(s)."
},
{
"city": {
"name": "Isbergues",
"country": "FR",
"state": "Hauts-de-France",
"lat": 50.62328,
"lng": 2.45902,
"timezone": "Europe/Paris",
"population": 10067
},
"city_visual_explanation": {
"explanation_mode": "line_plus_paran",
"map_line_ids": [
"mercury:mc",
"neptune:mc",
"sun:mc",
"mars:dsc",
"true_node:mc",
"venus:asc",
"pluto:mc"
],
"primary_lines": [
{
"body": "mercury",
"angle": "mc",
"distance_km": 2.4,
"line_id": "mercury:mc",
"is_close": true,
"visual_strength": "high",
"source_focuses": [
"career"
]
},
{
"body": "neptune",
"angle": "mc",
"distance_km": 103.8,
"line_id": "neptune:mc",
"is_close": true,
"visual_strength": "high",
"source_focuses": [
"career"
]
}
],
"primary_parans": [
{
"id": "mars:dsc:true_node:mc:49.281",
"body_a": "mars",
"event_a": "dsc",
"body_b": "true_node",
"event_b": "mc",
"distance_km": 149.4,
"is_close": false,
"visual_strength": "medium",
"source_focuses": [
"career"
]
}
]
},
"match_tier": "strong",
"rank": 3,
"score": 119.1,
"signal_strength": "strong",
"summary": "Mercury MC is the strongest supportive line for this career search, with 3 nearby contributing line(s)."
},
{
"city": {
"name": "Coudekerque-Branche",
"country": "FR",
"state": "Hauts-de-France",
"lat": 51.02288,
"lng": 2.39359,
"timezone": "Europe/Paris",
"population": 25201
},
"city_visual_explanation": {
"explanation_mode": "line_plus_paran",
"map_line_ids": [
"mercury:mc",
"neptune:mc",
"sun:mc",
"mars:dsc",
"true_node:mc"
],
"primary_lines": [
{
"body": "mercury",
"angle": "mc",
"distance_km": 2.2,
"line_id": "mercury:mc",
"is_close": true,
"visual_strength": "high",
"source_focuses": [
"career"
]
},
{
"body": "neptune",
"angle": "mc",
"distance_km": 107.5,
"line_id": "neptune:mc",
"is_close": true,
"visual_strength": "high",
"source_focuses": [
"career"
]
}
],
"primary_parans": [
{
"id": "mars:dsc:true_node:mc:49.281",
"body_a": "mars",
"event_a": "dsc",
"body_b": "true_node",
"event_b": "mc",
"distance_km": 193.9,
"is_close": false,
"visual_strength": "medium",
"source_focuses": [
"career"
]
}
]
},
"match_tier": "strong",
"rank": 4,
"score": 118.88,
"signal_strength": "strong",
"summary": "Mercury MC is the strongest supportive line for this career search, with 3 nearby contributing line(s)."
},
{
"city": {
"name": "Lillers",
"country": "FR",
"state": "Hauts-de-France",
"lat": 50.56345,
"lng": 2.48042,
"timezone": "Europe/Paris",
"population": 10104
},
"city_visual_explanation": {
"explanation_mode": "line_plus_paran",
"map_line_ids": [
"mercury:mc",
"neptune:mc",
"sun:mc",
"mars:dsc",
"true_node:mc",
"venus:asc",
"pluto:mc"
],
"primary_lines": [
{
"body": "mercury",
"angle": "mc",
"distance_km": 3.9,
"line_id": "mercury:mc",
"is_close": true,
"visual_strength": "high",
"source_focuses": [
"career"
]
},
{
"body": "neptune",
"angle": "mc",
"distance_km": 102.4,
"line_id": "neptune:mc",
"is_close": true,
"visual_strength": "high",
"source_focuses": [
"career"
]
}
],
"primary_parans": [
{
"id": "mars:dsc:true_node:mc:49.281",
"body_a": "mars",
"event_a": "dsc",
"body_b": "true_node",
"event_b": "mc",
"distance_km": 142.8,
"is_close": false,
"visual_strength": "medium",
"source_focuses": [
"career"
]
}
]
},
"match_tier": "strong",
"rank": 5,
"score": 118.82,
"signal_strength": "strong",
"summary": "Mercury MC is the strongest supportive line for this career search, with 3 nearby contributing line(s)."
}
],
"map": {
"chart_families": [
{
"body": "mars",
"id": "mars:horizon",
"kind": "horizon_cycle",
"member_line_ids": [
"mars:asc",
"mars:dsc"
]
},
{
"body": "venus",
"id": "venus:horizon",
"kind": "horizon_cycle",
"member_line_ids": [
"venus:asc",
"venus:dsc"
]
}
],
"lines": [
{
"angle": "mc",
"body": "mercury",
"id": "mercury:mc"
},
{
"angle": "mc",
"body": "neptune",
"id": "neptune:mc"
},
{
"angle": "mc",
"body": "sun",
"id": "sun:mc"
},
{
"angle": "dsc",
"body": "mars",
"chart_family_id": "mars:horizon",
"id": "mars:dsc"
},
{
"angle": "mc",
"body": "true_node",
"id": "true_node:mc"
},
{
"angle": "asc",
"body": "venus",
"chart_family_id": "venus:horizon",
"id": "venus:asc"
},
{
"angle": "mc",
"body": "pluto",
"id": "pluto:mc"
}
]
}
}Объяснение выбранного города
mercury MC
high9.0 км от городского маркера. Фокус: career.
neptune MC
high116.8 км от городского маркера. Фокус: career.
Паран: mars DSC / true_node MC
68.9 км от города. Это остается в блоке объяснений, поэтому на карте можно указать поддерживающую горячую точку без сканирования глобальной инвентаризации.
Паран: venus ASC / pluto MC
112.3 км от города. Это остается в блоке объяснений, поэтому на карте можно указать поддерживающую горячую точку без сканирования глобальной инвентаризации.
создайте полную астрокартографическую карту в MapLibre.
Этот встроенный пример отображает контрактные линии астрокартографии непосредственно в MapLibre, используя ту же геометрию WGS84 GeoJSON, которую API возвращает клиентам.
Демо-версия MapLibre
Полезная нагрузка астрокартографических линий отображается непосредственно на карте мира.
Почему это важно
Конечная точка линии возвращает плотные geodesic-style, map-ready WGS84 GeoJSON. ASC и DSC выступают в виде изогнутых последовательностей координат, MC и IC выступают в одном и том же геометрическом контракте, а пересечения являются точками GeoJSON по запросу. Если возможно, `chart_families` обеспечивает непрерывные циклы горизонта AC/DC, чтобы средства визуализации диаграмм могли поддерживать непрерывность кривых без продолжения путей client-side.
Геометрия: geojson, WGS84
Фрагмент исходного кода MapLibre
import maplibregl from "maplibre-gl";
const horizonFamilies = (linesResponse.chart_families ?? []).map((family) => ({
type: "Feature",
properties: {
id: family.id,
body: family.body,
stroke: "#cbd5e1",
},
geometry: family.geometry,
}));
const lineFeatures = linesResponse.lines.map((line) => ({
type: "Feature",
properties: {
id: line.id,
body: line.body,
angle: line.angle,
stroke:
line.angle === "mc" ? "#fbbf24" :
line.angle === "ic" ? "#34d399" :
line.angle === "asc" ? "#38bdf8" :
"#fb7185",
},
geometry: line.geometry,
}));
map.on("load", () => {
map.addSource("astro-horizon-families", {
type: "geojson",
data: {
type: "FeatureCollection",
features: horizonFamilies,
},
});
map.addLayer({
id: "astro-horizon-families",
type: "line",
source: "astro-horizon-families",
paint: {
"line-color": ["get", "stroke"],
"line-width": 1.8,
"line-opacity": 0.52,
},
});
map.addSource("astro-lines", {
type: "geojson",
data: {
type: "FeatureCollection",
features: lineFeatures,
},
});
map.addLayer({
id: "astro-lines",
type: "line",
source: "astro-lines",
paint: {
"line-color": ["get", "stroke"],
"line-width": 2.5,
"line-opacity": 0.9,
},
});
});Часто задаваемые вопросы по астрокартографии API
Требуют ли конечные точки астрокартографии точного времени рождения?
Да. Конечные точки общедоступной астрокартографии представляют собой расчеты по времени. Требуется точное время рождения, поскольку углы, угловые линии и выходные данные диаграммы перемещения зависят от точного местного момента рождения.
В чем разница между линиями, паранами и перестановками?
Линии возвращают угловую геометрию world-map, параны возвращают горячие точки планетарных событий crossing-style, а перемещение возвращает полную переданную карту плюс преобразование для одного города. Они решают, какие разные виды продукции существуют.
Когда мне следует использовать city-check вместо рекомендации?
Используйте city-check, если назначение пункта уже известно и вам нужна разбивка разбивки multi-focus. Воспользуйтесь рекомендациями, если хотите, чтобы API ранжировал город по выбранному фокусу в области поиска.
Являются ли возвращенные линии геодезическими и готовы ли они к рендерингу карты?
Да. Полезная нагрузка линии извлекает плотную геометрию map-ready WGS84 GeoJSON, которую можно рисовать непосредственно в таких инструментах, как MapLibre. ASC и DSC остаются в виде криволинейных постоянностей координат, MC и IC используют один и тот же геометрический контракт, и клиенту не нужно обеспечивать путь.
Отправляйте продукты для переезда и размещения быстрее
Получите ключ API, начните с оценок городов и расширяйте возможности карты, рейтингов и перемещаемых диаграмм по мере роста вашего продукта.
Для бесплатного уровня кредитная карта не требуется.