{"uid":"cap_sQVNoGbsoClbWWGAD5E8b","slug":"google-solar-api-building-insights-5adc144d","name":"Google Solar API - Building Insights","description":"Google Solar API - Closest building roof insights including imageryDate","url":"https://stable-enrich-git-stableenrich-solar-aerial-merit-systems.vercel.app/api/google-maps/solar/building-insights","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["latitude","longitude","requiredQuality"],"properties":{"latitude":{"type":"number","maximum":90,"minimum":-90},"longitude":{"type":"number","maximum":180,"minimum":-180},"requiredQuality":{"enum":["LOW","MEDIUM","HIGH"],"type":"string","default":"HIGH"}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"latitude":37.4226,"longitude":-122.0841,"requiredQuality":"HIGH"}}},"response":{"_bytes":262144,"_preview":"{\"name\":\"buildings/ChIJj38IfwK6j4ARNcyPDnEGa9g\",\"center\":{\"latitude\":37.422357999999996,\"longitude\":-122.08408390000001},\"imageryDate\":{\"year\":2024,\"month\":9,\"day\":24},\"postalCode\":\"94043\",\"administrativeArea\":\"CA\",\"statisticalArea\":\"06085504601\",\"regionCode\":\"US\",\"solarPotential\":{\"maxArrayPanelsCount\":2141,\"maxArrayAreaMeters2\":4203.971,\"maxSunshineHoursPerYear\":1865.2908,\"carbonOffsetFactorKgPerMwh\":428.9201,\"wholeRoofStats\":{\"areaMeters2\":6845.8604,\"sunshineQuantiles\":[245.05995,1047.143,1323.2688,1496.5316,1599.3007,1653.1436,1708.1002,1739.7714,1759.9373,1787.0889,1974.0725],\"groundAreaMeters2\":6748.4},\"roofSegmentStats\":[{\"pitchDegrees\":6.3311257,\"azimuthDegrees\":4.5544605,\"stats\":{\"areaMeters2\":729.78076,\"sunshineQuantiles\":[298.72693,1584.8988,1605.5951,1622.097,1651.2899,1688.6842,1718.9486,1734.392,1743.5645,1756.4144,1974.0725],\"groundAreaMeters2\":725.33},\"center\":{\"latitude\":37.422410899999996,\"longitude\":-122.0845116},\"boundingBox\":{\"sw\":{\"latitude\":37.422286,\"longitude\":-122.0847329},\"ne\":{\"latitude\":37.4225699,\"longitude\":-122.08415319999999}},\"planeHeightAtCenterMeters\":20.483677},{\"pitchDegrees\":0.51474154,\"azimuthDegrees\":0,\"stats\":{\"areaMeters2\":608.02454,\"sunshineQuantiles\":[256.5864,1142.2877,1499.6564,1654.3973,1723.8121,1749.9177,1761.7933,1769.1763,1775.4457,1784.0206,1922.1343],\"groundAreaMeters2\":608},\"center\":{\"latitude\":37.422396899999995,\"longitude\":-122.08363479999998},\"boundingBox\":{\"sw\":{\"latitude\":37.422275299999995,\"longitude\":-122.08386850000001},\"ne\":{\"latitude\":37.422504599999996,\"longitude\":-122.08334589999998}},\"planeHeightAtCenterMeters\":16.226517},{\"pitchDegrees\":0.596276,\"azimuthDegrees\":0,\"stats\":{\"areaMeters2\":438.84378,\"sunshineQuantiles\":[258.03476,1271.8414,1500.7269,1629.8618,1690.5566,1731.3578,1748.288,1758.4117,1768.6073,1788.3866,1946.4106],\"groundAreaMeters2\":438.82},\"center\":{\"latitude\":37.4225412,\"longitude\":-122.08387379999999},\"boundingBox\":{\"sw\":{\"latitude\":37.4223536,\"longitude\":-122.0841953},\"ne\":{\"latitud","_truncated":true,"_contentType":"application/json"}},"exampleRequest":{"latitude":37.4226,"longitude":-122.0841,"requiredQuality":"HIGH"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HjGAYSf8tmIk-ZK-VR5sy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns rooftop solar potential insights for the closest building to a given latitude/longitude, including imagery date and roof segmentation data.","exampleAgentPrompt":"Can you get the Google Solar building insights for the property at latitude 37.4226 and longitude -122.0841, using HIGH quality imagery, so I can see the rooftop solar potential and the imagery date?","exampleUseCases":null,"resultDescription":"Returns building roof insights for the closest building to the specified coordinates, including roof segmentation details, solar panel potential, annual energy production estimates, and the imageryDate indicating when the aerial imagery was captured.","failureModes":["No building found near the specified coordinates returns an error or empty result","requiredQuality level not available for the location returns a quality mismatch error","Invalid latitude/longitude values (out of range) return a 400 validation error","Location outside Google Solar API coverage area returns a not-found error","Payment failure via x402 protocol results in 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need rooftop solar potential data and building insights for a specific geographic coordinate. Prefer this over the data layers endpoint when you want structured insights (roof segments, panel counts, energy estimates) rather than raw GeoTIFF imagery files. Best for solar feasibility assessments, energy audits, or real estate solar evaluations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:35:49.797Z","isFirstParty":false}