ImportFromWKT Method (IGeometryEngine)

In This Topic

Creates a geometry from the input well-known text string.

Syntax

Visual Basic (Declaration)
C#

Function ImportFromWKT( _
   ByVal importFlags As WktImportFlags, _
   ByVal wktString As String, _
   ByVal spatialReference As SpatialReference _
) As Geometry

Geometry ImportFromWKT( 
   WktImportFlags importFlags,
   string wktString,
   SpatialReference spatialReference
)

Parameters

importFlags: A combination of WktImportFlags which determines how the geometry is imported.
wktString: The input WKT string. The string must be OGC compliant.
spatialReference: The spatial reference of the output geometry.

Return Value

A Geometry that corresponds to the .

Exceptions

Exception	Description
System.ArgumentNullException	wktString is null or empty.

Example

Import and Export Geometries to well-known Text

{
  // create a point with z, m
  MapPoint point = MapPointBuilderEx.CreateMapPoint(
           100, 200, 300, 400, SpatialReferences.WebMercator);

  // set the flags
  WktExportFlags wktExportFlags = WktExportFlags.WktExportDefaults;
  WktImportFlags wktImportFlags = WktImportFlags.WktImportDefaults;

  // export and import
  string wktString = GeometryEngine.Instance.ExportToWKT(wktExportFlags, point);
  MapPoint importPointGeom = GeometryEngine.Instance.ImportFromWKT(
        wktImportFlags, wktString, SpatialReferences.WebMercator) as MapPoint;

  double x = importPointGeom.X;       // x = 100
  double y = importPointGeom.Y;       // y = 200
  bool hasZ = importPointGeom.HasZ;   // hasZ = true
  double z = importPointGeom.Z;       // z = 300
  bool hasM = importPointGeom.HasM;   // hasM = true
  double m = importPointGeom.M;       // m = 400

  // export without z
  WktExportFlags exportFlagsNoZ = WktExportFlags.WktExportStripZs;
  wktString = GeometryEngine.Instance.ExportToWKT(exportFlagsNoZ, point);
  importPointGeom = GeometryEngine.Instance.ImportFromWKT(
    wktImportFlags, wktString, SpatialReferences.WebMercator) as MapPoint;

  x = importPointGeom.X;        // x = 100
  y = importPointGeom.Y;        // y = 200
  hasZ = importPointGeom.HasZ;  // hasZ = false
  z = importPointGeom.Z;        // z = 0
  hasM = importPointGeom.HasM;  // hasM = true
  m = importPointGeom.M;        // m = 400

  // export without m
  WktExportFlags exportFlagsNoM = WktExportFlags.WktExportStripMs;
  wktString = GeometryEngine.Instance.ExportToWKT(exportFlagsNoM, point);
  importPointGeom = GeometryEngine.Instance.ImportFromWKT(
    wktImportFlags, wktString, SpatialReferences.WebMercator) as MapPoint;

  x = importPointGeom.X;        // x = 100
  y = importPointGeom.Y;        // y = 200
  hasZ = importPointGeom.HasZ;  // hasZ = true
  z = importPointGeom.Z;        // z = 300
  hasM = importPointGeom.HasM;  // hasM = false
  m = importPointGeom.M;        // m = Nan

  // export without z, m
  wktString = GeometryEngine.Instance.ExportToWKT(
    exportFlagsNoZ | exportFlagsNoM, point);
  importPointGeom = GeometryEngine.Instance.ImportFromWKT(
    wktImportFlags, wktString, SpatialReferences.WebMercator) as MapPoint;

  x = importPointGeom.X;        // x = 100
  y = importPointGeom.Y;        // y = 200
  hasZ = importPointGeom.HasZ;  // hasZ = false
  z = importPointGeom.Z;        // z = 0
  hasM = importPointGeom.HasM;  // hasM = false
  m = importPointGeom.M;        // m = Nan
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

IGeometryEngine Interface
IGeometryEngine Members

Send feedback