Индекс
-
Solar(интерфейс) -
AdditionalInsights(перечисление) -
BuildingInsights(сообщение) -
BuildingInsights.DetectedArrays(message) -
BuildingInsights.DetectedArrays.DetectionStatus(enum) -
CashPurchaseSavings(сообщение) -
DataLayerView(enum) -
DataLayers(сообщение) -
Experiment(перечисление) -
FinancedPurchaseSavings(сообщение) -
FinancialAnalysis(сообщение) -
FinancialDetails(сообщение) -
FindClosestBuildingInsightsRequest(message) -
GetDataLayersRequest(message) -
GetGeoTiffRequest(message) -
ImageryQuality(перечисление) -
LatLngBox(message) -
LeasingSavings(сообщение) -
RoofSegmentSizeAndSunshineStats(message) -
RoofSegmentSummary(message) -
SavingsOverTime(сообщение) -
SizeAndSunshineStats(сообщение) -
SolarPanel(сообщение) -
SolarPanelConfig(message) -
SolarPanelOrientation(enum) -
SolarPotential(сообщение)
Солнечная
Определение сервиса для API Solar.
| FindClosestBuildingInsights |
|---|
Находит здание, центр тяжести которого находится ближе всего к точке запроса. Возвращает ошибку с кодом
|
| GetDataLayers |
|---|
Получает информацию о солнечной энергии в регионе, окружающем указанное местоположение. Возвращает ошибку с кодом
|
| GetGeoTiff |
|---|
Возвращает изображение по его идентификатору.
|
Дополнительные сведения
В BuildingInsights можно получить дополнительную информацию о здании, такую как геометрия крыши и расположение солнечных панелей.
| Перечисления | |
|---|---|
ADDITIONAL_INSIGHTS_UNSPECIFIED | Значение по умолчанию. Будет возвращено значение BuildingInsights по умолчанию. |
DETECTED_ARRAYS | Определяет, будет ли ответ включать обнаруженные массивы. Если указано, поле |
BuildingInsights
Ответное сообщение для Solar.FindClosestBuildingInsights . Информация о местоположении, размерах и солнечном потенциале здания.
| Поля | |
|---|---|
name | Название ресурса для здания в формате |
center | Точка, расположенная вблизи центра здания. |
bounding_box | Ограничивающий прямоугольник здания. |
imagery_date | Дата получения исходных изображений. Это приблизительная дата. |
imagery_processed_date | Когда обработка этих изображений была завершена. |
postal_code | Почтовый индекс (например, почтовый индекс США), к которому относится это здание. |
administrative_area | Административный район 1 (например, в США — штат), в котором находится это здание. Например, в США аббревиатура может быть «MA» или «CA». |
statistical_area | Статистический район (например, переписной участок США), в котором находится это здание. |
region_code | Региональный код страны (или региона), в которой находится это здание. |
solar_potential | Солнечный потенциал здания. |
imagery_quality | Качество изображений, использованных для обработки данных по этому зданию. |
detected_arrays | На здании обнаружены солнечные батареи. Это поле заполняется только в том случае, если параметр DETECTED_ARRAYS включен в запрос |
Обнаруженные массивы
Информация об обнаруженных на здании солнечных батареях.
| Поля | |
|---|---|
detection_status | Указывает на статус обнаружения солнечных батарей на данном здании. |
latest_capture_date | Дата, указывающая на момент получения последних данных о работе солнечных батарей. |
Статус обнаружения
Указывает на статус обнаружения солнечных батарей на данном здании.
| Перечисления | |
|---|---|
DETECTION_STATUS_UNSPECIFIED | Статус не указан. |
DETECTION_STATUS_DATA_UNAVAILABLE | Данные о наличии солнечных батарей для этого здания отсутствуют. |
DETECTION_STATUS_ARRAYS_DETECTED | На этом здании обнаружена как минимум одна солнечная батарея. |
DETECTION_STATUS_NO_ARRAYS_DETECTED | На этом здании не обнаружено солнечных батарей. |
Скидки на покупки за наличные
Анализ затрат и выгод прямой покупки солнечной электростанции определенной конфигурации с определенным уровнем потребления электроэнергии.
| Поля | |
|---|---|
out_of_pocket_cost | Первоначальная стоимость до вычета налоговых льгот: сумма, которую необходимо оплатить из собственных средств. В отличие от |
upfront_cost | Первоначальные затраты после вычета налоговых льгот: это сумма, которую необходимо оплатить в течение первого года. В отличие от |
rebate_value | Сумма всех налоговых вычетов. |
savings | Сколько средств будет сэкономлено (или нет) за весь период жизни. |
payback_years | Количество лет до наступления срока окупаемости. Отрицательное значение означает, что окупаемость не наступит в течение всего срока службы. |
DataLayerView
Какое подмножество солнечной информации следует вернуть?
| Перечисления | |
|---|---|
DATA_LAYER_VIEW_UNSPECIFIED | Эквивалентно FULL. |
DSM_LAYER | Приобретайте только DSM. |
IMAGERY_LAYERS | Получите DSM, RGB и маску. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS | Получите данные по ЦМР, RGB, маске и годовому потоку. |
IMAGERY_AND_ALL_FLUX_LAYERS | Получите данные по DSM, RGB, маске, годовому и месячному потоку. |
FULL_LAYERS | Получите все данные. |
Слои данных
Информация о солнечном потенциале региона. Фактические данные содержатся в нескольких файлах GeoTIFF, охватывающих запрошенный регион, для которых в этом сообщении указаны URL-адреса: каждая строка в сообщении DataLayers содержит URL-адрес, по которому можно получить соответствующий файл GeoTIFF. Эти URL-адреса действительны в течение нескольких часов после их генерации. Большинство файлов GeoTIFF имеют разрешение 0,1 м/пиксель, но файл с месячными потоками имеет разрешение 0,5 м/пиксель, а файлы с почасовыми данными о затенении — 1 м/пиксель. Если в запросе GetDataLayersRequest было указано значение pixel_size_meters , то минимальное разрешение в файлах GeoTIFF будет равно этому значению.
| Поля | |
|---|---|
imagery_date | Когда были получены исходные изображения (на основе которых получены все остальные данные) в этом регионе. Это, безусловно, несколько приблизительная дата, поскольку снимки могли быть сделаны в течение нескольких дней. |
imagery_processed_date | Когда обработка этих изображений была завершена. |
dsm_url | URL-адрес изображения цифровой модели поверхности (ЦМП) региона. Значения указаны в метрах над геоидом EGM96 (т.е. уровнем моря). Неверные местоположения (где у нас нет данных) сохраняются как -9999. |
rgb_url | URL-адрес изображения в формате RGB (аэрофотоснимок или спутниковая фотография) данного региона. |
mask_url | URL-адрес изображения маски здания: один бит на пиксель указывает, считается ли этот пиксель частью крыши или нет. |
annual_flux_url | URL-адрес карты годового потока солнечного света (годовое количество солнечного света на крышах) региона. Значения указаны в кВт·ч/кВт/год. Это нескорректированный поток : поток рассчитывается для каждого местоположения, а не только для крыш зданий. Недействительные местоположения сохраняются как -9999: местоположения за пределами нашей зоны покрытия будут недействительными, а также некоторые местоположения внутри зоны покрытия, где нам не удалось рассчитать поток, будут недействительными. |
monthly_flux_url | URL-адрес карты ежемесячных потоков солнечного света (солнечный свет на крышах, с разбивкой по месяцам) для данного региона. Значения указаны в кВт·ч/кВт·год. GeoTIFF-файл, на который указывает этот URL-адрес, будет содержать двенадцать полос, соответствующих периоду с января по декабрь. |
hourly_shade_urls[] | Двенадцать URL-адресов для почасового отображения затенения, соответствующих периоду с января по декабрь. Каждый GeoTIFF будет содержать 24 полосы, соответствующие 24 часам суток. Каждый пиксель представляет собой 32-битное целое число, соответствующее (до) 31 дням этого месяца; бит 1 означает, что в соответствующем месте можно увидеть солнце в этот день, в этот час, в этот месяц. Недопустимые местоположения сохраняются как -9999 (поскольку это отрицательное значение, бит 31 установлен, и ни одно допустимое значение не может иметь установленный бит 31, так как это соответствовало бы 32-му дню месяца). Пример может оказаться полезным. Если вы хотите узнать, видела ли точка (в пикселе с координатами (x, y)) солнце в 16:00 22 июня, вам нужно будет:
Более формально: если заданы где |
imagery_quality | Качество полученных изображений. |
Эксперимент
Указывает на экспериментальные возможности, доступные для включения в API, которые можно запустить до официального запуска.
Запросы, использующие это поле, классифицируются как предложения, находящиеся на стадии предварительного запуска (pre-GA), в соответствии со Специфическими условиями использования сервиса платформы Google Maps . Более подробную информацию см. в описаниях этапов запуска .
В будущем в это перечисление могут быть добавлены новые значения.
| Перечисления | |
|---|---|
EXPERIMENT_UNSPECIFIED | Эксперименты не указаны. |
EXPANDED_COVERAGE | Расширяет географический регион, доступный для запросов данных о солнечной энергии. Для получения дополнительной информации см. раздел «Расширенное покрытие» . |
Экономия на покупках в кредит
Затраты и выгоды от использования кредита для покупки солнечной батареи определенной конфигурации с определенным потреблением электроэнергии.
| Поля | |
|---|---|
annual_loan_payment | Ежегодные платежи по кредиту. |
rebate_value | Сумма всех налоговых вычетов (включая федеральный инвестиционный налоговый кредит (ITC)). |
loan_interest_rate | Процентная ставка по кредитам, принятая в данном наборе расчетов. |
savings | Сколько средств будет сэкономлено (или нет) за весь период жизни. |
Финансовый анализ
Анализ затрат и выгод оптимальной схемы размещения солнечных батарей при заданном размере счета за электроэнергию.
| Поля | |
|---|---|
monthly_bill | В данном анализе предполагается, что расчет производится по ежемесячному счету за электроэнергию. |
default_bill | Указывается, какой размер счета за электроэнергию выбран в качестве размера счета по умолчанию для района, в котором находится это здание. В одном из |
average_kwh_per_month | Сколько электроэнергии дом потребляет в среднем за месяц, исходя из размера счета и местных тарифов на электроэнергию. |
financial_details | Финансовая информация, применимая независимо от используемого метода финансирования. |
leasing_savings | Затраты и выгоды от аренды солнечных панелей. |
cash_purchase_savings | Затраты и выгоды от покупки солнечных панелей за наличные. |
financed_purchase_savings | Затраты и выгоды от покупки солнечных панелей в рассрочку. |
panel_config_index | Индекс в |
Финансовые подробности
Подробности финансового анализа. Некоторые из этих данных уже хранятся на более высоких уровнях (например, личные затраты). Общая сумма денежных средств рассчитана на весь период эксплуатации, определяемый полем panel_lifetime_years в SolarPotential . Примечание: личные затраты на приобретение панелей указаны в поле out_of_pocket_cost в CashPurchaseSavings .
| Поля | |
|---|---|
initial_ac_kwh_per_year | Как мы предполагаем, сколько кВт⋅ч переменного тока выработают солнечные панели в первый год их эксплуатации? |
remaining_lifetime_utility_bill | Счета за электроэнергию, не произведенную солнечными батареями, за весь срок службы панелей. |
federal_incentive | Сумма денег, доступная в рамках федеральных субсидий; это относится к случаю, когда пользователь приобретает панели (с кредитом или без него). |
state_incentive | Сумма денег, доступная в рамках государственных субсидий; это относится к случаю, когда пользователь приобретает панели (с кредитом или без него). |
utility_incentive | Сумма денег, доступная в рамках субсидий от коммунальных предприятий; это относится к случаю, когда пользователь приобретает солнечные панели (с кредитом или без него). |
lifetime_srec_total | Сумма денег, которую пользователь получит от кредитов на возобновляемую солнечную энергию в течение всего срока службы панелей; это относится к случаю, когда пользователь приобретает панели (с кредитом или без него). |
cost_of_electricity_without_solar | Общая стоимость электроэнергии, которую пользователь заплатил бы за весь срок службы, если бы не установил солнечные батареи. |
net_metering_allowed | Разрешена ли система взаимозачета электроэнергии. |
solar_percentage | Процент (0-100) электроэнергии, потребляемой пользователем за счет солнечной энергии. Действительно для первого года, но приблизительно корректно для последующих лет. |
percentage_exported_to_grid | Мы предположили, что в первом квартале произведенной солнечной электроэнергии в сеть экспортируется определенный процент (от 0 до 100) от общего объема. Это влияет на расчеты, если нетто-учет электроэнергии не разрешен. |
FindClosestBuildingInsightsRequest
Запрос сообщения для Solar.FindClosestBuildingInsights .
| Поля | |
|---|---|
location | Обязательный параметр. Долгота и широта, от которых API ищет ближайшее известное здание. |
required_quality | Необязательно. Минимально допустимый уровень качества результатов. Результаты с более низким качеством не будут возвращены. Неуказание этого параметра означает ограничение только ВЫСОКИМ качеством. |
exact_quality_required | Необязательный параметр. Указывает, следует ли требовать точного качества изображений. Если установлено значение false, поле |
experiments[] | Необязательно. Указывает, какие предварительные эксперименты следует включить. Запросы, использующие это поле, классифицируются как предварительные предложения в соответствии с условиями предоставления услуг платформы Google Maps . Дополнительные сведения см. в описаниях этапов запуска . |
additional_insights[] | Необязательно. Список |
GetDataLayersRequest
Сообщение запроса для Solar.GetDataLayers .
| Поля | |
|---|---|
location | Обязательно. Укажите долготу и широту центра региона, для которого нужны данные. |
radius_meters | Обязательно. Радиус в метрах, определяющий область вокруг центральной точки, для которой должны быть возвращены данные. Ограничения по этому значению:
|
view | Необязательный параметр. Желаемое подмножество данных для возврата. |
required_quality | Необязательно. Минимально допустимый уровень качества результатов. Результаты с более низким качеством не будут возвращены. Неуказание этого параметра означает ограничение только ВЫСОКИМ качеством. |
pixel_size_meters | Необязательный параметр. Минимальный масштаб возвращаемых данных в метрах на пиксель. Поддерживаются значения 0,1 (по умолчанию, если это поле не задано явно), 0,25, 0,5 и 1,0. Компоненты изображения, нормальное разрешение которых меньше |
exact_quality_required | Необязательный параметр. Указывает, следует ли требовать точного качества изображений. Если установлено значение false, поле |
experiments[] | Необязательно. Указывает, какие предварительные эксперименты следует включить. Запросы, использующие это поле, классифицируются как предварительные предложения в соответствии со Специфическими условиями использования сервиса платформы Google Maps . Дополнительную информацию см. в [описаниях этапов запуска]( https://cloud.google.com/maps-platform/terms/launch-stages ). |
GetGeoTiffRequest
Запрос сообщения для Solar.GetGeoTiff .
| Поля | |
|---|---|
id | Обязательно. Идентификатор запрашиваемого актива. |
Качество изображения
Качество изображений, использованных для вычисления результата API.
Примечание: Независимо от уровня качества изображения, выходные данные цифровой модели рельефа (ЦМР) всегда имеют разрешение 0,1 м/пиксель, ежемесячные данные о потоке всегда имеют разрешение 0,5 м/пиксель, а почасовые данные о затенении всегда имеют разрешение 1 м/пиксель.
| Перечисления | |
|---|---|
IMAGERY_QUALITY_UNSPECIFIED | Качество неизвестно. |
HIGH | Данные о солнечной активности получены из аэрофотоснимков, снятых на малой высоте и обработанных с разрешением 0,1 м/пиксель. |
MEDIUM | Данные о солнечной активности получены из улучшенных аэрофотоснимков, снятых на большой высоте и обработанных с разрешением 0,25 м/пиксель. |
LOW | Данные о солнечной активности получены из улучшенных спутниковых снимков, обработанных с разрешением 0,25 м/пиксель. |
BASE | Данные о солнечной активности получены из улучшенных спутниковых снимков, обработанных с разрешением 0,25 м/пиксель. |
LatLngBox
Ограничивающий прямоугольник в координатах широты и долготы.
| Поля | |
|---|---|
sw | Юго-западный угол коробки. |
ne | Северо-восточный угол коробки. |
Лизинговые сбережения
Затраты и выгоды от аренды определенной конфигурации солнечных панелей при определенном потреблении электроэнергии.
| Поля | |
|---|---|
leases_allowed | Разрешена ли аренда в данной юрисдикции (в некоторых штатах аренда запрещена). Если значение этого поля равно false, то значения в этом сообщении, вероятно, следует игнорировать. |
leases_supported | Поддерживается ли в данной юрисдикции лизинг финансовым расчетным механизмом. Если это поле имеет значение false, то значения в этом сообщении, вероятно, следует игнорировать. Это не зависит от |
annual_leasing_cost | Ориентировочная годовая стоимость лизинга. |
savings | Сколько средств будет сэкономлено (или нет) за весь период жизни. |
RoofSegmentSizeAndSunshineStats
Информация о размерах и квантилях солнечной освещенности участка крыши.
| Поля | |
|---|---|
stats | Общая площадь и квантили солнечного света для сегмента крыши. |
center | Точка, расположенная вблизи центра сегмента крыши. |
bounding_box | Ограничивающий прямоугольник сегмента крыши. |
pitch_degrees | Угол наклона сегмента крыши относительно теоретической плоскости земли. 0 = параллельно земле, 90 = перпендикулярно земле. |
azimuth_degrees | Направление по компасу, в котором указывает сегмент крыши. 0 = Север, 90 = Восток, 180 = Юг. Для "плоского" сегмента крыши ( |
plane_height_at_center_meters | Высота плоскости сегмента крыши в метрах над уровнем моря в точке, обозначенной как |
Сводка сегмента крыши
Информация об участке крыши здания, на котором размещено некоторое количество панелей.
| Поля | |
|---|---|
panels_count | Общее количество панелей в этом сегменте. |
yearly_energy_dc_kwh | Какое количество солнечной энергии улавливает эта часть конструкции в течение года, в кВт·ч постоянного тока, при условии использования панелей, описанных выше. |
pitch_degrees | Угол наклона сегмента крыши относительно теоретической плоскости земли. 0 = параллельно земле, 90 = перпендикулярно земле. |
azimuth_degrees | Направление по компасу, в котором указывает сегмент крыши. 0 = Север, 90 = Восток, 180 = Юг. Для "плоского" сегмента крыши ( |
segment_index | Индекс в |
Экономия с течением времени
Финансовая информация, которой обмениваются различные методы финансирования.
| Поля | |
|---|---|
savings_year1 | Экономия в первый год после установки панелей. |
savings_year20 | Экономия в первые двадцать лет после установки панелей. |
present_value_of_savings_year20 | Используя предполагаемую ставку дисконтирования, какова текущая стоимость совокупной 20-летней экономии? |
savings_lifetime | Экономия на протяжении всего срока службы панели. |
present_value_of_savings_lifetime | Используя предполагаемую ставку дисконтирования, определите текущую стоимость совокупных сбережений за весь период инвестирования. |
financially_viable | Указывает, является ли данный сценарий финансово жизнеспособным. Будет ложным для сценариев с низкой финансовой жизнеспособностью (например, убыточных). |
SizeAndSunshineStats
Квантили размера и освещенности крыши или ее части.
| Поля | |
|---|---|
area_meters2 | Площадь крыши или сегмента крыши в м². Это площадь крыши (с учетом наклона), а не площадь основания здания. |
sunshine_quantiles[] | Квантили точечного уровня солнечной активности на данной территории. Если здесь N значений, это представляет собой (N-1)-йли. Например, если здесь 5 значений, то это будут квартили (мин, 25%, 50%, 75%, макс). Значения указаны в кВт·ч/кВт в годовом исчислении, например, |
ground_area_meters2 | Площадь основания, покрытая крышей или сегментом крыши, в м². |
Солнечная панель
Параметр SolarPanel описывает положение, ориентацию и производительность одной солнечной панели. Информацию о параметрах панели можно найти в полях panel_height_meters , panel_width_meters и panel_capacity_watts в SolarPotential .
| Поля | |
|---|---|
center | Центр панели. |
orientation | Ориентация панели. |
yearly_energy_dc_kwh | Какое количество солнечной энергии улавливает данная схема в течение года, в кВт·ч постоянного тока. |
segment_index | Индекс в |
SolarPanelConfig
В описании SolarPanelConfig представлен конкретный вариант размещения солнечных панелей на крыше.
| Поля | |
|---|---|
panels_count | Общее количество панелей. Обратите внимание, что это избыточно по отношению к (сумме) соответствующих полей в |
yearly_energy_dc_kwh | Какое количество солнечной энергии улавливает данная схема в течение года, в кВт·ч постоянного тока, при условии использования панелей, описанных выше. |
roof_segment_summaries[] | Информация о производстве каждого сегмента крыши, несущего хотя бы одну панель в данной компоновке. |
Ориентация солнечных панелей
Ориентация солнечной панели. Ее необходимо интерпретировать относительно азимута участка крыши, на котором установлена панель.
| Перечисления | |
|---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED | Ориентация панелей неизвестна. |
LANDSCAPE | У LANDSCAPE панели длинная сторона перпендикулярна азимуту сегмента крыши, на котором она установлена. |
PORTRAIT | У PORTRAIT панели длинная сторона параллельна азимуту сегмента крыши, на котором она размещена. |
Солнечный потенциал
Информация о солнечном потенциале здания. Ряд полей в этой информации определяется с помощью «панелей». Поля panel_capacity_watts , panel_height_meters и panel_width_meters описывают параметры модели панели, используемой в этих расчетах.
| Поля | |
|---|---|
max_array_panels_count | Максимальный размер массива — то есть максимальное количество панелей, которое может поместиться на крыше. |
panel_capacity_watts | Мощность панели, в ваттах, использованной в расчетах. |
panel_height_meters | Высота панели, использованной в расчетах, в метрах в вертикальной ориентации. |
panel_width_meters | Ширина панели, используемой в расчетах, в метрах в вертикальной ориентации. |
panel_lifetime_years | Ожидаемый срок службы солнечных панелей в годах. Этот показатель используется в финансовых расчетах. |
max_array_area_meters2 | Размер максимальной конфигурации массива в квадратных метрах. |
max_sunshine_hours_per_year | Максимальное количество солнечных часов, получаемых любой точкой на крыше в год. Солнечные часы — это показатель общего количества солнечной радиации (энергии), получаемой за год. 1 солнечный час = 1 кВт·ч на кВт (где кВт обозначает кВт мощности в стандартных условиях испытаний). |
carbon_offset_factor_kg_per_mwh | Эквивалентное количество CO2, производимое на 1 МВт·ч электроэнергии из сети. Это показатель углеродной интенсивности электроэнергии из сети, замещаемой солнечной электроэнергией. |
whole_roof_stats | Общая площадь и квантили солнечного света для той части крыши, которая была отнесена к определенному сегменту. Несмотря на название, это может не включать все здание целиком. См. |
building_stats | Размеры и квантили солнечного света для всего здания, включая части крыши, не отнесенные к какому-либо сегменту. Поскольку ориентация этих частей недостаточно хорошо охарактеризована, оценка площади крыши является ненадежной, в то время как оценка площади земли является надежной. Возможно, более надежную оценку площади крыши всего здания можно получить, масштабируя площадь крыши из |
roof_segment_stats[] | Размер и количество солнечного света для каждого сегмента крыши. |
solar_panels[] | Каждая |
solar_panel_configs[] | Каждый |
financial_analyses[] | Раздел |