Package google.maps.solar.v1

Индекс

• Solar (интерфейс)
• BuildingInsights (сообщение)
• CashPurchaseSavings (сообщение)
• DataLayerView (перечисление)
• DataLayers (сообщение)
• FinancedPurchaseSavings (сообщение)
• FinancialAnalysis (сообщение)
• FinancialDetails (сообщение)
• FindClosestBuildingInsightsRequest (сообщение)
• GetDataLayersRequest (сообщение)
• GetGeoTiffRequest (сообщение)
• ImageryQuality (перечисление)
• LatLngBox (сообщение)
• LeasingSavings (сообщение)
• RoofSegmentSizeAndSunshineStats (сообщение)
• RoofSegmentSummary (сообщение)
• SavingsOverTime (сообщение)
• SizeAndSunshineStats (сообщение)
• SolarPanel (сообщение)
• SolarPanelConfig (сообщение)
• SolarPanelOrientation (перечисление)
• SolarPotential (сообщение)

Солнечная

Определение сервиса для Solar API.

Найти ближайшее зданиеInsights
rpc FindClosestBuildingInsights( FindClosestBuildingInsightsRequest ) returns ( BuildingInsights ) Находит здание, центроид которого находится ближе всего к точке запроса. Возвращает ошибку с кодом NOT_FOUND , если в радиусе примерно 50 м от точки запроса нет зданий. Области авторизации Требуется следующая область действия OAuth: https://www.googleapis.com/auth/cloud-platform

GetDataLayers
rpc GetDataLayers( GetDataLayersRequest ) returns ( DataLayers ) Получает информацию о солнечной радиации для региона, окружающего данное местоположение. Возвращает ошибку с кодом NOT_FOUND , если местоположение находится за пределами зоны покрытия. Области авторизации Требуется следующая область действия OAuth: https://www.googleapis.com/auth/cloud-platform

GetGeoTiff
rpc GetGeoTiff( GetGeoTiffRequest ) returns ( HttpBody ) Возвращает изображение по его идентификатору. Области авторизации Требуется следующая область действия OAuth: https://www.googleapis.com/auth/cloud-platform

BuildingInsights

Ответное сообщение для Solar.FindClosestBuildingInsights . Информация о местоположении, размерах и солнечном потенциале здания.

Поля
name	string Имя ресурса для здания в формате buildings/{place_id} .
center	LatLng Точка рядом с центром здания.
bounding_box	LatLngBox Ограничивающая рамка здания.
imagery_date	Date Дата получения основного изображения. Это приблизительно.
imagery_processed_date	Date Когда обработка этого изображения была завершена.
postal_code	string Почтовый индекс (например, почтовый индекс США), под которым находится это здание.
administrative_area	string Административная зона 1 (например, в штате США), в которой находится это здание. Например, в США аббревиатура может быть «MA» или «CA».
statistical_area	string Статистическая область (например, переписной участок США), в которой находится это здание.
region_code	string Код региона страны (или региона), в котором находится это здание.
solar_potential	SolarPotential Солнечный потенциал здания.
imagery_quality	ImageryQuality Качество изображений, использованных для расчета данных для этого здания.

НаличныеПокупкаЭкономия

Стоимость и выгода от прямой покупки солнечной панели определенной конфигурации с определенным потреблением электроэнергии.

Поля
out_of_pocket_cost	Money Первоначальная стоимость до налоговых льгот: сумма, которая должна быть выплачена из собственного кармана. Сравните с upfront_cost , который применяется после налоговых льгот.
upfront_cost	Money Первоначальная стоимость после налоговых льгот: это сумма, которую необходимо выплатить в течение первого года. Сравните с out_of_pocket_cost , который учитывается до налоговых льгот.
rebate_value	Money Величина всех налоговых льгот.
savings	SavingsOverTime Сколько сэкономлено (или нет) за период жизни.
payback_years	float Количество лет до наступления окупаемости. Отрицательное значение означает, что окупаемость никогда не происходит в течение срока службы.

DataLayerView

Какую часть солнечной информации вернуть.

