Retour aux docs
Générateur de cartes SVG/PNG

Générateur de cartes SVG/PNG

POST/api/v1/natal/chart/

Générez de belles visualisations de thèmes natals personnalisables en SVG ou PNG haute résolution. Controle complet des couleurs, tailles, corps celestes et styles visuels.

L'heure de naissance inconnue est prise en charge avec time_known: false ; les maisons et les angles sont omis dans ce mode.

Endpoints SVG associés

Utilisez l'endpoint natal a roue simple pour une personne. Pour les cartes relationnelles, la famille SVG inclut aussi les variantes composite midpoint et synastrie.

Carte SVG composite
Composite midpoint en roue unique construit a partir de deux personnes.
Carte SVG de synastrie
Carte de compatibilité à deux roues avec les deux personnes superposées.

Exemple de sortie

Exemple natal standard
Exemple de thème natal généré par l’API
Exemple de style français
Thème natal de style français génère par l'API avec le thème SVG par défaut

SVG reel génère par l'API avec le thème par défaut et chart_config.french_style: true.

Superposition de forme d'horoscope

Définissez chart_config.show_horoscope_shape sur true pour détecter la forme de distribution du thème a partir des 10 planètes uniquement. Lorsqu'une forme est détectée, le maillage central d'aspects est masque et remplace par une geometrie pleine lisible.

Thème natal SVG avec superposition de forme bucket rendue dans le disque central

Sortie API reelle

Ce SVG a ete génère par POST /api/v1/natal/chart/ avec une forme Bucket détectée. La réponse inclut data-key="horoscope_shape.bucket" et des métadonnées JSON optionnelles dans freeastroapi-horoscope-shape.

Utilisez ces champs chart_config

show_horoscope_shapehoroscope_shape_stylehoroscope_shape_colorhoroscope_shape_labelembed_horoscope_shape_metadata

Formes prises en charge et réglés de détection

Bundle
Les 10 planètes tiennent dans un arc occupe de 120°.
Bucket
Une planète anse, ou un petit cluster anse de deux planètes, se situe hors du groupe principal. Les autres planètes doivent tenir dans 181°, sans largeur minimale de cluster ; le cluster anse ne doit pas depasser 15°, l'anse doit etre a au moins 30° du groupe principal, et le thème complet doit depasser un arc unique de 180°.
Bowl
Les 10 planètes occupent un arc continu supérieur a 120° et inférieur ou egal a 210°, avec un grand vide d'au moins 150°. Si une planète ou un petit cluster de deux planètes se detache comme anse, Bucket prend la priorite.
See-Saw
Deux clusters séparés, avec le plus grand vide d'au moins 90° et le deuxieme plus grand vide d'au moins 50°.
Locomotive
Les planètes occupent plus de 210° et au plus 260°, laissant un vide directeur de 100° jusqu'a, sans l'inclure, 150°.
Splash
Distribution large sans grand vide : les deux plus grands espaces interplanetaires sont tous deux inferieurs a 60°.

La détection de forme utilise uniquement Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune et Pluto. Les angles, noeuds, asteroides, Lilith, Chiron et lots n'affectent pas la forme détectée.

Superposition de configurations d'aspects

Utilisez chart_config.show_pattern_overlays pour rendre les structures d'aspects détectées directement sur la carte. Les superpositions de configurations gardent le cercle d'aspects normal visible et ajoutent des sous-couches, traits, libellés et attributs SVG stables pour l'interaction avec l'interface.

Thème natal SVG avec une seule superposition filtree de configuration d'aspect Grand Cross

Sortie API reelle

Ce SVG montre uniquement une superposition Grand Cross filtree, correspondant a une configuration avec pattern_overlay_types défini sur grand_cross et pattern_overlay_max_items défini sur 1. Les éléments rendus incluent des attributs comme data-pattern-type, data-bodies et data-key="pattern.*" afin que votre UI puisse surligner, filtrer ou expliquer la structure sélectionnée.

Utilisez ces champs chart_config

show_pattern_overlayspattern_overlay_typespattern_overlay_stylepattern_overlay_labelspattern_overlay_max_itemsembed_pattern_metadata

Les structures rendues prises en charge incluent grand_trine, t_square, yod, kite, grand_cross, minor_grand_trine, wedge, mystic_rectangle, cradle, castle, grand_sextile et stellium.

Galerie d'aperçus de thèmes

Trois thèmes de cartes de style production rendus depuis des préréglages API. Les images sont des aperçus WebP optimises pour montrer la qualité et la performance.

Aperçu du thème de carte astrologique Classic Clarity

Classic Clarity

Profil de consultation equilibre avec hierarchie de lignes retenue.

Aperçu du thème de carte astrologique Navy Gold

Navy Gold

Palette sombre premium avec forte lisibilité symbolique.

Aperçu du thème de carte astrologique Slate Mineral

Slate Mineral

Palette neutre gris froid pour lecture technique du thème.

Préréglages de thèmes editoriaux (couleurs seulement)

Ces préréglages utilisent uniquement les paramètres de requête existants. Ils ne necessitent aucun changement interne du moteur de rendu.

Ivory Ink

Palette editoriale claire avec tons papier chauds et contraste d'encre retenu.

{
  "name": "Theme: Ivory Ink",
  "year": 1990,
  "month": 5,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "London",
  "lat": 51.5,
  "lng": -0.12,
  "tz_str": "UTC",
  "format": "png",
  "theme_type": "light",
  "chart_config": {
    "chart_background": "#F6F1E8",
    "custom_planet_color": "#1E1B18",
    "custom_sign_color": "#6A5B48",
    "custom_house_color": "#3E362C",
    "custom_sign_bg_color": "#EFE4D3",
    "custom_house_bg_color": "#FAF6EE",
    "sign_line_color": "#3A3128",
    "house_line_color": "#8C7C68",
    "aspect_conjunction_color": "#2F2A24",
    "aspect_opposition_color": "#A1362A",
    "aspect_trine_color": "#1F4E79",
    "aspect_square_color": "#8F2B23",
    "aspect_sextile_color": "#355E8D",
    "aspect_quincunx_color": "#4D6A3A"
  }
}

Navy Gold

Palette sombre premium avec base navy et symboles/lignes or assourdis.

