Retour aux docs

Generateur de cartes SVG/PNG

Generateur de cartes SVG/PNG

POST/api/v1/natal/chart/

Generez de belles visualisations de themes natals personnalisables en SVG ou PNG haute resolution. 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 associes

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 compatibilite a deux roues avec les deux personnes superposees.

Exemple de sortie

Exemple natal standard
Example natal chart generated by the API
Exemple de style francais
Theme natal de style francais genere par l'API avec le theme SVG par defaut

SVG reel genere par l'API avec le theme par defaut et chart_config.french_style: true.

Superposition de forme d'horoscope

Definissez chart_config.show_horoscope_shape sur true pour detecter la forme de distribution du theme a partir des 10 planetes uniquement. Lorsqu'une forme est detectee, le maillage central d'aspects est masque et remplace par une geometrie pleine lisible.

Theme natal SVG avec superposition de forme bucket rendue dans le disque central

Sortie API reelle

Ce SVG a ete genere par POST /api/v1/natal/chart/ avec une forme Bucket detectee. La reponse inclut data-key="horoscope_shape.bucket" et des metadonnees 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 regles de detection

Bundle
Les 10 planetes tiennent dans un arc occupe de 120°.
Bucket
Une planete anse, ou un petit cluster anse de deux planetes, se situe hors du groupe principal. Les autres planetes 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 theme complet doit depasser un arc unique de 180°.
Bowl
Les 10 planetes occupent un arc continu superieur a 120° et inferieur ou egal a 210°, avec un grand vide d'au moins 150°. Si une planete ou un petit cluster de deux planetes se detache comme anse, Bucket prend la priorite.
See-Saw
Deux clusters separes, avec le plus grand vide d'au moins 90° et le deuxieme plus grand vide d'au moins 50°.
Locomotive
Les planetes 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 detection 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 detectee.

Superposition de configurations d'aspects

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

Theme 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 defini sur grand_cross et pattern_overlay_max_items defini sur 1. Les elements 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 selectionnee.

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 themes

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

Aperçu du theme de carte astrologique Classic Clarity

Classic Clarity

Profil de consultation equilibre avec hierarchie de lignes retenue.

Aperçu du theme de carte astrologique Navy Gold

Navy Gold

Palette sombre premium avec forte lisibilite symbolique.

Aperçu du theme de carte astrologique Slate Mineral

Slate Mineral

Palette neutre gris froid pour lecture technique du theme.

Préréglages de themes editoriaux (couleurs seulement)

Ces préréglages utilisent uniquement les parametres de requete 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 detaillee.

