Закупка API для фотоэлектрических систем: укажите JSON или XML для обеих конечных точек
Cinn Song
Founder & Chief Solutions Architect

Явно укажите JSON или XML для обеих конечных точек — Solar Dataset Query V2 и PVWatts V8; CSV документирован только для поиска данных. Требуйте указания координат площадки, входных данных расчета, прослеживаемости метеофайла и отдельных приемочных проверок для каждой конечной точки. Любой экспорт результатов расчета в CSV рассматривайте как отдельно оговариваемый результат работы приложения.
Краткое содержание
Явно укажите JSON или XML для обеих конечных точек — Solar Dataset Query V2 и PVWatts V8; CSV документирован только для поиска данных. Требуйте указания координат площадки, входных данных расчета, прослеживаемости метеофайла и отдельных приемочных проверок для каждой конечной точки. Любой экспорт результатов расчета в CSV рассматривайте как отдельно оговариваемый результат работы приложения.
Основные выводы
- JSON и XML документированы для обеих конечных точек; CSV указан только для Solar Dataset Query V2.
- Обе конечные точки требуют явного указания формата ответа; формат по умолчанию в документации не указан.
- PVWatts V8 может использовать действительный file_id, полученный при поиске данных; при использовании этого идентификатора не передавайте dataset.
- Фиксируйте сведения об источнике метеоданных и расстоянии, учитывая, что радиус поиска задается в милях, а возвращаемое расстояние — в метрах.
- Укажите входные данные расчета, временной интервал и единицы измерения: месячная энергия и почасовая мощность представлены разными выходными полями.
- До приемки проверьте парсеры обеих конечных точек, передачу метеофайла, предупреждения и обработку некорректных входных данных.
Укажите JSON или XML для поиска климатических данных и расчетов выработки фотоэлектрической системы
Краткое содержание: Укажите JSON или XML для обеих конечных точек — Solar Dataset Query V2 и PVWatts V8. Эти форматы ответа документированы для обеих; CSV указан только для поиска данных. Требуйте явного выбора формата, указания координат площадки, входных данных расчета и прослеживаемости метеофайла. Перед приемкой интеграции проверьте каждую конечную точку отдельно.
1. Выберите формат, поддерживаемый обеими конечными точками

В закупочной спецификации, охватывающей поиск климатических данных и расчеты выработки фотоэлектрической системы, требуйте единый формат ответа: JSON или XML. Для Solar Dataset Query V2 указаны json, xml и csv, а для PVWatts V8 — json и xml. В обоих случаях format описан как обязательный параметр без значения по умолчанию. В URL запросов выбранный формат указывается после версии конечной точки. Solar Dataset Query V2; PVWatts V8
Рекомендуемая формулировка договора: «Интеграция должна явно запрашивать JSON как для поиска данных, так и для расчета либо XML для обеих операций, если этого требует принимающая система. Поддержка CSV при поиске данных должна оговариваться отдельно». Выбирайте JSON или XML с учетом принимающего программного обеспечения заказчика и требований к приемке. Документированные перечни форматов не подтверждают преимущество какого-либо из них по производительности.
CSV остается документированным вариантом для поиска данных. Однако его наличие в Solar Dataset Query V2 не подтверждает поддержку CSV в PVWatts V8. Если участник закупки предлагает предоставлять результаты расчета в CSV, уточните, идет ли речь об экспорте, формируемом приложением, и потребуйте отдельную спецификацию экспорта. Не принимайте поддержку формата поиска данных за подтверждение работоспособности расчетного интерфейса.
2. Укажите порядок передачи данных от поиска к расчету