{
  "name": "Theme: Navy Gold",
  "year": 1990,
  "month": 5,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "London",
  "lat": 51.5,
  "lng": -0.12,
  "tz_str": "UTC",
  "format": "png",
  "theme_type": "dark",
  "chart_config": {
    "chart_background": "#0D1B2A",
    "custom_planet_color": "#E7D3A5",
    "custom_sign_color": "#C9B27C",
    "custom_house_color": "#A7B8C9",
    "custom_sign_bg_color": "#14263B",
    "custom_house_bg_color": "#102034",
    "sign_line_color": "#D8C08A",
    "house_line_color": "#60758D",
    "aspect_conjunction_color": "#D6DCE5",
    "aspect_opposition_color": "#E06C5B",
    "aspect_trine_color": "#6EA8FF",
    "aspect_square_color": "#C85C53",
    "aspect_sextile_color": "#7EB7FF",
    "aspect_quincunx_color": "#7EBB8D"
  }
}

Slate Mineral

Palette neutre gris froid avec accents d'aspects bleu-vert mineral.

{
  "name": "Theme: Slate Mineral",
  "year": 1990,
  "month": 5,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "London",
  "lat": 51.5,
  "lng": -0.12,
  "tz_str": "UTC",
  "format": "png",
  "theme_type": "light",
  "chart_config": {
    "chart_background": "#E9EDF1",
    "custom_planet_color": "#22313F",
    "custom_sign_color": "#3F5D73",
    "custom_house_color": "#4D5B66",
    "custom_sign_bg_color": "#DCE4EA",
    "custom_house_bg_color": "#EEF2F6",
    "sign_line_color": "#2F3D49",
    "house_line_color": "#7D8C98",
    "aspect_conjunction_color": "#3A4955",
    "aspect_opposition_color": "#B04A3B",
    "aspect_trine_color": "#2B6F9C",
    "aspect_square_color": "#9A3E33",
    "aspect_sextile_color": "#3D7FAF",
    "aspect_quincunx_color": "#4A7A63"
  }
}

Classic Clarity

Base de consultation professionnelle avec hierarchie de lignes retenue et maillage d'aspects plus net.

{
  "name": "Theme: Classic Clarity",
  "year": 1990,
  "month": 5,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "London",
  "lat": 51.5,
  "lng": -0.12,
  "tz_str": "UTC",
  "format": "png",
  "theme_type": "light",
  "chart_config": {
    "sign_line_width": 1.6,
    "house_line_width": 0.9,
    "asc_line_width": 2.4,
    "dsc_line_width": 2.4,
    "mc_line_width": 2.4,
    "ic_line_width": 2.4,
    "sign_ring_inner_width": 1.2,
    "sign_ring_outer_width": 1.6,
    "house_ring_inner_width": 0.8,
    "house_ring_outer_width": 0.9,
    "sign_tick_width": 0.45,
    "aspect_conjunction_width": 2.2,
    "aspect_opposition_width": 2.2,
    "aspect_trine_width": 1.8,
    "aspect_square_width": 2.0,
    "aspect_sextile_width": 1.5,
    "aspect_quincunx_width": 1.3
  }
}

Dense Analysis

Profil technique avance avec axes, anneaux et aspects plus forts pour lecture détaillée.

{
  "name": "Theme: Dense Analysis",
  "year": 1990,
  "month": 5,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "London",
  "lat": 51.5,
  "lng": -0.12,
  "tz_str": "UTC",
  "format": "png",
  "theme_type": "light",
  "chart_config": {
    "sign_line_width": 2.6,
    "house_line_width": 1.35,
    "asc_line_width": 3.6,
    "dsc_line_width": 3.6,
    "mc_line_width": 3.6,
    "ic_line_width": 3.6,
    "sign_ring_inner_width": 1.9,
    "sign_ring_outer_width": 2.6,
    "house_ring_inner_width": 1.2,
    "house_ring_outer_width": 1.3,
    "sign_tick_width": 0.62,
    "aspect_conjunction_width": 3.2,
    "aspect_opposition_width": 3.2,
    "aspect_trine_width": 2.6,
    "aspect_square_width": 2.9,
    "aspect_sextile_width": 2.3,
    "aspect_quincunx_width": 2.0
  }
}

URL complète

https://api.freeastroapi.com/api/v1/natal/chart/

Paramètres de base

Paramètre
name
Type
string
Requis
Oui
Défaut
-
Description
Nom du sujet (affiche dans les métadonnées)
Paramètre
year
Type
integer
Requis
Oui
Défaut
-
Description
Année de naissance (ex. 1990)
Paramètre
month
Type
integer
Requis
Oui
Défaut
-
Description
Mois de naissance (1-12)
Paramètre
day
Type
integer
Requis
Oui
Défaut
-
Description
Jour de naissance (1-31)
Paramètre
hour
Type
integer
Requis
Oui
Défaut
-
Description
Heure de naissance (0-23, format 24 h)
Paramètre
minute
Type
integer
Requis
Oui
Défaut
-
Description
Minute de naissance (0-59)
Paramètre
time_known
Type
boolean
Requis
Non
Défaut
true
Description
Définir sur false lorsque l'heure de naissance est inconnue. Dans ce mode, les maisons et angles sont omis de la carte.
Paramètre
city
Type
string
Requis
Non
Défaut
-
Description
Nom de ville. Optionnel lorsque lat/lng sont fournis ; utilise pour la recherche de coordonnées lorsqu'ils sont omis.
Paramètre
lat
Type
float
Requis
Non
Défaut
auto
Description
Latitude (-90 à 90). Requise avec lng si city est omis.
Paramètre
lng
Type
float
Requis
Non
Défaut
auto
Description
Longitude (-180 à 180). Requise avec lat si city est omis.
Paramètre
tz_str
Type
string
Requis
Non
Défaut
AUTO
Description
Fuseau horaire (ex. 'Europe/Paris' ou 'AUTO')
Paramètre
house_system
Type
string
Requis
Non
Défaut
placidus
Description
placidus, whole_sign, equal, koch, etc.
Paramètre
zodiac_type
Type
string
Requis
Non
Défaut
tropical
Description
tropical ou sidereal
Paramètre
sidereal_ayanamsa
Type
string
Requis
Non
Défaut
lahiri
Description
lahiri, raman, kp, etc. (sidereal uniquement)
Paramètre
orb_settings
Type
object
Requis
Non
Défaut
7/6/6/6/5/0
Description
Surcharges partielles des orbes de détection, en degrés. Les mêmes valeurs déterminent les lignes d'aspect dessinées dans le SVG. Les valeurs par défaut sont conjunction 7, opposition/trine/square 6, sextile 5 et quincunx 0 (ou 3 avec include_minor_aspects=true). Les noms ne sont pas sensibles à la casse, les valeurs vont de 0 à 30, et 0 désactive le type d'aspect.