{
  "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 complete

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

Parametres de base

Parametre
name
Type
string
Requis
Oui
Defaut
-
Description
Nom du sujet (affiche dans les metadonnees)
Parametre
year
Type
integer
Requis
Oui
Defaut
-
Description
Annee de naissance (ex. 1990)
Parametre
month
Type
integer
Requis
Oui
Defaut
-
Description
Mois de naissance (1-12)
Parametre
day
Type
integer
Requis
Oui
Defaut
-
Description
Jour de naissance (1-31)
Parametre
hour
Type
integer
Requis
Oui
Defaut
-
Description
Heure de naissance (0-23, format 24 h)
Parametre
minute
Type
integer
Requis
Oui
Defaut
-
Description
Minute de naissance (0-59)
Parametre
time_known
Type
boolean
Requis
Non
Defaut
true
Description
Definir sur false lorsque l'heure de naissance est inconnue. Dans ce mode, les maisons et angles sont omis de la carte.
Parametre
city
Type
string
Requis
Non
Defaut
-
Description
Nom de ville. Optionnel lorsque lat/lng sont fournis ; utilise pour la recherche de coordonnees lorsqu'ils sont omis.
Parametre
lat
Type
float
Requis
Non
Defaut
auto
Description
Latitude (-90 a 90). Requise avec lng si city est omis.
Parametre
lng
Type
float
Requis
Non
Defaut
auto
Description
Longitude (-180 a 180). Requise avec lat si city est omis.
Parametre
tz_str
Type
string
Requis
Non
Defaut
AUTO
Description
Fuseau horaire (ex. 'Europe/Paris' ou 'AUTO')
Parametre
house_system
Type
string
Requis
Non
Defaut
placidus
Description
placidus, whole_sign, equal, koch, etc.
Parametre
zodiac_type
Type
string
Requis
Non
Defaut
tropical
Description
tropical ou sidereal
Parametre
sidereal_ayanamsa
Type
string
Requis
Non
Defaut
lahiri
Description
lahiri, raman, kp, etc. (sidereal uniquement)

Parametres de sortie de carte

Parametre
format
Type
string
Requis
Non
Defaut
svg
Description
Format de sortie : 'svg' ou 'png'
Parametre
size
Type
integer
Requis
Non
Defaut
700
Description
Largeur/hauteur de la carte en pixels
Parametre
theme_type
Type
string
Requis
Non
Defaut
light
Description
Theme : 'light', 'dark' ou 'mono'
Parametre
png_quality_scale
Type
float
Requis
Non
Defaut
2.0
Description
Multiplicateur de resolution PNG (1.0-5.0)
Parametre
show_metadata
Type
boolean
Requis
Non
Defaut
true
Description
Afficher le bloc de metadonnees (nom, date, lieu)
Parametre
display_settings
Type
object
Requis
Non
Defaut
{}
Description
Toggles de visibilite par corps pour planetes, angles et points optionnels.
Parametre
chart_config
Type
object
Requis
Non
Defaut
{}
Description
Surcharges avancees de style visuel et de mise en page. Voir la section de configuration de carte ci-dessous pour les champs pris en charge.

Etoiles fixes

Les etoiles fixes demandees sur les SVG de carte sont rendues dans la meme roue de corps que les planetes 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 defaut aux conjonctions serrees.

Parametre
fixed_stars
Type
array<string>
Requis
Non
Defaut
[]
Description
Selecteur d'etoiles 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 defaut.
Parametre
chart_config.fixed_star_color
Type
string
Requis
Non
Defaut
theme points color
Description
Couleur des libelles, connecteurs et lignes d'aspects d'etoiles fixes activees.
Parametre
chart_config.show_fixed_star_aspects
Type
boolean
Requis
Non
Defaut
false
Description
Active les lignes d'aspects d'etoiles fixes.
Parametre
chart_config.fixed_star_aspect_types
Type
array<string>
Requis
Non
Defaut
['conjunction']
Description
Types d'aspects a dessiner pour les etoiles fixes. Prend en charge conjunction, opposition, trine, square, sextile, quincunx.
Parametre
chart_config.fixed_star_aspect_orb
Type
float
Requis
Non
Defaut
1.0
Description
Orbe en degres pour les aspects d'etoiles fixes.

Les 20 etoiles classiques/Beheniennes

La liste complete des etoiles 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"
  }
}

Parametres d'affichage (objet display_settings)

Controlez les corps celestes qui apparaissent sur la carte :