Перечисления
DATA_LAYER_VIEW_UNSPECIFIED	Эквивалент ПОЛНОГО.
DSM_LAYER	Берите только DSM.
IMAGERY_LAYERS	Возьмите DSM, RGB и маску.
IMAGERY_AND_ANNUAL_FLUX_LAYERS	Получите DSM, 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	Date Когда были получены исходные изображения (из которых получены все остальные данные) в этом регионе. Это обязательно приблизительное значение, поскольку изображения могли быть сделаны более чем за один день.
imagery_processed_date	Date Когда обработка этого изображения была завершена.
dsm_url	string URL-адрес изображения DSM (цифровой модели поверхности) региона. Значения указаны в метрах над геоидом EGM96 (т. е. над уровнем моря). Неверные местоположения (по которым у нас нет данных) сохраняются как -9999.
rgb_url	string URL-адрес изображения данных RGB (аэрофотосъемки) региона.
mask_url	string URL-адрес изображения маски здания: один бит на пиксель, указывающий, считается ли этот пиксель частью крыши или нет.
annual_flux_url	string URL-адрес годовой карты потоков (годового солнечного света на крышах) региона. Значения указаны в кВтч/кВт/год. Это немаскированный поток : поток рассчитывается для каждого места, а не только для крыш зданий. Недопустимые местоположения сохраняются как -9999: местоположения за пределами нашей зоны покрытия будут недействительными, а несколько местоположений внутри зоны покрытия, где мы не смогли рассчитать поток, также будут недействительными.
monthly_flux_url	string URL-адрес ежемесячной карты потоков (солнечный свет на крышах с разбивкой по месяцам) региона. Значения указаны в кВтч/кВт/год. GeoTIFF, на который указывает этот URL-адрес, будет содержать двенадцать полос, соответствующих январю...декабрю, по порядку.
hourly_shade_urls[]	string Двенадцать URL-адресов для почасовой тени, соответствующих январю...декабрю, по порядку. Каждый GeoTIFF будет содержать 24 полосы, соответствующие 24 часам суток. Каждый пиксель представляет собой 32-битное целое число, соответствующее (до) 31 дня этого месяца; 1 бит означает, что в соответствующем месте можно увидеть солнце в этот день, в этот час, в этом месяце. Недопустимые местоположения сохраняются как -9999 (поскольку это значение отрицательное, для него установлен бит 31, и ни для одного допустимого значения не может быть установлен бит 31, поскольку это соответствует 32-му дню месяца). Пример может быть полезен. Если вы хотите узнать, видела ли точка (в месте пикселя (x, y)) солнце в 16:00 22 июня, вы должны: получите шестой URL-адрес в этом списке (соответствует июню). посмотрите 17-й канал (соответствует 16:00). прочитайте 32-битное значение по адресу (x, y). прочитайте бит 21 значения (соответствует 22-му числу месяца). если этот бит равен 1, то это место увидело солнце в 16:00 22 июня. Более формально: учитывая month (1-12), day (максимум 1...месяц; в феврале 28 дней) и hour (0-23), тень/солнце для этого месяца/дня/часа в позиции (x, y) является битом. (hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1)) где (x, y) — пространственная индексация, [month - 1] означает получение URL-адреса month - 1 (индексация с нуля), [hour] — индексация каналов, а конечный ненулевой результат означает «солнечно». Здесь нет високосных дней и не существует летнего времени (все дни длятся 24 часа; полдень всегда является «стандартным временем»).
imagery_quality	ImageryQuality Качество изображения результата.

ПрофинансированоПокупкаСбережения

Стоимость и выгода от использования кредита на покупку солнечной панели определенной конфигурации с определенным потреблением электроэнергии.

Поля
annual_loan_payment	Money Ежегодные выплаты по кредиту.
rebate_value	Money Стоимость всех налоговых льгот (включая федеральный инвестиционный налоговый кредит (ITC)).
loan_interest_rate	float Процентная ставка по кредитам принята в данном наборе расчетов.
savings	SavingsOverTime Сколько сэкономлено (или нет) за период жизни.

ФинансовыйАнализ