Paramètres de sortie de carte

Paramètre
format
Type
string
Requis
Non
Défaut
svg
Description
Format de sortie : 'svg' ou 'png'
Paramètre
size
Type
integer
Requis
Non
Défaut
700
Description
Largeur/hauteur de la carte en pixels
Paramètre
theme_type
Type
string
Requis
Non
Défaut
light
Description
Thème : 'light', 'dark' ou 'mono'
Paramètre
png_quality_scale
Type
float
Requis
Non
Défaut
2.0
Description
Multiplicateur de résolution PNG (1.0-5.0)
Paramètre
show_metadata
Type
boolean
Requis
Non
Défaut
true
Description
Afficher le bloc de métadonnées (nom, date, lieu)
Paramètre
show_lilith_variants
Type
boolean
Requis
Non
Défaut
false
Description
Rend la paire de Lune noire localisee. lang='fr' affiche la Lune Noire Corrigée (C) et la Lune Noire Vraie (V) ; lang='en' affiche Mean Lilith (M) et True Lilith (T).
Paramètre
display_settings
Type
object
Requis
Non
Défaut
{}
Description
Options de visibilité par corps pour planètes, angles et points optionnels.
Paramètre
chart_config
Type
object
Requis
Non
Défaut
{}
Description
Surcharges avancées de style visuel et de mise en page. Voir la section de configuration de carte ci-dessous pour les champs pris en charge.

Étoiles fixes

Les étoiles fixes demandees sur les SVG de carte sont rendues dans la même roue de corps que les planètes et points, avec un label a trois lettres comme Reg ou Ald. Les lignes d'aspects sont optionnelles via chart_config.show_fixed_star_aspects et se limitent par défaut aux conjonctions serrees.

Paramètre
fixed_stars
Type
array<string>
Requis
Non
Défaut
[]
Description
Sélecteur d'étoiles fixes rendu dans la roue des corps. Accepte des ids de packs comme royal_4 et behenian_20, des noms exacts comme Spica ou Regulus, ou all pour l'ensemble complet par défaut.
Paramètre
chart_config.fixed_star_color
Type
string
Requis
Non
Défaut
theme points color
Description
Couleur des libellés, connecteurs et lignes d'aspects d'étoiles fixes activées.
Paramètre
chart_config.show_fixed_star_aspects
Type
boolean
Requis
Non
Défaut
false
Description
Active les lignes d'aspects d'étoiles fixes.
Paramètre
chart_config.fixed_star_aspect_types
Type
array<string>
Requis
Non
Défaut
['conjunction']
Description
Types d'aspects a dessiner pour les étoiles fixes. Prend en charge conjunction, opposition, trine, square, sextile, quincunx.
Paramètre
chart_config.fixed_star_aspect_orb
Type
float
Requis
Non
Défaut
1.0
Description
Orbe en degrés pour les aspects d'étoiles fixes.

Les 20 etoiles classiques/Beheniennes

La liste complète des étoiles fixes importantes pour les flux d'astrologie traditionnelle.

"fixed_stars": ["behenian_20"]

Les 4 etoiles royales

Regulus, Aldebaran, Antares et Fomalhaut.

"fixed_stars": ["royal_4"]
{
  "name": "Natal Chart with Royal Fixed Stars",
  "year": 1990,
  "month": 5,
  "day": 15,
  "hour": 14,
  "minute": 30,
  "city": "London",
  "lat": 51.5,
  "lng": -0.12,
  "tz_str": "UTC",
  "format": "svg",
  "theme_type": "light",
  "fixed_stars": ["royal_4"],
  "chart_config": {
    "degree_label_format": "minutes",
    "show_planet_connectors": true,
    "show_fixed_star_aspects": true,
    "fixed_star_aspect_types": ["conjunction"],
    "fixed_star_aspect_orb": 1.0,
    "fixed_star_color": "#A16207"
  }
}

Paramètres d'affichage (objet display_settings)

Controlez les corps celestes qui apparaissent sur la carte :