Parametre
sun
Type
boolean
Requis
Non
Defaut
true
Description
Afficher le Soleil
Parametre
moon
Type
boolean
Requis
Non
Defaut
true
Description
Afficher la Lune
Parametre
mercury
Type
boolean
Requis
Non
Defaut
true
Description
Afficher Mercure
Parametre
venus
Type
boolean
Requis
Non
Defaut
true
Description
Afficher Venus
Parametre
mars
Type
boolean
Requis
Non
Defaut
true
Description
Afficher Mars
Parametre
jupiter
Type
boolean
Requis
Non
Defaut
true
Description
Afficher Jupiter
Parametre
saturn
Type
boolean
Requis
Non
Defaut
true
Description
Afficher Saturne
Parametre
uranus
Type
boolean
Requis
Non
Defaut
true
Description
Afficher Uranus
Parametre
neptune
Type
boolean
Requis
Non
Defaut
true
Description
Afficher Neptune
Parametre
pluto
Type
boolean
Requis
Non
Defaut
true
Description
Afficher Pluton
Parametre
north_node
Type
boolean
Requis
Non
Defaut
true
Description
Afficher le noeud nord
Parametre
south_node
Type
boolean
Requis
Non
Defaut
false
Description
Afficher le noeud sud
Parametre
chiron
Type
boolean
Requis
Non
Defaut
false
Description
Afficher Chiron
Parametre
lilith
Type
boolean
Requis
Non
Defaut
false
Description
Afficher la Lune noire moyenne (preferee ; alias : mean_lilith)
Parametre
true_lilith
Type
boolean
Requis
Non
Defaut
false
Description
Afficher la Lune noire vraie (oscillante)
Parametre
eris
Type
boolean
Requis
Non
Defaut
false
Description
Afficher Eris
Parametre
eros
Type
boolean
Requis
Non
Defaut
false
Description
Afficher Eros
Parametre
ceres
Type
boolean
Requis
Non
Defaut
false
Description
Afficher Ceres
Parametre
pallas
Type
boolean
Requis
Non
Defaut
false
Description
Afficher Pallas
Parametre
juno
Type
boolean
Requis
Non
Defaut
false
Description
Afficher Juno
Parametre
vesta
Type
boolean
Requis
Non
Defaut
false
Description
Afficher Vesta
Parametre
asc
Type
boolean
Requis
Non
Defaut
true
Description
Afficher l'Ascendant
Parametre
ic
Type
boolean
Requis
Non
Defaut
false
Description
Afficher l'IC
Parametre
dsc
Type
boolean
Requis
Non
Defaut
false
Description
Afficher le Descendant
Parametre
mc
Type
boolean
Requis
Non
Defaut
true
Description
Afficher le MC
Parametre
part_of_fortune
Type
boolean
Requis
Non
Defaut
false
Description
Afficher la Part de Fortune (lot arabe)

Configuration de carte (objet chart_config)

Ajustez finement l'apparence visuelle de la carte :

