Achat d’API photovoltaïques : spécifier JSON ou XML pour les deux points de terminaison
Cinn Song
Founder & Chief Solutions Architect

Spécifiez explicitement JSON ou XML pour Solar Dataset Query V2 et PVWatts V8 ; CSV n’est documenté que pour la recherche de données. Exigez les coordonnées du site, les paramètres de calcul, la traçabilité des fichiers météorologiques et des contrôles de réception propres à chaque point de terminaison. Traitez tout export CSV des calculs comme un livrable applicatif faisant l’objet d’une spécification distincte.
Résumé
Spécifiez explicitement JSON ou XML pour Solar Dataset Query V2 et PVWatts V8 ; CSV n’est documenté que pour la recherche de données. Exigez les coordonnées du site, les paramètres de calcul, la traçabilité des fichiers météorologiques et des contrôles de réception propres à chaque point de terminaison. Traitez tout export CSV des calculs comme un livrable applicatif faisant l’objet d’une spécification distincte.
Points clés
- JSON et XML sont documentés pour les deux points de terminaison ; CSV n’est répertorié que pour Solar Dataset Query V2.
- Les deux points de terminaison exigent un format de réponse explicite et ne documentent aucun format par défaut.
- PVWatts V8 peut utiliser un file_id valide issu de la recherche de données ; omettez dataset lorsque vous utilisez cet identifiant.
- Enregistrez les détails de la source météorologique et la distance, en distinguant les miles du rayon de recherche des mètres de la distance renvoyée.
- Spécifiez les paramètres de calcul, la résolution temporelle et les unités : l’énergie mensuelle et la puissance horaire correspondent à des champs de sortie différents.
- Vérifiez les analyseurs des deux points de terminaison, le transfert du fichier météorologique, les avertissements et la gestion des données d’entrée invalides avant la réception.
Spécifier JSON ou XML pour la recherche de données climatiques et les calculs de production photovoltaïque
Résumé : Spécifiez JSON ou XML pour Solar Dataset Query V2 et PVWatts V8. Les deux documentent ces formats de réponse ; CSV n’est répertorié que pour la recherche de données. Exigez une sélection explicite du format, les coordonnées du site, les paramètres de calcul et la traçabilité des fichiers météorologiques. Vérifiez chaque point de terminaison séparément avant de réceptionner l’intégration.
1. Choisir un format pris en charge par les deux points de terminaison

Pour un cahier des charges couvrant la recherche de données climatiques et les calculs de production photovoltaïque, exigez un format de réponse commun : JSON ou XML. Solar Dataset Query V2 répertorie json, xml et csv, tandis que PVWatts V8 répertorie json et xml. Les deux indiquent que format est obligatoire, sans valeur par défaut. Leurs URL de requête placent le format sélectionné après la version du point de terminaison. Solar Dataset Query V2 ; PVWatts V8
La formulation contractuelle recommandée est la suivante : « L’intégration doit demander explicitement JSON pour la recherche de données et le calcul, ou XML pour les deux lorsque le système destinataire l’exige. La prise en charge de CSV pour la recherche de données doit faire l’objet d’une spécification distincte. » Choisissez entre JSON et XML selon le logiciel destinataire de l’acheteur et les exigences de réception. Les listes de formats documentées n’établissent aucun avantage de performance pour l’un ou l’autre choix.
CSV reste une option documentée pour la recherche de données. Toutefois, sa présence dans Solar Dataset Query V2 n’établit pas sa prise en charge par PVWatts V8. Si un soumissionnaire propose de livrer les calculs au format CSV, demandez s’il s’agit d’un export généré par l’application et exigez une spécification d’export distincte. N’acceptez pas la prise en charge d’un format de recherche de données comme preuve de vérification de l’interface de calcul.
2. Spécifier le transfert entre la recherche de données et le calcul