Paramètre
chiron_visible_door
Type
boolean
Requis
Non
Défaut
false
Description
Afficher la Porte Visible de Chiron (PV), le point opposé à PI.
Paramètre
chiron_invisible_door
Type
boolean
Requis
Non
Défaut
false
Description
Afficher la Porte Invisible de Chiron (PI), le mi-point zodiacal orienté d’Uranus vers Saturne.
Paramètre
sun
Type
boolean
Requis
Non
Défaut
true
Description
Afficher le Soleil
Paramètre
moon
Type
boolean
Requis
Non
Défaut
true
Description
Afficher la Lune
Paramètre
mercury
Type
boolean
Requis
Non
Défaut
true
Description
Afficher Mercure
Paramètre
venus
Type
boolean
Requis
Non
Défaut
true
Description
Afficher Venus
Paramètre
mars
Type
boolean
Requis
Non
Défaut
true
Description
Afficher Mars
Paramètre
jupiter
Type
boolean
Requis
Non
Défaut
true
Description
Afficher Jupiter
Paramètre
saturn
Type
boolean
Requis
Non
Défaut
true
Description
Afficher Saturne
Paramètre
uranus
Type
boolean
Requis
Non
Défaut
true
Description
Afficher Uranus
Paramètre
neptune
Type
boolean
Requis
Non
Défaut
true
Description
Afficher Neptune
Paramètre
pluto
Type
boolean
Requis
Non
Défaut
true
Description
Afficher Pluton
Paramètre
north_node
Type
boolean
Requis
Non
Défaut
true
Description
Afficher le noeud nord
Paramètre
south_node
Type
boolean
Requis
Non
Défaut
false
Description
Afficher le noeud sud
Paramètre
chiron
Type
boolean
Requis
Non
Défaut
false
Description
Afficher Chiron
Paramètre
lilith
Type
boolean
Requis
Non
Défaut
false
Description
Afficher la Lune noire moyenne (préférée ; alias : mean_lilith)
Paramètre
true_lilith
Type
boolean
Requis
Non
Défaut
false
Description
Afficher la Lune noire vraie (oscillante)
Paramètre
corrected_lilith
Type
boolean
Requis
Non
Défaut
false
Description
Afficher la Lune noire corrigée. Préférez show_lilith_variants pour obtenir automatiquement la paire C/V ou M/T localisée.
Paramètre
eris
Type
boolean
Requis
Non
Défaut
false
Description
Afficher Eris
Paramètre
eros
Type
boolean
Requis
Non
Défaut
false
Description
Afficher Eros
Paramètre
ceres
Type
boolean
Requis
Non
Défaut
false
Description
Afficher Ceres
Paramètre
pallas
Type
boolean
Requis
Non
Défaut
false
Description
Afficher Pallas
Paramètre
juno
Type
boolean
Requis
Non
Défaut
false
Description
Afficher Juno
Paramètre
vesta
Type
boolean
Requis
Non
Défaut
false
Description
Afficher Vesta
Paramètre
asc
Type
boolean
Requis
Non
Défaut
true
Description
Afficher l'Ascendant
Paramètre
ic
Type
boolean
Requis
Non
Défaut
false
Description
Afficher l'IC
Paramètre
dsc
Type
boolean
Requis
Non
Défaut
false
Description
Afficher le Descendant
Paramètre
mc
Type
boolean
Requis
Non
Défaut
true
Description
Afficher le MC
Paramètre
part_of_fortune
Type
boolean
Requis
Non
Défaut
false
Description
Afficher la Part de Fortune (lot arabe)

Configuration de carte (objet chart_config)

Ajustez finement l'apparence visuelle de la carte :