Анализ затрат и преимуществ оптимальной схемы расположения солнечных батарей при конкретном размере счета за электроэнергию.

Поля
monthly_bill	Money Ежемесячный счет за электроэнергию, который предполагается в этом анализе.
default_bill	bool Является ли этот размер счета выбранным в качестве счета по умолчанию для района, в котором находится это здание. Ровно один FinancialAnalysis в BuildingSolarPotential должен иметь установленный параметр default_bill .
average_kwh_per_month	float Сколько электроэнергии дом потребляет в среднем в месяц, в зависимости от размера счета и местных тарифов на электроэнергию.
financial_details	FinancialDetails Финансовая информация, применимая независимо от используемого метода финансирования.
leasing_savings	LeasingSavings Стоимость и выгода от аренды солнечных панелей.
cash_purchase_savings	CashPurchaseSavings Стоимость и выгода от покупки солнечных панелей за наличные.
financed_purchase_savings	FinancedPurchaseSavings Стоимость и выгода от покупки солнечных панелей за счет финансирования покупки.
panel_config_index	int32 Индекс в solar_panel_configs оптимальной схемы расположения солнечных батарей для данного размера счета. Это может быть -1, указывающее на отсутствие макета. В этом случае остальные подсообщения будут опущены.

Финансовые детали

Подробности финансового анализа. Некоторые из этих деталей уже хранятся на более высоких уровнях (например, наличные расходы). Общие денежные суммы относятся к периоду жизни, определенному полем panel_lifetime_years в SolarPotential . Примечание. Собственные затраты на приобретение панелей указаны в поле out_of_pocket_cost в CashPurchaseSavings .

Поля
initial_ac_kwh_per_year	float Сколько кВтч переменного тока, по нашему мнению, выработают солнечные панели в первый год их эксплуатации.
remaining_lifetime_utility_bill	Money Счет за коммунальные услуги за электроэнергию, не производимую солнечной энергией, в течение всего срока службы панелей.
federal_incentive	Money Сумма денег, доступная в виде федеральных льгот; это применимо, если пользователь покупает (в кредит или без него) панели.
state_incentive	Money Сумма денег, получаемая от государственных стимулов; это применимо, если пользователь покупает (в кредит или без него) панели.
utility_incentive	Money Сумма денег, получаемая от стимулирования коммунальных услуг; это применимо, если пользователь покупает (в кредит или без него) панели.
lifetime_srec_total	Money Сумма денег, которую пользователь получит в виде кредитов на солнечную возобновляемую энергию в течение срока службы панели; это применимо, если пользователь покупает (в кредит или без него) панели.
cost_of_electricity_without_solar	Money Общая стоимость электроэнергии, которую пользователь заплатил бы за весь срок службы, если бы он не установил солнечную энергию.
net_metering_allowed	bool Разрешены ли чистые измерения.
solar_percentage	float Процент (0–100) энергии пользователя, поставляемой солнечной энергией. Действительно в течение первого года, но приблизительно верно для будущих лет.
percentage_exported_to_grid	float Предполагаемый процент (0–100) производства солнечной электроэнергии был экспортирован в сеть, исходя из объема производства в первом квартале. Это влияет на расчеты, если нетто-замеры не разрешены.

НайтиClosestBuildingInsightsRequest

Сообщение запроса для Solar.FindClosestBuildingInsights .

Поля
location	LatLng Необходимый. Долгота и широта, на которых API ищет ближайшее известное здание.
required_quality	ImageryQuality Необязательный. Минимальный уровень качества, разрешенный в результатах. Никакой результат с более низким качеством, чем этот, не будет возвращен. Отсутствие указания этого параметра эквивалентно ограничению только ВЫСОКОГО качества.

Запрос GetDataLayersRequest

Сообщение запроса для Solar.GetDataLayers .

