Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Geometry.LineString
Stay organized with collections
Save and categorize content based on your preferences.
Constructs an ee.Geometry describing a LineString.
For convenience, varargs may be used when all arguments are numbers. This allows creating geodesic EPSG:4326 LineStrings given an even number of arguments, e.g. ee.Geometry.LineString(aLng, aLat, bLng, bLat, ...).
| Usage | Returns | ee.Geometry.LineString(coords, proj, geodesic, maxError) | Geometry.LineString |
| Argument | Type | Details | coords | List<Geometry>|List<List<Number>>|List<Number> | A list of at least two points. May be a list of coordinates in the GeoJSON 'LineString' format, a list of at least two ee.Geometry objects describing a point, or a list of at least four numbers defining the [x,y] coordinates of at least two points. |
proj | Projection, optional | The projection of this geometry. If unspecified, the default is the projection of the input ee.Geometry, or EPSG:4326 if there are no ee.Geometry inputs. |
geodesic | Boolean, optional | If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers. |
maxError | ErrorMargin, optional | Max error when input geometry must be reprojected to an explicitly requested result projection or geodesic state. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-08 UTC.
[null,null,["Last updated 2025-07-08 UTC."],[[["\u003cp\u003eCreates a LineString geometry, which represents a line segment on Earth's surface.\u003c/p\u003e\n"],["\u003cp\u003eAccepts a list of coordinates, projection, geodesic setting, and error margin for construction.\u003c/p\u003e\n"],["\u003cp\u003eAllows convenient creation of geodesic lines using coordinate pairs (longitude, latitude).\u003c/p\u003e\n"],["\u003cp\u003eDefaults to EPSG:4326 projection if no input geometry's projection is specified.\u003c/p\u003e\n"],["\u003cp\u003eEnables both straight and curved line representations based on the \u003ccode\u003egeodesic\u003c/code\u003e parameter.\u003c/p\u003e\n"]]],[],null,["# ee.Geometry.LineString\n\n\u003cbr /\u003e\n\nConstructs an ee.Geometry describing a LineString.\n\n\u003cbr /\u003e\n\nFor convenience, varargs may be used when all arguments are numbers. This allows creating geodesic EPSG:4326 LineStrings given an even number of arguments, e.g. ee.Geometry.LineString(aLng, aLat, bLng, bLat, ...).\n\n| Usage | Returns |\n|--------------------------------------------------------------------------|---------------------|\n| `ee.Geometry.LineString(coords, `*proj* `, `*geodesic* `, `*maxError*`)` | Geometry.LineString |\n\n| Argument | Type | Details |\n|------------|----------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `coords` | List\\\u003cGeometry\\\u003e\\|List\\\u003cList\\\u003cNumber\\\u003e\\\u003e\\|List\\\u003cNumber\\\u003e | A list of at least two points. May be a list of coordinates in the GeoJSON 'LineString' format, a list of at least two ee.Geometry objects describing a point, or a list of at least four numbers defining the \\[x,y\\] coordinates of at least two points. |\n| `proj` | Projection, optional | The projection of this geometry. If unspecified, the default is the projection of the input ee.Geometry, or EPSG:4326 if there are no ee.Geometry inputs. |\n| `geodesic` | Boolean, optional | If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers. |\n| `maxError` | ErrorMargin, optional | Max error when input geometry must be reprojected to an explicitly requested result projection or geodesic state. |"]]