Solar Dataset Query V2 требует ключ API, широту, долготу и формат ответа. Он возвращает сведения о доступных климатических файлах, включая идентификаторы, координаты, расстояние и источник метеоданных. Для набора данных, по которому результат отсутствует, документированный ответ содержит null и предупреждение. Рекомендуется требовать, чтобы приложение сохраняло эти предупреждения вместе с результатом поиска данных. Solar Dataset Query V2
PVWatts V8 принимает либо широту и долготу площадки, либо file_id. Значение file_id должно быть действительным идентификатором, возвращенным Solar Dataset Query V2. При указании этого идентификатора документация предписывает не передавать dataset. Для обеспечения проверяемости передачи данных рекомендуется фиксировать выбранный идентификатор из результатов поиска и явно передавать его расчетной конечной точке. PVWatts V8
Настройки поиска также необходимо оговорить явно. Для поиска данных параметр radius документирован в милях, тогда как возвращаемый distance выражен в метрах. Указано, что radius=0 находит ближайшие станции независимо от расстояния, а all=1 требует положительного радиуса. Хотя в приведенном примере запроса нулевой радиус сочетается с all=1, при закупочной приемке следует руководствоваться правилом для параметра и проверять положительный радиус при запросе всех станций. Solar Dataset Query V2
Рекомендуется попросить участника закупки показать выбранную запись метеоданных и соответствующее расстояние до утверждения расчета. Сам по себе успешный ответ на запрос поиска данных не должен означать согласие заказчика на использование этой записи в проекте.
3. Определите входные данные расчета и смысл выходных показателей
Общий формат сериализации не заменяет расчетную спецификацию. PVWatts V8 требует указания номинальной мощности, типа модулей, потерь системы, типа массива, угла наклона и азимута, а также выбора местоположения или климатического файла и параметров доступа к API. Рекомендуется требовать ведомость входных данных проекта, в которой указано каждое передаваемое значение, а намеренно выбранные значения отделены от документированных значений по умолчанию. PVWatts V8
Также укажите временную детализацию результатов. По умолчанию PVWatts V8 возвращает месячные результаты и поддерживает timeframe=hourly. Его месячные выходные показатели AC и DC представляют собой значения энергии в kWhac и kWhdc; почасовые выходные показатели AC и DC представляют собой значения мощности в Wac и Wdc. Месячные массивы упорядочены с января по декабрь. Рекомендуется включить эти имена полей, единицы измерения и порядок следования в лист приемки интерфейса. PVWatts V8
Для прослеживаемости метеоданных потребуйте сохранения station_info, включая источник метеоданных и имя файла данных о солнечном ресурсе. Документированный ответ также включает полученные входные данные, ошибки, предупреждения, версию сервиса и сведения о библиотеке SSC. Рекомендуется сохранять соответствующий ответ на расчетный запрос вместе с каждой рассматриваемой оценкой, чтобы заказчик мог проверить моделируемую конфигурацию и происхождение данных. PVWatts V8
4. Проводите приемку интеграции с помощью отдельных проверок каждой конечной точки
Рекомендуется требовать, чтобы участник закупки отдельно продемонстрировал поиск данных и расчет в выбранном формате, а затем — передачу данных между ними. Проверьте идентификаторы результатов поиска, предупреждения об отсутствии наборов данных и выбранную запись климатических данных. Для расчета проверьте переданные входные данные, возвращенные сведения о станции, запрошенный временной интервал и единицы измерения выходных показателей.
Требуйте отдельных проверок парсера для каждой конечной точки, даже если обе используют JSON или XML. Поиск данных описывает доступные климатические файлы; PVWatts возвращает результаты моделирования и метаданные расчета. Поэтому общий формат должен быть закреплен в договоре вместе с явным сопоставлением полей. Solar Dataset Query V2; PVWatts V8
Оба документа описывают HTTP 422 для отсутствующих или некорректных параметров и отсылают пользователей к разделу ошибок в ответе. Рекомендуется включить в приемочные испытания сценарий с некорректными входными данными и проверить, что приложение сообщает об ошибке, а не представляет ответ как оценку выработки. Оба документа также устанавливают ограничение в 1000 запросов в час; попросите участника закупки объяснить, как предлагаемый график запросов соблюдает это ограничение. Solar Dataset Query V2; PVWatts V8
Предмет приемки — работающий интерфейс поиска данных и моделирования. PVWatts V8 документирует прогнозные показатели выработки. Если закупочное решение предполагает гарантированную выработку проекта, запросите отдельные подтверждающие материалы по конкретному проекту и договорные условия, обосновывающие эту гарантию.
Часто задаваемые вопросы
Следует ли требовать в договоре JSON или XML?
Требуйте один из них в качестве общего формата, выбирая его с учетом принимающего программного обеспечения. Для обеих конечных точек документированы JSON и XML.
Можно ли указать CSV для обоих API?
CSV документирован для Solar Dataset Query V2, но не указан среди форматов ответа PVWatts V8. Любой экспорт расчетных данных в CSV, формируемый приложением, оговаривайте отдельно.
Может ли интеграция не указывать формат?
В обоих документах формат отмечен как обязательный, а значение по умолчанию не указано. Требуйте явного выбора в каждом запросе.
Как выбрать найденный климатический файл для расчета?
Передайте его действительный идентификатор из результатов поиска в качестве file_id в PVWatts V8. Документация предписывает не передавать dataset вместе с file_id.
Ограничивает ли radius=0 поиск местоположением проекта?
Нет. Он выбирает ближайшие станции независимо от расстояния. Проверьте возвращенное расстояние перед утверждением записи метеоданных.
Что происходит, если поиск не находит данных для набора данных?
Solar Dataset Query V2 документирует значение null для этого набора данных и предупреждение. Требуйте, чтобы приложение сохраняло его и сообщало о нем.
Представляются ли почасовые значения AC как энергия?
PVWatts V8 документирует почасовое значение ac в Wac. Месячное ac_monthly и годовое ac_annual документированы в kWhac.
Что следует проверять при приемочных испытаниях с некорректными входными данными?
Оба документа описывают HTTP 422 для некорректных или отсутствующих параметров. Проверьте, что приложение считывает раздел ошибок и сообщает о сбое.
Об Авторе

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.
Цитировать эту статью
Cinn Song. (2026). Закупка API для фотоэлектрических систем: укажите JSON или XML для обеих конечных точек. SOLARTODO. Retrieved from https://solartodo.com/ru/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 = {Закупка API для фотоэлектрических систем: укажите JSON или XML для обеих конечных точек},
author = {Cinn Song},
journal = {SOLARTODO Knowledge Base},
year = {2026},
url = {https://solartodo.com/ru/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/ru/knowledge/should-the-pv-software-integration-specify-json-or-xml-for-both-climate-data-discovery-and-production-calculations
Подпишитесь на Нашу Рассылку
Получайте последние новости и аналитические материалы по солнечной энергии прямо на ваш почтовый ящик.
Просмотреть Все Статьи