Поля
location	LatLng Необходимый. Долгота и широта центра региона, для которого нужно получить данные.
radius_meters	float Необходимый. Радиус в метрах, определяющий область вокруг центральной точки, для которой должны быть возвращены данные. Ограничения на это значение: Всегда можно указать любое значение до 100 м. Можно указать значения более 100 м, если radius_meters <= pixel_size_meters * 1000 . Однако для значений более 175 м DataLayerView в запросе не должен включать ежемесячный поток или почасовую тень.
view	DataLayerView Необязательный. Желаемое подмножество возвращаемых данных.
required_quality	ImageryQuality Необязательный. Минимальный уровень качества, разрешенный в результатах. Никакой результат с более низким качеством, чем этот, не будет возвращен. Отсутствие указания этого параметра эквивалентно ограничению только ВЫСОКОГО качества.
pixel_size_meters	float Необязательный. Минимальный масштаб возвращаемых данных в метрах на пиксель. Поддерживаются значения 0,1 (по умолчанию, если это поле не задано явно), 0,25, 0,5 и 1,0. Компоненты изображений, нормальное разрешение которых меньше, чем pixel_size_meters будут возвращены с разрешением, указанным в pixel_size_meters ; Компоненты изображений, нормальное разрешение которых равно или больше, чем pixel_size_meters , будут возвращены с этим нормальным разрешением.
exact_quality_required	bool Необязательный. Требуется ли точное качество изображения. Если установлено значение false, поле required_quality интерпретируется как минимально требуемое качество, так что изображения ВЫСОКОГО качества могут быть возвращены, когда required_quality установлено значение СРЕДНЕЕ. Если установлено значение true, required_quality интерпретируется как точное требуемое качество, и возвращаются только изображения MEDIUM качества, если для required_quality установлено значение MEDIUM .

GetGeoTiffRequest

Сообщение запроса для Solar.GetGeoTiff .

Поля
id	string Необходимый. Идентификатор запрашиваемого актива.

ИзображениеКачество

Качество изображений, используемых для вычисления некоторых результатов API.

Примечание. Независимо от уровня качества изображения, выходные данные DSM всегда имеют разрешение 0,1 м/пиксель, ежемесячные выходные данные потока всегда имеют разрешение 0,5 м/пиксель, а почасовые выходные данные всегда имеют разрешение 1 м/пиксель.

Перечисления
IMAGERY_QUALITY_UNSPECIFIED	Качество неизвестно.
HIGH	Солнечные данные получены на основе аэрофотоснимков, снятых на малой высоте и обработанных с разрешением 0,1 м/пиксель.
MEDIUM	Солнечные данные получены на основе улучшенных аэрофотоснимков, снятых на большой высоте и обработанных с разрешением 0,25 м/пиксель.
LOW	Солнечные данные получены на основе улучшенных спутниковых изображений, обработанных с разрешением 0,25 м/пиксель.
BASE	Солнечные данные получены на основе улучшенных спутниковых изображений, обработанных с разрешением 0,25 м/пиксель.

LatLngBox

Ограничивающая рамка в координатах широты и долготы.

Поля
sw	LatLng Юго-западный угол коробки.
ne	LatLng Северо-восточный угол коробки.

ЛизингСбережения

Стоимость и выгода от аренды солнечной панели определенной конфигурации с определенным потреблением электроэнергии.

Поля
leases_allowed	bool Разрешена ли аренда в этой юрисдикции (аренда не разрешена в некоторых штатах). Если это поле имеет значение false, то значения в этом сообщении, вероятно, следует игнорировать.
leases_supported	bool Поддерживается ли аренда в этой юрисдикции системой финансовых расчетов. Если это поле имеет значение false, то значения в этом сообщении, вероятно, следует игнорировать. Это не зависит от leases_allowed : в некоторых областях аренда разрешена, но на условиях, которые не учитываются финансовыми моделями.
annual_leasing_cost	Money Ориентировочная стоимость годовой аренды.
savings	SavingsOverTime Сколько сэкономлено (или нет) за период жизни.

КрышаСегментРазмерИСаншайнСтатистика

Информация о размере и квантилях солнечности сегмента крыши.