Parametre
sign_ring_thickness_fraction
Type
float
Requis
Non
Defaut
0.16
Description
Epaisseur de l'anneau des signes (0.0-1.0)
Parametre
house_ring_thickness_fraction
Type
float
Requis
Non
Defaut
0.05
Description
Epaisseur de l'anneau des maisons (0.0-1.0)
Parametre
center_disk_fraction
Type
float
Requis
Non
Defaut
0.45
Description
Rayon du disque central (0.0-1.0)
Parametre
planet_symbol_scale
Type
float
Requis
Non
Defaut
0.35
Description
Multiplicateur de taille des symboles planetaires
Parametre
planet_spacing_scale
Type
float
Requis
Non
Defaut
auto
Description
Multiplicateur applique a l'espacement angulaire des glyphes planetaires. Si omis, l'espacement augmente automatiquement lorsque planet_symbol_scale depasse la valeur par defaut.
Parametre
sign_symbol_scale
Type
float
Requis
Non
Defaut
0.6
Description
Multiplicateur de taille des symboles de signes
Parametre
house_number_scale
Type
float
Requis
Non
Defaut
0.35
Description
Multiplicateur de taille des numeros de maisons
Parametre
chart_background
Type
string
Requis
Non
Defaut
null
Description
Surcharge de couleur de fond (hex)
Parametre
aspect_circle_background
Type
string
Requis
Non
Defaut
null
Description
Couleur de remplissage du cercle/disque central des aspects. Par defaut, utilise chart_background ou le fond du theme actif.
Parametre
custom_planet_color
Type
string
Requis
Non
Defaut
null
Description
Remplace toutes les couleurs des planetes (hex)
Parametre
custom_sign_color
Type
string
Requis
Non
Defaut
null
Description
Remplace toutes les couleurs des symboles de signes (hex)
Parametre
custom_house_color
Type
string
Requis
Non
Defaut
null
Description
Remplace toutes les couleurs des numeros de maisons (hex)
Parametre
degree_label_color
Type
string
Requis
Non
Defaut
null
Description
Remplace la couleur du texte des libelles degre/minute des planetes (hex ou couleur CSS)
Parametre
angle_label_color
Type
string
Requis
Non
Defaut
null
Description
Couleur de repli pour tous les libelles de glyphes ASC/DSC/MC/IC.
Parametre
asc_label_color
Type
string
Requis
Non
Defaut
null
Description
Couleur du label de glyphe ASC. Aussi disponible pour dsc_label_color, mc_label_color et ic_label_color.
Parametre
angle_label_scale
Type
float
Requis
Non
Defaut
null
Description
Multiplicateur d'echelle de repli pour tous les libelles de glyphes ASC/DSC/MC/IC.
Parametre
asc_label_scale
Type
float
Requis
Non
Defaut
null
Description
Multiplicateur d'echelle du label de glyphe ASC. Aussi disponible pour dsc_label_scale, mc_label_scale et ic_label_scale.
Parametre
angle_marker_style
Type
string
Requis
Non
Defaut
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 francais a l'exterieur de l'anneau des signes.
Parametre
angle_line_span
Type
string
Requis
Non
Defaut
wheel
Description
Portee des lignes d'axes d'angles : "wheel" garde les lignes ASC/DSC et MC/IC dans la zone de roue par defaut ; "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.
Parametre
show_angle_labels_with_french_arrows
Type
boolean
Requis
Non
Defaut
true
Description
Lorsque angle_marker_style vaut "french_arrow", rend les libelles de glyphes ASC/DSC/MC/IC actifs. Definissez false pour les masquer.
Parametre
planet_connector_clearance
Type
float
Requis
Non
Defaut
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.
Parametre
custom_sign_bg_color
Type
string
Requis
Non
Defaut
null
Description
Couleur hex unique appliquee aux fonds des 12 anneaux de signes. Lorsqu'elle est definie, les fonds de signes sont actives automatiquement.
Parametre
custom_house_bg_color
Type
string
Requis
Non
Defaut
null
Description
Couleur hex unique appliquee aux fonds des 12 anneaux de maisons. Lorsqu'elle est definie, les fonds de maisons sont actives automatiquement.
Parametre
show_aspect_symbols
Type
boolean
Requis
Non
Defaut
auto
Description
Affiche les glyphes d'aspects au midpoint et les lignes d'aspects separees autour d'eux. Active par defaut en style francais et desactive sinon.
Parametre
show_pattern_overlays
Type
boolean
Requis
Non
Defaut
false
Description
Superpose les structures et configurations detectees 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.
Parametre
pattern_overlay_types
Type
array
Requis
Non
Defaut
null
Description
Liste optionnelle de types de superpositions a rendre, par exemple ["grand_trine", "t_square", "stellium"]. Si omise, toutes les superpositions detectees prises en charge peuvent etre rendues jusqu'a pattern_overlay_max_items.
Parametre
pattern_overlay_style
Type
string
Requis
Non
Defaut
subtle
Description
Intensite de la superposition : "subtle" ou "strong".
Parametre
pattern_overlay_labels
Type
boolean
Requis
Non
Defaut
false
Description
Affiche des libelles compacts pour les superpositions de configuration rendues.
Parametre
pattern_overlay_max_items
Type
integer
Requis
Non
Defaut
4
Description
Nombre maximum de superpositions de configuration a dessiner. Les surbrillances de signe/maison de stellium sont separees et ne comptent pas dans cette limite.
Parametre
embed_pattern_metadata
Type
boolean
Requis
Non
Defaut
false
Description
Integre les donnees de superposition detectees dans un element de metadonnees SVG pour le survol, la legende ou l'interface de selection en aval.
Parametre
show_horoscope_shape
Type
boolean
Requis
Non
Defaut
false
Description
Detecte la forme de distribution de la carte avec les 10 planetes seulement et la rend dans le disque central des aspects. Lorsqu'une forme est detectee, les lignes/ticks d'aspects centraux habituels sont masques pour la lisibilite.
Parametre
horoscope_shape_style
Type
string
Requis
Non
Defaut
subtle
Description
Intensite de la superposition de forme d'horoscope : "subtle" ou "strong".
Parametre
horoscope_shape_color
Type
string
Requis
Non
Defaut
#D97706
Description
Couleur SVG utilisee pour toutes les superpositions de forme d'horoscope.
Parametre
horoscope_shape_label
Type
boolean
Requis
Non
Defaut
true
Description
Affiche un label compact pour la forme detectee, comme Bucket, Bowl, Locomotive, Bundle, Splash ou Seesaw.
Parametre
embed_horoscope_shape_metadata
Type
boolean
Requis
Non
Defaut
true
Description
Integre les donnees de forme d'horoscope detectee dans un element de metadonnees SVG.
Parametre
show_retrograde_markers
Type
boolean
Requis
Non
Defaut
false
Description
Active les marqueurs retrogrades sur les libelles de degres des planetes.
Parametre
retrograde_marker_style
Type
string
Requis
Non
Defaut
R
Description
Style de marqueur retrograde lorsque l'option est activee : "R" ou "rx" (℞).
Parametre
degree_label_format
Type
string
Requis
Non
Defaut
null
Description
Format des libelles de degres des planetes : "degree" pour les degres entiers, "decimal" pour les degres decimaux, ou "minutes" pour les libelles empiles minute + glyphe de signe + degre entier. Si omis, degree_label_precision > 0 conserve l'ancienne mise en page en minutes.
Parametre
degree_label_precision
Type
integer
Requis
Non
Defaut
0
Description
Nombre de decimales pour degree_label_format="decimal". Plage autorisee : 0-4. Pour compatibilite ascendante, si degree_label_format est omis, les valeurs superieures a 0 activent la mise en page empilee en minutes.
Parametre
degree_label_scale
Type
float
Requis
Non
Defaut
0.6
Description
Echelle de base du texte des libelles de degres des planetes.
Parametre
degree_label_degree_scale
Type
float
Requis
Non
Defaut
1.0
Description
Echelle du texte des degres entiers des libelles precis, relative a degree_label_scale.
Parametre
degree_label_minute_scale
Type
float
Requis
Non
Defaut
1.0
Description
Echelle du texte des minutes des libelles precis, relative a degree_label_scale.
Parametre
degree_label_sign_scale
Type
float
Requis
Non
Defaut
1.25
Description
Echelle du glyphe de signe zodiacal des libelles precis, relative a degree_label_scale.
Parametre
degree_label_row_gap
Type
float
Requis
Non
Defaut
1.55
Description
Espacement des libelles precis entre les lignes de degre, signe et minute, relatif a degree_label_scale.
Parametre
houses_inside_planets
Type
boolean
Requis
Non
Defaut
true
Description
Place les maisons a l'interieur de l'anneau des planetes
Parametre
french_style
Type
boolean
Requis
Non
Defaut
false
Description
Mise en page d'horoscope francais natal seulement : disque d'aspects dans le bord des signes, maisons a l'exterieur des signes, planetes a l'exterieur des maisons.
Parametre
french_planet_radius_offset
Type
float
Requis
Non
Defaut
0
Description
Mode francais natal seulement. Deplace les glyphes planetaires radialement vers l'exterieur ou l'interieur sans deplacer les anneaux de maisons/signes.

