Grasshopper Docs

Community documentation for Grasshopper add-ons & plugins

0 | Ladybug
1 | AnalyzeWeatherData
2 | VisualizeWeatherData
3 | EnvironmentalAnalysis
4 | Renewables
5 | Extra
6 | Developers
7 | WIP

This component uses Google Maps API to achieve elevation data and satellite images of the terrain generated.
This component requires an internet connection and it runs for free up to 2,500 requests per day. Once you go over this limit the component doesn't work.
Note that each surface is a request, for example if you use a surface made by sub-surfaces 6x6, this will be 36 requests.
For informations about the rules of use of Google Maps API, take a look at this link:
Special thanks goes to Google Maps and the authors of gHowl.


Location_locationIt accepts two type of inputs. a) latitude, longitude and elevation that represent WSG84 coordinates of the base point. You can achieve these type of coordinates from Google Maps or similar. e.g. 40.821796, 14.426439, 990 - b) location, you can obtain this type of input from "Ladybug_Construct Location", "Ladybug_Location Finder", "Ladybug_Import epw", "Ladybug_Import Location".Goo
Base Point_basePoint_Input a point here to georeference the terrain model.Goo
Radius_radius_A radius to make the terrain 3D model in Rhino model units. The default is set to 100. - If you provide a big radius, this could require lots of time (also a couple of minutes).Goo
Typetype_Select the type of output: 0 = rectangular mesh 1 = rectangular surface - The default value is 0.Goo
Num Of Tiles_numOfTiles_Set the number of tiles (e.g. 4, that means 4x4). If no input is connected this will be 3 (tiles: 3x3).Goo
Num Division_numDivision_Set the number of points for each tile. If no input is connected this will be 12 (grid: 13x13).Goo
Img Resolution_imgResolution_Connect an integer number which manage the quality of single satellite image. - The following list shows the approximate level of detail you can expect to see at each _imgResolution_ level: 1 = World 5 = Landmass/continent 10 = City 15 = Streets 20 = Buildings - The default value is 18.Goo
Map TypemapType_Connect an integer number, from 0 to 3, which manages the formats of map. - 0 = Satellite (default) 1 = Roadmap, specifies a standard roadmap image 2 = Terrain, it shows terrain and vegetation 3 = Hybrid, it specifies a hybrid of the satellite and roadmap imageGoo
Folderfolder_The folder into which you would like to write the image file. This should be a complete file path to the folder. If no folder is provided, the images will be written to C:/USERNAME/AppData/Roaming/Ladybug/IMG_Google.Goo
Run It_runItSet to "True" to run the component and generate the 3D terrain model. Goo


Points GeopointsGeoWSG84 coordinates of the grid points (longitude, latitude).Goo
Points XYpointsXYCartesian coordinates of the grid points (X, Y).Goo
Points ZpointsZZ values of the grid points. Connect this output to a Z vector to move the pointsXY in the right positions.Goo
TilestilesThe area which will be calculated. If you want to visualize Satellite images connect this output to 'G' input of 'Human Custom Preview Material'.Goo
Image PathimagePathSatellite images from Google Static Maps API. Connect it to 'DB' input of 'Human Custom Preview Material' to apply textures to the 3d model or to the list of input surfaces.Goo
Terrainterrain3D terrain model.Goo
OriginoriginThe origin (center) point of the "terrain" geometry.Goo
ElevationelevationElevation of the origin_ input.Goo

Video Tutorials

Site design © Robin Rodricks.   Co-created by Andrew Heumann.   Ladybug and associated data © 2022 Ladybug Tools.  
Rhinoceros and Grasshopper are registered trademarks of Robert McNeel & Associates.  Hosted by GitHub

Report an Issue  |  Terms of Service