Поля
stats	SizeAndSunshineStats Общий размер и квантили солнечного света для сегмента крыши.
center	LatLng Точка рядом с центром сегмента крыши.
bounding_box	LatLngBox Ограничивающая рамка сегмента крыши.
pitch_degrees	float Угол сегмента крыши относительно теоретической плоскости земли. 0 = параллельно земле, 90 = перпендикулярно земле.
azimuth_degrees	float Направление компаса, на которое указывает сегмент крыши. 0 = север, 90 = восток, 180 = юг. Для «плоского» сегмента крыши ( pitch_degrees очень близко к 0) азимут не определен точно, поэтому для единообразия мы произвольно определяем его как 0 (север).
plane_height_at_center_meters	float Высота плоскости сегмента крыши в метрах над уровнем моря в точке, обозначенной center . Вместе с уклоном, азимутом и расположением центра это полностью определяет плоскость сегмента крыши.

RoofSegmentСводка

Информация об участке крыши здания, на котором размещено некоторое количество панелей.

Поля
panels_count	int32 Общее количество панелей в этом сегменте.
yearly_energy_dc_kwh	float Сколько солнечной энергии эта часть планировки улавливает в течение года, в кВтч постоянного тока, при условии использования панелей, описанных выше.
pitch_degrees	float Угол сегмента крыши относительно теоретической плоскости земли. 0 = параллельно земле, 90 = перпендикулярно земле.
azimuth_degrees	float Направление компаса, на которое указывает сегмент крыши. 0 = север, 90 = восток, 180 = юг. Для «плоского» сегмента крыши ( pitch_degrees очень близко к 0) азимут не определен точно, поэтому для единообразия мы произвольно определяем его как 0 (север).
segment_index	int32 Индекс в roof_segment_stats соответствующего RoofSegmentSizeAndSunshineStats .

Экономия сверхурочных

Финансовая информация, которая используется различными методами финансирования.

Поля
savings_year1	Money Экономия в первый год после установки панели.
savings_year20	Money Экономия в первые двадцать лет после установки панели.
present_value_of_savings_year20	Money Используя предполагаемую ставку дисконтирования, какова текущая стоимость совокупных 20-летних сбережений?
savings_lifetime	Money Экономия в течение всего срока службы панели.
present_value_of_savings_lifetime	Money Используя предполагаемую ставку дисконтирования, какова текущая стоимость совокупных сбережений за всю жизнь?
financially_viable	bool Указывает, является ли этот сценарий финансово жизнеспособным. Будет ложным для сценариев с плохой финансовой жизнеспособностью (например, убыточных).

РазмерИСаншайнСтатистика

Квантили размера и солнечности крыши или ее части.

Поля
area_meters2	float Площадь крыши или сегмента крыши, м^2. Это площадь крыши (с учетом наклона), а не площадь основания.
sunshine_quantiles[]	float Квантили точечной солнечности по площади. Если здесь есть N значений, это представляет собой (N-1)-файлы. Например, если имеется 5 значений, это будут квартили (мин, 25 %, 50 %, 75 %, максимум). Значения указаны в годовых кВтч/кВт, например max_sunshine_hours_per_year .
ground_area_meters2	float Площадь основания, занимаемая крышей или ее сегментом, в м^2.

Солнечная Панель

SolarPanel описывает положение, ориентацию и производство одной солнечной панели. См. поля panel_height_meters , panel_width_meters и panel_capacity_watts в SolarPotential для получения информации о параметрах панели.

Поля
center	LatLng Центр панели.
orientation	SolarPanelOrientation Ориентация панели.
yearly_energy_dc_kwh	float Сколько солнечной энергии эта планировка улавливает в течение года, в кВтч постоянного тока.
segment_index	int32 Индекс в roof_segment_stats объекта RoofSegmentSizeAndSunshineStats , который соответствует сегменту крыши, на котором размещена эта панель.

СоларПанелКонфиг

SolarPanelConfig описывает конкретное размещение солнечных панелей на крыше.