Solar Dataset Query V2 exige une clé API, une latitude, une longitude et un format de réponse. Il renvoie des informations sur les fichiers climatiques disponibles, notamment les identifiants, les coordonnées, la distance et la source des données météorologiques. Pour un jeu de données sans résultat, la réponse documentée contient null et un avertissement. Il est recommandé d’exiger que l’application conserve ces avertissements avec le résultat de la recherche. Solar Dataset Query V2
PVWatts V8 accepte soit la latitude et la longitude du site, soit un file_id. Un file_id doit être un identifiant valide renvoyé par Solar Dataset Query V2. Lorsque cet identifiant est spécifié, la documentation indique de ne pas transmettre dataset. Pour assurer la traçabilité du transfert à des fins d’audit, il est recommandé d’enregistrer l’identifiant sélectionné lors de la recherche et de le soumettre explicitement au point de terminaison de calcul. PVWatts V8
Les paramètres de recherche doivent également être traités explicitement. La documentation de recherche exprime radius en miles, tandis que la valeur distance renvoyée est en mètres. Elle indique que radius=0 trouve les stations les plus proches, quelle que soit leur distance, et que all=1 exige un rayon positif. Bien que la requête présentée en exemple combine un rayon nul avec all=1, les contrôles de réception prévus au marché doivent suivre la règle du paramètre et tester un rayon positif lors de la demande de toutes les stations. Solar Dataset Query V2
Il est recommandé de demander au soumissionnaire de présenter l’enregistrement météorologique sélectionné et sa distance avant l’approbation du calcul. Une réponse de recherche réussie ne doit pas, à elle seule, valoir acceptation de cet enregistrement par l’acheteur pour le projet.
3. Définir les paramètres de calcul et la signification des sorties
Un format de sérialisation commun ne remplace pas la spécification du calcul. PVWatts V8 exige la puissance nominale, le type de module, les pertes du système, le type de champ photovoltaïque, l’inclinaison et l’azimut, ainsi que la localisation ou la sélection du fichier climatique et les paramètres d’accès à l’API. Il est recommandé d’exiger un tableau des données d’entrée du projet qui identifie chaque valeur soumise et distingue les choix délibérés des valeurs par défaut documentées. PVWatts V8
Spécifiez également la granularité des sorties. PVWatts V8 fournit par défaut des résultats mensuels et accepte timeframe=hourly. Ses sorties mensuelles AC et DC sont des valeurs d’énergie exprimées en kWhac et kWhdc ; ses sorties horaires AC et DC sont des valeurs de puissance exprimées en Wac et Wdc. Les tableaux mensuels vont de janvier à décembre. Il est recommandé d’inclure ces noms de champs, ces unités et cet ordre dans la fiche de réception de l’interface. PVWatts V8
Pour la traçabilité météorologique, demandez la conservation de station_info, notamment de la source des données météorologiques et du nom du fichier de ressource solaire. La réponse documentée comprend également les données d’entrée reçues, les erreurs, les avertissements, la version du service et les informations sur la bibliothèque SSC. Il est recommandé de conserver la réponse de calcul pertinente avec chaque estimation examinée afin que l’acheteur puisse inspecter la configuration modélisée et sa provenance. PVWatts V8
4. Réceptionner l’intégration au moyen de contrôles propres à chaque point de terminaison
Il est recommandé d’exiger que le soumissionnaire démontre séparément la recherche de données et le calcul dans le format sélectionné, puis démontre le transfert entre les deux. Vérifiez les identifiants issus de la recherche, les avertissements relatifs aux jeux de données manquants et l’enregistrement climatique sélectionné. Pour le calcul, vérifiez les paramètres soumis, les informations de station renvoyées, la résolution temporelle demandée et les unités de sortie.
Exigez des contrôles distincts des analyseurs pour chaque point de terminaison, même lorsque les deux utilisent JSON ou XML. La recherche décrit les fichiers climatiques disponibles ; PVWatts renvoie les résultats de simulation et les métadonnées de calcul. Un format commun doit donc constituer un choix contractuel accompagné d’une correspondance explicite des champs. Solar Dataset Query V2 ; PVWatts V8
Les deux documentations décrivent le code HTTP 422 pour les paramètres manquants ou invalides et renvoient les utilisateurs à la section des erreurs de la réponse. Il est recommandé d’inclure un cas de données d’entrée invalides dans les essais de réception et de vérifier que l’application signale l’erreur au lieu de la présenter comme une estimation de production. Les deux indiquent également une limite de 1000 requêtes par heure ; demandez au soumissionnaire d’expliquer comment le calendrier de requêtes proposé la respecte. Solar Dataset Query V2 ; PVWatts V8
Le périmètre de réception est une interface fonctionnelle de recherche de données et de simulation. PVWatts V8 documente des sorties de production prévisionnelle. Pour une décision d’achat impliquant une garantie de production du projet, demandez les éléments justificatifs propres au projet et les dispositions contractuelles distinctes qui étayent cette garantie.
Foire aux questions
Le contrat doit-il exiger JSON ou XML ?
Exigez l’un ou l’autre comme format commun, choisi en fonction du logiciel destinataire. Les deux points de terminaison documentent JSON et XML.
Peut-on spécifier CSV pour les deux API ?
CSV est documenté pour Solar Dataset Query V2, mais ne figure pas parmi les formats de réponse de PVWatts V8. Spécifiez séparément tout export CSV des calculs généré par l’application.
L’intégration peut-elle omettre la sélection du format ?
Les deux documentations indiquent que le format est obligatoire et ne répertorient aucune valeur par défaut. Exigez une sélection explicite dans chaque requête.
Comment sélectionner un fichier climatique trouvé lors de la recherche pour le calcul ?
Transmettez son identifiant valide issu de la recherche comme file_id de PVWatts V8. La documentation indique de ne pas transmettre dataset avec file_id.
radius=0 limite-t-il la recherche à l’emplacement du projet ?
Non. Il sélectionne les stations les plus proches, quelle que soit leur distance. Examinez la distance renvoyée avant d’approuver l’enregistrement météorologique.
Que se passe-t-il lorsque la recherche ne trouve aucune donnée pour un jeu de données ?
Solar Dataset Query V2 documente une sortie null pour ce jeu de données et un avertissement. Exigez que l’application le conserve et le signale.
Les valeurs AC horaires sont-elles exprimées en énergie ?
PVWatts V8 documente la valeur horaire ac en Wac. Les valeurs mensuelle ac_monthly et annuelle ac_annual sont documentées en kWhac.
Que doivent vérifier les essais de réception portant sur les données d’entrée invalides ?
Les deux documentations décrivent le code HTTP 422 pour les paramètres invalides ou manquants. Vérifiez que l’application lit la section des erreurs et signale l’échec.
À Propos de l'Auteur