Paramètre
pattern_overlay_respects_aspect_exclusions
Type
boolean
Requis
Non
Défaut
false
Description
Avec true, ne pas sélectionner ni dessiner une configuration nécessitant une relation masquée par aspect_excluded_bodies. false préserve le comportement existant ; les métadonnées intégrées incluent un avertissement lorsqu’une configuration concernée est sélectionnée. Les corps masqués sont toujours exclus de la détection.
Paramètre
show_synastry_inner_planet_guides
Type
boolean
Requis
Non
Défaut
false
Description
Pour les planètes de la roue intérieure de synastrie, tracer des guides radiaux en pointillés entre leurs repères de longitude sur l’anneau séparateur et le cercle intérieur des signes.
Paramètre
avoid_angle_label_collisions
Type
boolean
Requis
Non
Défaut
true
Description
Maintenir les planètes et points mobiles à distance des libellés d’angles visibles. Utilisez false pour exclure ces libellés du placement anticollision.
Paramètre
angle_label_style
Type
string
Requis
Non
Défaut
international
Description
Convention des libellés d’angles : "international" = ASC/DSC/IC/MC, "french" = AS/DS/FC/MC ou "astrocom" = AS/DS/IC/MC.
Paramètre
asc_label_radius_offset
Type
float
Requis
Non
Défaut
null
Description
Décalage radial du libellé ASC, en pixels. Disponible aussi pour dsc_label_radius_offset, mc_label_radius_offset et ic_label_radius_offset.
Paramètre
angle_label_radius_offset
Type
float
Requis
Non
Défaut
0
Description
Décalage radial commun des libellés d’angles, en pixels. Les valeurs positives déplacent les libellés vers l’extérieur ; les valeurs négatives vers l’intérieur.
Paramètre
decan_background_opacity
Type
float
Requis
Non
Défaut
0.08
Description
Intensité de la teinte alternée du fond des décans en l’absence de remplissage uniforme. Plage autorisée : 0-1.
Paramètre
decan_background_color
Type
string
Requis
Non
Défaut
null
Description
Remplissage uniforme facultatif de la bande des décans. Si omis, les faces voisines alternent légèrement leur teinte selon le thème.
Paramètre
decan_separator_color
Type
string
Requis
Non
Défaut
null
Description
Couleur indépendante des séparateurs radiaux des décans. Utilise decan_line_color si omise.
Paramètre
decan_separator_width
Type
float
Requis
Non
Défaut
null
Description
Épaisseur indépendante des 36 séparateurs radiaux de dix degrés. Utilise decan_line_width si omise ; 0 masque les séparateurs.
Paramètre
decan_ring_line_color
Type
string
Requis
Non
Défaut
null
Description
Couleur indépendante des cercles intérieur et extérieur des décans. Utilise decan_line_color si omise.
Paramètre
decan_ring_line_width
Type
float
Requis
Non
Défaut
null
Description
Épaisseur indépendante des cercles intérieur et extérieur des décans. Utilise decan_line_width si omise ; 0 masque les deux cercles.
Paramètre
decan_line_color
Type
string
Requis
Non
Défaut
null
Description
Couleur commune de repli des cercles et séparateurs radiaux des décans, conservée pour compatibilité.
Paramètre
decan_line_width
Type
float
Requis
Non
Défaut
0.8
Description
Épaisseur commune de repli des cercles et séparateurs radiaux des décans, conservée pour compatibilité. Plage autorisée : 0-10.
Paramètre
decan_symbol_color
Type
string
Requis
Non
Défaut
null
Description
Couleur facultative des glyphes des maîtres. Si omise, le rendu utilise une couleur sombre adaptée au thème (gris anthracite #2c3237 sur le fond clair par défaut).
Paramètre
decan_symbol_stroke_width
Type
float
Requis
Non
Défaut
1.2
Description
Épaisseur du trait des glyphes des maîtres planétaires. Plage autorisée : 0-10.
Paramètre
decan_symbol_scale
Type
float
Requis
Non
Défaut
0.14
Description
Échelle des glyphes des maîtres planétaires. Valeur strictement supérieure à 0 et inférieure ou égale à 1.5.
Paramètre
decan_ring_thickness_fraction
Type
float
Requis
Non
Défaut
0.04
Description
Épaisseur radiale de la bande des décans, en fraction du rayon du thème. Valeur strictement supérieure à 0 et inférieure ou égale à 0.2.
Paramètre
decan_system
Type
string
Requis
Non
Défaut
chaldean
Description
Système de maîtres : "chaldean" ou son alias explicite "traditional_chaldean" pour les sept planètes classiques, ou "modern_triplicity" pour inclure Uranus, Neptune et Pluton.
Paramètre
show_decans
Type
boolean
Requis
Non
Défaut
false
Description
Afficher un anneau intérieur facultatif de 36 décans de dix degrés. Disponible dans les mises en page standard et française.
Paramètre
sign_ring_thickness_fraction
Type
float
Requis
Non
Défaut
0.16
Description
Épaisseur de l'anneau des signes (0.0-1.0)
Paramètre
house_ring_thickness_fraction
Type
float
Requis
Non
Défaut
0.05
Description
Épaisseur de l'anneau des maisons (0.0-1.0)
Paramètre
center_disk_fraction
Type
float
Requis
Non
Défaut
0.45
Description
Rayon du disque central (0.0-1.0)
Paramètre
planet_symbol_scale
Type
float
Requis
Non
Défaut
0.35
Description
Multiplicateur de taille des symboles planétaires
Paramètre
planet_spacing_scale
Type
float
Requis
Non
Défaut
auto
Description
Multiplicateur applique à l'espacement angulaire des glyphes planétaires. Si omis, l'espacement augmente automatiquement lorsque planet_symbol_scale depasse la valeur par défaut.
Paramètre
planet_color_mode
Type
"body" | "sign"
Requis
Non
Défaut
body
Description
Source de couleur des glyphes de planètes et de points hors angles. "body" utilise la palette propre a chaque corps ; "sign" reprend la couleur élémentaire du signe occupe. Les couleurs planétaires personnalisées restent prioritaires.
Paramètre
sign_symbol_scale
Type
float
Requis
Non
Défaut
0.6
Description
Multiplicateur de taille des symboles de signes
Paramètre
house_number_scale
Type
float
Requis
Non
Défaut
0.35
Description
Multiplicateur de taille des numeros de maisons
Paramètre
chart_background
Type
string
Requis
Non
Défaut
null
Description
Surcharge de couleur de fond (hex)
Paramètre
aspect_circle_background
Type
string
Requis
Non
Défaut
null
Description
Couleur de remplissage du cercle/disque central des aspects. Par défaut, utilise chart_background ou le fond du thème actif.
Paramètre
custom_planet_color
Type
string
Requis
Non
Défaut
null
Description
Remplace toutes les couleurs des planètes (hex)
Paramètre
custom_sign_color
Type
string
Requis
Non
Défaut
null
Description
Remplace toutes les couleurs des symboles de signes (hex)
Paramètre
custom_house_color
Type
string
Requis
Non
Défaut
null
Description
Remplace toutes les couleurs des numeros de maisons (hex)
Paramètre
degree_label_color
Type
string
Requis
Non
Défaut
null
Description
Remplace la couleur du texte des libellés degre/minute des planètes (hex ou couleur CSS)
Paramètre
angle_label_color
Type
string
Requis
Non
Défaut
null
Description
Couleur de repli pour tous les libellés de glyphes ASC/DSC/MC/IC.
Paramètre
asc_label_color
Type
string
Requis
Non
Défaut
null
Description
Couleur du label de glyphe ASC. Aussi disponible pour dsc_label_color, mc_label_color et ic_label_color.
Paramètre
angle_label_scale
Type
float
Requis
Non
Défaut
null
Description
Multiplicateur d'échelle de repli pour tous les libellés de glyphes ASC/DSC/MC/IC.
Paramètre
asc_label_scale
Type
float
Requis
Non
Défaut
null
Description
Multiplicateur d'échelle du label de glyphe ASC. Aussi disponible pour dsc_label_scale, mc_label_scale et ic_label_scale.
Paramètre
angle_marker_style
Type
string
Requis
Non
Défaut
glyph
Description
Rendu des marqueurs d'angles : "glyph" conserve les glyphes d'abreviation ASC/DSC/MC/IC ; "french_arrow" dessine des fleches d'axes ASC/MC de style français à l'extérieur de l'anneau des signes.
Paramètre
angle_line_span
Type
string
Requis
Non
Défaut
wheel
Description
Portee des lignes d'axes d'angles : "wheel" garde les lignes ASC/DSC et MC/IC dans la zone de roue par défaut ; "full" etend ces axes sur la carte et s'arrete au bord de l'anneau des signes. Utilisez angle_marker_style "french_arrow" pour des fleches ASC/MC hors anneau.
Paramètre
show_angle_labels_with_french_arrows
Type
boolean
Requis
Non
Défaut
true
Description
Lorsque angle_marker_style vaut "french_arrow", rend les libellés de glyphes ASC/DSC/MC/IC actifs. Définissez false pour les masquer.
Paramètre
planet_connector_clearance
Type
float
Requis
Non
Défaut
auto
Description
Distance en pixels SVG depuis le centre d'un glyphe de planete/point ou sa ligne de connecteur s'arrete. Augmentez-la lorsque de grands glyphes ont besoin de plus d'espace.
Paramètre
custom_sign_bg_color
Type
string
Requis
Non
Défaut
null
Description
Couleur hex unique appliquée aux fonds des 12 anneaux de signes. Lorsqu'elle est définie, les fonds de signes sont activés automatiquement.
Paramètre
custom_house_bg_color
Type
string
Requis
Non
Défaut
null
Description
Couleur hex unique appliquée aux fonds des 12 anneaux de maisons. Lorsqu'elle est définie, les fonds de maisons sont activés automatiquement.
Paramètre
house_highlights
Type
object
Requis
Non
Défaut
{}
Description
Associé les numeros de maison principale de 1 a 12 a des couleurs de fond, par exemple {"7":"#F59E0B"}. Seuls les secteurs listes sont mis en surbrillance.
Paramètre
house_highlight_opacity
Type
float
Requis
Non
Défaut
0.35
Description
Opacite des couleurs house_highlights avant composition sur le fond de la carte. Plage autorisee : 0-1.
Paramètre
house_highlight_include_planet_zone
Type
boolean
Requis
Non
Défaut
false
Description
Si true, prolonge la couleur de chaque maison sélectionnée dans la zone correspondante des planètes principales.
Paramètre
show_angle_aspects
Type
boolean
Requis
Non
Défaut
true
Description
Inclut les lignes et graduations d'aspects impliquant ASC, DSC, MC ou IC. Définissez false pour conserver les aspects entre planètes tout en laissant visibles les axes et libellés d'angles actifs.
Paramètre
aspect_excluded_bodies
Type
array<string>
Requis
Non
Défaut
[]
Description
Masque les lignes, symboles centraux et graduations SVG d'aspects qui concernent les identifiants listes, sans masquer les corps. Exemple : ["part_of_fortune", "chiron"]. Les noms ne sont pas sensibles a la casse et les alias usuels des angles, noeuds, de Lilith et de la Part de Fortune sont acceptes. Ce filtre visuel s'applique aux deux anneaux d'une bi-roue et ne modifie ni les aspects calcules ni la détection des configurations.
Paramètre
aspect_opacity_by_strength
Type
boolean
Requis
Non
Défaut
true
Description
Si true, l'opacite des lignes et symboles centraux depend de la force de l'orbe. Définissez false pour deux niveaux fixes sans variation liee à l'orbe : 100 % pour conjonction, opposition, trigone, carre et sextile ; 70 % pour les aspects mineurs comme le quinconce. Le multiplicateur global stroke_opacity reste applique.
Paramètre
show_aspect_symbols
Type
boolean
Requis
Non
Défaut
auto
Description
Affiche les glyphes d'aspects au midpoint et les lignes d'aspects séparées autour d'eux. Active par défaut en style français et desactive sinon.
Paramètre
show_pattern_overlays
Type
boolean
Requis
Non
Défaut
false
Description
Superpose les structures et configurations détectées sur le SVG. Les structures prises en charge incluent grand_trine, t_square, yod, kite, grand_cross, minor_grand_trine, wedge, mystic_rectangle, cradle, castle, grand_sextile et stellium.
Paramètre
pattern_overlay_types
Type
array
Requis
Non
Défaut
null
Description
Liste optionnelle de types de superpositions a rendre, par exemple ["grand_trine", "t_square", "stellium"]. Si omise, toutes les superpositions détectées prises en charge peuvent etre rendues jusqu'a pattern_overlay_max_items.
Paramètre
pattern_overlay_style
Type
string
Requis
Non
Défaut
subtle
Description
Intensite de la superposition : "subtle" ou "strong".
Paramètre
pattern_overlay_labels
Type
boolean
Requis
Non
Défaut
false
Description
Affiche des libellés compacts pour les superpositions de configuration rendues.
Paramètre
pattern_overlay_max_items
Type
integer
Requis
Non
Défaut
4
Description
Nombre maximum de superpositions de configuration a dessiner. Les surbrillances de signe/maison de stellium sont séparées et ne comptent pas dans cette limite.
Paramètre
embed_pattern_metadata
Type
boolean
Requis
Non
Défaut
false
Description
Integre les données de superposition détectées dans un élément de métadonnées SVG pour le survol, la legende ou l'interface de sélection en aval.
Paramètre
show_horoscope_shape
Type
boolean
Requis
Non
Défaut
false
Description
Detecte la forme de distribution de la carte avec les 10 planètes seulement et la rend dans le disque central des aspects. Lorsqu'une forme est détectée, les lignes/ticks d'aspects centraux habituels sont masqués pour la lisibilité.
Paramètre
horoscope_shape_style
Type
string
Requis
Non
Défaut
subtle
Description
Intensite de la superposition de forme d'horoscope : "subtle" ou "strong".
Paramètre
horoscope_shape_color
Type
string
Requis
Non
Défaut
#D97706
Description
Couleur SVG utilisée pour toutes les superpositions de forme d'horoscope.
Paramètre
horoscope_shape_label
Type
boolean
Requis
Non
Défaut
true
Description
Affiche un label compact pour la forme détectée, comme Bucket, Bowl, Locomotive, Bundle, Splash ou Seesaw.
Paramètre
embed_horoscope_shape_metadata
Type
boolean
Requis
Non
Défaut
true
Description
Integre les données de forme d'horoscope détectée dans un élément de métadonnées SVG.
Paramètre
show_retrograde_markers
Type
boolean
Requis
Non
Défaut
false
Description
Active les marqueurs rétrogrades sur les libellés de degrés des planètes.
Paramètre
retrograde_marker_style
Type
string
Requis
Non
Défaut
R
Description
Style de marqueur rétrograde lorsque l'option est activée : "R" ou "rx" (℞).
Paramètre
degree_label_format
Type
string
Requis
Non
Défaut
null
Description
Format des libellés de degrés des planètes : "degree" pour les degrés entiers, "decimal" pour les degrés decimaux, ou "minutes" pour les libellés empiles minute + glyphe de signe + degré entier. Si omis, degree_label_precision > 0 conserve l'ancienne mise en page en minutes.
Paramètre
degree_label_precision
Type
integer
Requis
Non
Défaut
0
Description
Nombre de decimales pour degree_label_format="decimal". Plage autorisee : 0-4. Pour compatibilité ascendante, si degree_label_format est omis, les valeurs supérieures a 0 activent la mise en page empilee en minutes.
Paramètre
degree_label_scale
Type
float
Requis
Non
Défaut
0.6
Description
Échelle de base du texte des libellés de degrés des planètes.
Paramètre
degree_label_degree_scale
Type
float
Requis
Non
Défaut
1.0
Description
Échelle du texte des degrés entiers des libellés précis, relative à degree_label_scale.
Paramètre
degree_label_minute_scale
Type
float
Requis
Non
Défaut
1.0
Description
Échelle du texte des minutes des libellés précis, relative à degree_label_scale.
Paramètre
degree_label_sign_scale
Type
float
Requis
Non
Défaut
1.25
Description
Échelle du glyphe de signe zodiacal des libellés précis, relative à degree_label_scale.
Paramètre
degree_label_row_gap
Type
float
Requis
Non
Défaut
1.55
Description
Espacement des libellés précis entre les lignes de degré, signe et minute, relatif à degree_label_scale.
Paramètre
houses_inside_planets
Type
boolean
Requis
Non
Défaut
true
Description
Place les maisons à l'intérieur de l'anneau des planètes
Paramètre
french_style
Type
boolean
Requis
Non
Défaut
false
Description
Mise en page d'horoscope français natal seulement : disque d'aspects dans le bord des signes, maisons à l'extérieur des signes, planètes à l'extérieur des maisons.
Paramètre
french_planet_radius_offset
Type
float
Requis
Non
Défaut
0
Description
Mode français natal seulement. Déplace les glyphes planétaires radialement vers l'extérieur ou l'intérieur sans déplacer les anneaux de maisons/signes.

Mettre des maisons en surbrillance

Associez un numero de maison principale de 1 a 12 a une couleur de fond. Les maisons non listees conservent leur fond normal et plusieurs maisons peuvent utiliser des couleurs differentes. Définissez house_highlight_include_planet_zone sur true pour prolonger chaque surbrillance dans la zone correspondante des planètes principales.

{
  "chart_config": {
    "house_highlights": {
      "7": "#F59E0B"
    },
    "house_highlight_opacity": 0.45,
    "house_highlight_include_planet_zone": true
  }
}

Exemples de format de libellés de degrés

Utilisez degree_label_format: "minutes" pour rendre chaque libellé précis en lignes séparées pour degré, glyphe de signe et minutes. Les exemples ci-dessous sont des sorties PNG générées par le même endpoint en mises en page standard et française.

Thème natal standard en PNG utilisant degree_label_format minutes

Mise en page standard

Les maisons restent à l'intérieur de la bande des planètes ; les libellés précis sont empiles vers le centre de la carte.

{
  "format": "png",
  "theme_type": "light",
  "chart_config": {
    "degree_label_format": "minutes",
    "degree_label_color": "#000000",
    "houses_inside_planets": true
  }
}
Thème natal de style français en PNG utilisant degree_label_format minutes

Mise en page française

Le mode français garde les libellés précis hors angles à l'extérieur des glyphes planétaires, tandis que les libellés d'angles restent compacts.

{
  "format": "png",
  "theme_type": "light",
  "chart_config": {
    "degree_label_format": "minutes",
    "degree_label_color": "#000000",
    "french_style": true,
    "houses_inside_planets": false
  }
}

Exemples de code

curl -X POST "https://api.freeastroapi.com/api/v1/natal/chart/" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
    "name": "John Doe",
    "year": 1990,
    "month": 5,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "time_known": false,
    "lat": 40.7128,
    "lng": -74.006,
    "tz_str": "AUTO",
    "house_system": "placidus",
    "zodiac_type": "tropical",
    "orb_settings": {
        "conjunction": 6,
        "opposition": 6,
        "trine": 5,
        "square": 5,
        "sextile": 3
    },
    "format": "svg",
    "size": 800,
    "theme_type": "light",
    "png_quality_scale": 2.0,
    "show_metadata": true,
    "display_settings": {
        "chiron": true,
        "lilith": true,
        "north_node": true
    },
    "chart_config": {
        "sign_ring_thickness_fraction": 0.16,
        "house_ring_thickness_fraction": 0.05,
        "planet_symbol_scale": 0.35,
        "sign_symbol_scale": 0.6,
        "angle_marker_style": "glyph",
        "angle_line_span": "wheel",
        "french_style": false,
        "french_planet_radius_offset": 0,
        "show_aspect_symbols": true,
        "show_retrograde_markers": true,
        "retrograde_marker_style": "R",
        "degree_label_format": "minutes",
        "custom_planet_color": "#FF5733",
        "aspect_circle_background": "#F8F2FF",
        "show_color_background": false
    }
}' --output chart.svg

