geopointshape
Description
A geopointshape
object represents a point or multipoint in
geographic coordinates. A multipoint is an individual point shape that
contains a set of point locations.
To represent a point or multipoint in planar coordinates, use a mappointshape
object
instead.
Creation
To create geopointshape
objects, either:
Import point data in geographic coordinates as a geospatial table using the
readgeotable
function, and then query theShape
variable of the table.Use the
geopointshape
function (described here).
Description
Input Arguments
lat
— Latitude coordinates
numeric array | cell array of numeric arrays
Latitude coordinates, specified as a numeric array or a cell array of numeric arrays.
Create a point by specifying a scalar, such as
39
.Create a multipoint by specifying an array within a cell, such as
{[38 -30 29]}
.Create an array of points by specifying an array, such as
[38 -30 29]
.Create an array of points and multipoints by specifying a cell array of numeric arrays, such as
{39,[38 -30 29]}
.
Create placeholders for points with missing data by including
NaN
values. The NaN
values in
lat
must correspond to the NaN
values in
lon
.
The size of lat
must match the size of
lon
. For cell arrays, the size of the array in each cell of
lat
must match the size of the array in the corresponding cell
of lon
.
Data Types: double
| cell
lon
— Longitude coordinates
numeric array | cell array of numeric arrays
Longitude coordinates, specified as a numeric array or a cell array of numeric arrays.
Create a point by specifying a scalar, such as
-113
.Create a multipoint by specifying an array within a cell, such as
{[-66 -31 42]}
.Create an array of points by specifying an array, such as
[-66 -31 42]
.Create an array of points and multipoints by specifying a cell array of numeric arrays, such as
{-113,[-66 -31 42]}
.
Create placeholders for points with missing data by including
NaN
values. The NaN
values in
lat
must correspond to the NaN
values in
lon
.
The size of lat
must match the size of
lon
. For cell arrays, the size of the array in each cell of
lat
must match the size of the array in the corresponding cell
of lon
.
Data Types: double
| cell
Properties
NumPoints
— Number of points
array of nonnegative integers
This property is read-only.
Number of points, returned as an array of nonnegative integers.
For a geopointshape
scalar, the value of
NumPoints
is 1
when the
geopointshape
object represents a single point and more than
1
when the object represents a multipoint.
For a geopointshape
array, the size of
NumPoints
matches the size of the array.
Data Types: double
Latitude
— Latitude coordinates
array
Latitude coordinates, specified as an array.
For a geopointshape
scalar, the size of
Latitude
matches the value of
NumPoints
.
For a geopointshape
array, the size of
Latitude
matches the size of NumPoints
. If
the array contains geopointshape
objects with multipoints, then
accessing the Latitude
property of the array is not supported.
Instead, access the Latitude
property of individual objects within
the array. You can determine whether a geopointshape
array contains
multipoints by using the ismultipoint
function.
This property is read-only for arrays when any element of
NumPoints
is greater than 1
.
Latitude
and Longitude
must be the same
size.
Data Types: double
Longitude
— Longitude coordinates
array
Longitude coordinates, specified as an array.
For a geopointshape
scalar, the size of
Longitude
matches the value of
NumPoints
.
For a geopointshape
array, the size of
Longitude
matches the size of NumPoints
. If
the array contains geopointshape
objects with multipoints, then
accessing the Longitude
property of the array is not supported.
Instead, access the Longitude
property of individual elements
within the array. You can determine whether a geopointshape
array
contains multipoints by using the ismultipoint
function.
This property is read-only for arrays when any element of
NumPoints
is greater than 1
.
Latitude
and Longitude
must be the same
size.
Data Types: double
Geometry
— Geometric type
"point"
(default)
This property is read-only.
Geometric type, returned as "point"
.
Data Types: string
CoordinateSystemType
— Coordinate system type
"geographic"
(default)
This property is read-only.
Coordinate system type, returned as "geographic"
.
Data Types: string
GeographicCRS
— Geographic coordinate reference system
[]
(default) | geocrs
object
Geographic coordinate reference system (CRS), specified as a geocrs
object. A
geographic CRS consists of a datum (including its ellipsoid), prime meridian, and
angular unit of measurement.
Object Functions
geoplot | Plot points, lines, and polygons on map |
geoclip | Clip geographic shape to latitude-longitude limits or polygon |
buffer | Buffer shape in geographic or planar coordinates |
bounds | Bounds of shape in geographic or planar coordinates |
ismultipoint | Determine which array elements are multipoint shapes |
Examples
Get Information About Imported Geographic Points
Import a GPX file containing the coordinates of locations in Boston as a geospatial table. The GPX file represents the locations using points. Get information about the points by querying the Shape
variable of the table.
GT = readgeotable("boston_placenames.gpx");
GT.Shape
ans = 13×1 geopointshape array with properties: NumPoints: [13×1 double] Latitude: [13×1 double] Longitude: [13×1 double] Geometry: "point" CoordinateSystemType: "geographic" GeographicCRS: [1×1 geocrs]
Display the locations on a road map by passing the geospatial table to the geoplot
function.
figure geoplot(GT,"o",MarkerFaceColor="#0072BD") geobasemap streets
Create Geographic Points and Multipoints
Create an individual point as a geopointshape
scalar. Specify the geographic CRS as the World Geodetic System of 1984, which has the EPSG code 4326
.
point = geopointshape(39,-113); g = geocrs(4326); point.GeographicCRS = g
point = geopointshape with properties: NumPoints: 1 Latitude: 39 Longitude: -113 Geometry: "point" CoordinateSystemType: "geographic" GeographicCRS: [1x1 geocrs]
Create a multipoint as a geopointshape
scalar.
multipoint = geopointshape({[38 -30 29]},{[-66 -31 42]}); multipoint.GeographicCRS = g
multipoint = geopointshape with properties: NumPoints: 3 Latitude: [38 -30 29] Longitude: [-66 -31 42] Geometry: "point" CoordinateSystemType: "geographic" GeographicCRS: [1x1 geocrs]
Create three individual points as a 1-by-3 geopointshape
vector.
pointVector = geopointshape([38 -20 29],[-66 -31 42]); pointVector.GeographicCRS = g
pointVector = 1x3 geopointshape array with properties: NumPoints: [1 1 1] Latitude: [38 -20 29] Longitude: [-66 -31 42] Geometry: "point" CoordinateSystemType: "geographic" GeographicCRS: [1x1 geocrs]
Create one individual point and one multipoint as a 1-by-2 geopointshape
vector.
pointMultipoint = geopointshape({39,[38 -30 29]},{-113,[-66 -31 42]}); pointMultipoint.GeographicCRS = g
pointMultipoint = 1x2 geopointshape array with properties: NumPoints: [1 3] Geometry: "point" CoordinateSystemType: "geographic" GeographicCRS: [1x1 geocrs]
Version History
Introduced in R2021bR2022a: Points with missing coordinate data have some changed property values
When a point shape has missing coordinate data, its NumPoints
property has a value of 0
and its Latitude
and
Longitude
properties each have a value of NaN
.
When you create a point by specifying both coordinates as
NaN
values, itsNumPoints
property has a value of0
. In the previous release, the property had a value of1
.When a point has no coordinate data, its
Latitude
andLongitude
properties each have a value ofNaN
. In the previous release, the properties were each emptydouble
values.
These changes make it easier to create and access the properties of
geopointshape
arrays when the input coordinates contain missing data. For
example, you can now access the coordinates of a geopointshape
array when
the array contains a combination of points with coordinate data
(NumPoints
is 1
) and without coordinate data
(NumPoints
is 0
). In the previous release,
MATLAB® issued an error.
See Also
Functions
Objects
Topics
Comando de MATLAB
Ha hecho clic en un enlace que corresponde a este comando de MATLAB:
Ejecute el comando introduciéndolo en la ventana de comandos de MATLAB. Los navegadores web no admiten comandos de MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)