Поля
panels_count	int32 Общее количество панелей. Обратите внимание, что это избыточно для (суммы) соответствующих полей в roof_segment_summaries .
yearly_energy_dc_kwh	float Сколько солнечной энергии эта планировка улавливает в течение года, в кВтч постоянного тока, при условии использования панелей, описанных выше.
roof_segment_summaries[]	RoofSegmentSummary Информация о производстве каждого сегмента крыши, несущего хотя бы одну панель в данной компоновке. roof_segment_summaries[i] описывает i-й сегмент крыши, включая его размер, ожидаемую производительность и ориентацию.

СолнечнаяПанельОриентация

Ориентация солнечной панели. Это значение следует интерпретировать относительно азимута сегмента крыши, на котором расположена панель.

Перечисления
SOLAR_PANEL_ORIENTATION_UNSPECIFIED	Ориентация панели неизвестна.
LANDSCAPE	Длинный край панели LANDSCAPE перпендикулярен азимутальному направлению сегмента крыши, на котором она расположена.
PORTRAIT	Длинный край панели PORTRAIT параллелен азимутальному направлению сегмента крыши, на котором она расположена.

СолнечныйПотенциал

Информация о солнечном потенциале здания. Ряд полей здесь определяется как «панели». Поля panel_capacity_watts , panel_height_meters и panel_width_meters описывают параметры модели панели, используемой в этих расчетах.

Поля
max_array_panels_count	int32 Размер максимального массива – то есть максимальное количество панелей, которое может поместиться на крыше.
panel_capacity_watts	float Мощность панели, использованной в расчетах, в ваттах.
panel_height_meters	float Высота панели, используемой в расчетах, в метрах в книжной ориентации.
panel_width_meters	float Ширина панели, используемой в расчетах, в метрах в книжной ориентации.
panel_lifetime_years	int32 Ожидаемый срок службы солнечных панелей в годах. Это используется в финансовых расчетах.
max_array_area_meters2	float Размер максимального массива в квадратных метрах.
max_sunshine_hours_per_year	float Максимальное количество солнечных часов в год в любой точке крыши. Солнечные часы являются мерой общего количества инсоляции (энергии), полученной за год. 1 час солнечного света = 1 кВтч на кВт (где «кВт» относится к кВт мощности в стандартных условиях испытаний).
carbon_offset_factor_kg_per_mwh	float Эквивалентное количество CO2, произведенное на МВт электроэнергии из сети. Это показатель углеродоемкости сетевой электроэнергии, вытесняемой солнечной электроэнергией.
whole_roof_stats	SizeAndSunshineStats Общий размер и квантили солнечного света для части крыши, отнесенной к какому-либо сегменту крыши. Несмотря на название, сюда может входить не все здание. См. building_stats .
building_stats	SizeAndSunshineStats Размер и квантили солнечного света для всего здания, включая части крыши, которые не были отнесены к какому-либо сегменту крыши. Поскольку ориентация этих частей не совсем точно определена, оценка площади крыши ненадежна, но оценка площади земли надежна. Возможно, более надежную площадь крыши всего здания можно получить, масштабируя площадь крыши из whole_roof_stats по соотношению площадей земли в building_stats и whole_roof_stats .
roof_segment_stats[]	RoofSegmentSizeAndSunshineStats Размер и квантили солнечного света для каждого сегмента крыши.
solar_panels[]	SolarPanel Каждая SolarPanel описывает одну солнечную панель. Они перечислены в том порядке, в котором это разместил алгоритм компоновки панели. Обычно, хотя и не всегда, это происходит в порядке убывания годового производства энергии.
solar_panel_configs[]	SolarPanelConfig Каждый SolarPanelConfig описывает различное расположение солнечных панелей на крыше. Они расположены в порядке увеличения количества панелей. SolarPanelConfig с panels_count =N основан на первых N панелях в списке solar_panels . Это поле заполняется только в том случае, если на крыше может поместиться как минимум 4 панели.
financial_analyses[]	FinancialAnalysis FinancialAnalysis показывает экономию от перехода на солнечную энергию при условии определенного ежемесячного счета и данного поставщика электроэнергии. Они расположены в порядке возрастания суммы ежемесячного счета. Это поле будет пустым для зданий в районах, для которых у Solar API недостаточно информации для выполнения финансовых расчетов.