Style avance

L'objet chart_config prend en charge un controle granulaire des epaisseurs de lignes, couleurs et styles d'aspects. Les paramètres supplementaires incluent :

Glyphes localisés de la Lune noire

Définissez l'option de premier niveau show_lilith_variants sur true. Avec lang: "fr", la carte affiche la Lune Noire Corrigée (C) et la Lune Noire Vraie (V). Avec lang: "en", elle affiche Mean Lilith (M) et True Lilith (T).

Ajoutez chart_config.planet_color_mode: "sign" pour colorer chaque glyphe selon l'élément du signe zodiacal qu'il occupe. Une couleur personnalisée globale ou propre au corps reste prioritaire. Pour les transits et les révolutions solaires, placez show_lilith_variants dans natal ; pour la synastrie et le composite, placez-la dans l'objet person_a ou person_b concerné.

{
  "lang": "fr",
  "show_lilith_variants": true,
  "chart_config": {
    "planet_color_mode": "sign"
  }
}
  • sign_line_width, sign_line_color
  • house_line_width, house_line_color
  • asc_line_width, asc_line_color (et dsc, mc, ic)
  • asc_label_color, asc_label_scale (et dsc, mc, ic)
  • angle_marker_style défini sur french_arrow pour des fleches d'axes ASC/MC de style français ; les libellés d'angles actifs restent visibles sauf si show_angle_labels_with_french_arrows vaut false
  • angle_line_span défini sur full pour etendre les axes ASC/DSC et MC/IC jusqu'au bord de l'anneau des signes ; utilisez angle_marker_style french_arrow pour des fleches hors anneau
  • planet_connector_clearance pour arreter les lignes de connexion avant les glyphes surdimensionnes
  • planet_color_mode défini sur sign pour reprendre la couleur élémentaire du signe occupé par chaque planète ou point
  • aspect_excluded_bodies pour masquer les aspects de planètes ou points choisis sans masquer leurs glyphes
  • aspect_opacity_by_strength défini sur false pour des niveaux fixes de 100 % pour les aspects majeurs et 70 % pour les aspects mineurs
  • aspect_circle_background pour colorer uniquement le disque central des aspects
  • aspect_conjunction_width, aspect_conjunction_color
  • aspect_opposition_width, aspect_trine_width, etc.