Cinn Song
Founder & Chief Solutions Architect
Cinn Song founded SOLARTODO LIMITED and leads its smart-city infrastructure engineering — from solar, storage and integrated smart poles to the company's push into physical-AI city edge nodes: pole-mounted edge computing, vertical LLMs for smart cities, drone-based O&M with autonomous battery swapping, robotic maintenance, and high-speed counter-UAS interception. Since 2010, he has directed turnkey EPC + BOT delivery across 50+ countries, including telecom monopole supply for national grid operators, off-grid solar street-lighting for African municipalities, and integrated smart-pole programs for Gulf smart cities.
Citer cet article
Cinn Song. (2026). Achat d’API photovoltaïques : spécifier JSON ou XML pour les deux points de terminaison. SOLARTODO. Retrieved from https://solartodo.com/fr/knowledge/should-the-pv-software-integration-specify-json-or-xml-for-both-climate-data-discovery-and-production-calculations
@article{solartodo_should_the_pv_software_integration_specify_json_or_xml_for_both_climate_data_discovery_and_production_calculations,
title = {Achat d’API photovoltaïques : spécifier JSON ou XML pour les deux points de terminaison},
author = {Cinn Song},
journal = {SOLARTODO Knowledge Base},
year = {2026},
url = {https://solartodo.com/fr/knowledge/should-the-pv-software-integration-specify-json-or-xml-for-both-climate-data-discovery-and-production-calculations},
note = {Accessed: 2026-11-17}
}Published: November 17, 2026 | Available at: https://solartodo.com/fr/knowledge/should-the-pv-software-integration-specify-json-or-xml-for-both-climate-data-discovery-and-production-calculations
Abonnez-vous à Notre Newsletter
Recevez les dernières nouvelles et aperçus sur l'énergie solaire directement dans votre boîte de réception.
Voir Tous les Articles