Exemples de format de libelles de degres

Utilisez degree_label_format: "minutes" pour rendre chaque libelle precis en lignes separees pour degre, glyphe de signe et minutes. Les exemples ci-dessous sont des sorties PNG generees par le meme endpoint en mises en page standard et francaise.

Theme natal standard en PNG utilisant degree_label_format minutes

Mise en page standard

Les maisons restent a l'interieur de la bande des planetes ; les libelles precis 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
  }
}
Theme natal de style francais en PNG utilisant degree_label_format minutes

Mise en page francaise

Le mode francais garde les libelles precis hors angles a l'exterieur des glyphes planetaires, tandis que les libelles 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",
    "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 parametres supplementaires incluent :

  • 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 defini sur french_arrow pour des fleches d'axes ASC/MC de style francais ; les libelles d'angles actifs restent visibles sauf si show_angle_labels_with_french_arrows vaut false
  • angle_line_span defini 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
  • 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 etoiles fixes ?

Oui. L'endpoint de cartes SVG peut rendre les etoiles fixes prises en charge dans la meme roue de corps que les planetes et les points. Utilisez fixed_stars avec des ids de packs comme royal_4 ou behenian_20, des noms exacts d'etoiles fixes, ou all pour l'ensemble complet par defaut.

Quels packs d'etoiles fixes sont disponibles ?

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