FAQ

Prenez-vous en charge les étoiles fixes ?

Oui. L'endpoint de cartes SVG peut rendre les étoiles fixes prises en charge dans la même roue de corps que les planètes et les points. Utilisez fixed_stars avec des ids de packs comme royal_4 ou behenian_20, des noms exacts d'étoiles fixes, ou all pour l'ensemble complet par défaut.

Quels packs d'étoiles fixes sont disponibles ?

Deux packs prets à l'emploi sont disponibles : behenian_20 pour les 20 étoiles classiques ou Beheniennes, et royal_4 pour Regulus, Aldebaran, Antares et Fomalhaut.

Puis-je sélectionner des étoiles fixes individuelles ?

Oui. Passez les noms exacts pris en charge dans le tableau fixed_stars, par exemple Spica ou Regulus. Le même tableau fixed_stars accepte aussi des ids de packs comme royal_4 et behenian_20.

Les étoiles fixes peuvent-elles afficher des aspects ?

Oui, mais les aspects d'étoiles fixes sont optionnels. Activez chart_config.show_fixed_star_aspects, puis choisissez fixed_star_aspect_types et fixed_star_aspect_orb lorsque vous avez besoin de plus que le flux par défaut de conjonctions serrees.

Puis-je personnaliser la couleur des étoiles fixes ?

Oui. Définissez chart_config.fixed_star_color avec une couleur CSS ou une valeur hex. Cette couleur est utilisée pour les libellés d'étoiles fixes, les connecteurs et les lignes d'aspects d'étoiles fixes activées.

Les étoiles fixes affichent-elles les degrés et libellés de signes ?

Oui. Les étoiles fixes utilisent le même comportement de placement que les autres corps rendus et peuvent afficher degré, signe et minutes lorsque la configuration des libellés de degrés le demande.

Avez-vous un outil pour personnaliser les cartes ?

Oui. Le Chart Designer permet de configurer les couleurs, libellés, epaisseurs de lignes, thèmes et autres options visuelles avant de copier la configuration de requête dans l'API.

Ouvrir Chart Designer

Puis-je personnaliser les couleurs, libellés, aspects et la mise en page ?

Oui. Utilisez chart_config pour les couleurs, fonds, geometrie des anneaux, échelle des glyphes, style des connecteurs, couleurs d'aspects, epaisseurs de lignes, libellés de degrés, marqueurs rétrogrades, mise en page de style français et superpositions de configurations.

Puis-je exporter en PNG aussi bien qu'en SVG ?

Oui. Définissez format sur svg pour une sortie vectorielle ou png pour une sortie raster. Pour PNG, png_quality_scale controle le multiplicateur de résolution de sortie.

Puis-je intégrer le SVG dans mon application ?

Oui. La réponse SVG peut etre intégrée directement dans votre front-end, stockée comme ressource ou convertie dans votre propre chaîne de rendu. Utilisez la réponse API selon les réglés de cache et de sécurité de votre application.

Puis-je mettre en surbrillance une maison précise ?

Oui. Définissez chart_config.house_highlights avec un objet qui associé les numeros de maison de 1 a 12 a des couleurs de fond, par exemple {"7":"#F59E0B"}. Utilisez house_highlight_opacity pour regler l'intensite et house_highlight_include_planet_zone sur true pour prolonger la couleur dans la zone correspondante des planètes principales.

Puis-je masquer les aspects d'une planète ou d'un point précis ?

Oui. Ajoutez des identifiants comme part_of_fortune ou chiron a chart_config.aspect_excluded_bodies. Le corps reste visible, mais les lignes, symboles centraux et graduations d'aspects qui le concernent sont masqués dans le SVG. Ce filtre visuel ne modifie ni les aspects calcules ni la détection des configurations.

Puis-je désactiver la variation d'opacite selon la force de l'aspect ?

Oui. Définissez chart_config.aspect_opacity_by_strength sur false. La conjonction, l'opposition, le trigone, le carre et le sextile utilisent alors une opacite de 100 %, tandis que les aspects mineurs comme le quinconce utilisent 70 %, sans variation liee à l'orbe dans chaque niveau. La valeur globale stroke_opacity continue de multiplier ces niveaux fixes.

Existe-t-il une app iOS qui utilise l'API Chart SVG ?

Oui. AstroLingo est une app iOS d'apprentissage de l'astrologie qui utilise FreeAstroAPI pour générer des thèmes natals et des experiences visuelles autour des cartes. Elle montre comment intégrer les réponses SVG ou PNG dans une interface mobile native.

Decouvrir l'app iOS AstroLingo

Puis-je masquer ou afficher planètes, points et maisons ?

Oui. Utilisez display_settings pour activer ou masquer planètes, noeuds, Lilith, Chiron, asteroides, angles et autres points pris en charge. Lorsque time_known vaut false, les maisons et angles sont omis automatiquement.

Puis-je afficher les rétrogradations ?

Oui. Définissez chart_config.show_retrograde_markers sur true. Vous pouvez aussi choisir le style du marqueur avec chart_config.retrograde_marker_style, en utilisant R ou rx.

Puis-je utiliser cet endpoint pour des cartes avec heure de naissance inconnue ?

Oui. Définissez time_known sur false. La carte affiche toujours les positions planétaires, mais les maisons et les angles sont omis car ils dependent de l'heure de naissance.

Prenez-vous en charge les configurations d'aspects ou les superpositions de forme d'horoscope ?

Oui. chart_config.show_pattern_overlays rend les structures d'aspects détectées, et chart_config.show_horoscope_shape rend la forme de distribution du thème dans le disque central.

Le rendu des étoiles fixes est-il plus lent ?

Les étoiles fixes ne sont calculees et rendues que lorsqu'elles sont demandees. Utilisez un token de pack comme royal_4 ou une courte liste fixed_stars pour garder une carte lisible et limiter le coût de rendu additionnel.

Comment authentifier les requêtes ?

Envoyez votre cle API dans l'en-tete x-api-key avec Content-Type défini sur application/json.

Lire les docs d'authentification

Ou aller pour les SVG de transit, synastrie ou composite ?

Utilisez les endpoints SVG dedies a ces types de cartes. Ils sont documentes séparément de l'endpoint natal de cartes SVG.

Docs SVG de transitsDocs SVG de synastrieDocs SVG composite

Endpoints associés

Thème natal (JSON)

Obtenir les données du thème au format JSON

Transits

Comparer le ciel actuel au thème natal