Puis-je selectionner des etoiles fixes individuelles ?

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

Les etoiles fixes peuvent-elles afficher des aspects ?

Oui, mais les aspects d'etoiles 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 defaut de conjonctions serrees.

Puis-je personnaliser la couleur des etoiles fixes ?

Oui. Definissez chart_config.fixed_star_color avec une couleur CSS ou une valeur hex. Cette couleur est utilisee pour les libelles d'etoiles fixes, les connecteurs et les lignes d'aspects d'etoiles fixes activees.

Les etoiles fixes affichent-elles les degres et libelles de signes ?

Oui. Les etoiles fixes utilisent le meme comportement de placement que les autres corps rendus et peuvent afficher degre, signe et minutes lorsque la configuration des libelles de degres le demande.

Avez-vous un outil pour personnaliser les cartes ?

Oui. Le Chart Designer permet de configurer les couleurs, libelles, epaisseurs de lignes, themes et autres options visuelles avant de copier la configuration de requete dans l'API.

Ouvrir Chart Designer

Puis-je personnaliser les couleurs, libelles, aspects et la mise en page ?

Oui. Utilisez chart_config pour les couleurs, fonds, geometrie des anneaux, echelle des glyphes, style des connecteurs, couleurs d'aspects, epaisseurs de lignes, libelles de degres, marqueurs retrogrades, mise en page de style francais et superpositions de configurations.

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

Oui. Definissez format sur svg pour une sortie vectorielle ou png pour une sortie raster. Pour PNG, png_quality_scale controle le multiplicateur de resolution de sortie.

Puis-je integrer le SVG dans mon application ?

Oui. La reponse SVG peut etre integree directement dans votre front-end, stockee comme ressource ou convertie dans votre propre chaîne de rendu. Utilisez la reponse API selon les regles de cache et de securite de votre application.

Puis-je construire une app mobile avec des cartes visuelles grace a cette API ?

Oui. Vous pouvez utiliser cet endpoint pour generer des visuels de cartes en SVG ou PNG pour une application mobile, puis afficher la ressource renvoyee dans votre UI native ou multiplateforme. AstroLingo est un exemple d'application construite avec les capacites de cartes visuelles de FreeAstroAPI.

Voir l'exemple AstroLingo

Puis-je masquer ou afficher planetes, points et maisons ?

Oui. Utilisez display_settings pour activer ou masquer planetes, 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 retrogradations ?

Oui. Definissez 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. Definissez time_known sur false. La carte affiche toujours les positions planetaires, 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 detectees, et chart_config.show_horoscope_shape rend la forme de distribution du theme dans le disque central.

Le rendu des etoiles fixes est-il plus lent ?

Les etoiles 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 cout de rendu additionnel.

Comment authentifier les requetes ?

Envoyez votre cle API dans l'en-tete x-api-key avec Content-Type defini 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 separement de l'endpoint natal de cartes SVG.

Docs SVG de transitsDocs SVG de synastrieDocs SVG composite

Endpoints associes

Theme natal (JSON)

Obtenir les donnees du theme au format JSON

Transits

Comparer le ciel actuel au theme natal