GeometryExtractor

Features whose geometry was successfully encoded into the Destination Geometry Attribute are output through this port.

Features whose geometry could not be extracted into the chosen encoding are output through this port.

Rejected features will have an fme_rejection_code attribute with one of the following values: INVALID_FEATURE_LOCATION, INVALID_GEOMETRY_VERTICES, INVALID_GEOMETRY_TYPE.

This parameter can be set to Encoded Polyline, Esri JSON, FME Binary, FME XML, Geo (Microformat), Geohash, GeoJSON, GeoRSS Simple, Geotagging GeoSMS (RFC 5870), GML, hexadecimal-encoded FME Binary, hexadecimal-encoded OGC Well Known Binary (wkbhex), ISO 6709 Geographic Point, KML, MGRS, Microsoft SQL Server Binary, OGC Open GeoSMS, OGC Well Known Binary (wkb), OGC Well Known Text (wkt), or QlikMaps Encoded Polyline.

The most efficient and truest representation of the geometry is FME Binary, and this should be used in most cases. All the FME representations can accommodate all aspects of the FME Geometry Model, including measures and paths consisting of multiple linear segments; however, both the FME XML and Hex Encoded FME Binary representations impose some overhead in translating between the internal binary representation and the ASCII-encoded representation.

The OGC variants are useful if interaction with other OGC supporting systems is required. However, some characteristics of geometries may be lost in these modes; for instance, any path will be flattened into a single linestring.

The GeoJSON, Esri JSON, and GeoRSS Simple encodings may not preserve all geometry characteristics. For example, arcs will be stroked to lines, and ellipses stroked to polygons. These encodings also do not support measures.

The Geohash encoding will not preserve any geometry characteristics. Instead, they will be converted to a point represented by a geohash.

The OGC Open GeoSMS, Geotagging GeoSMS, and Geo encodings will not preserve any geometry characteristics. For example: arcs, polygons, ellipses, etc., will be converted into a point at the center of their bounding box and will then be encoded to their respective formats. If the geometry has a coordinate system other than LL-WGS84, a temporary copy will be created and reprojected; however, the source geometry will not be modified.

The Encoded Polyline encoding is useful if working with the Google Maps API and can be used to represent points, lines and polygons.

The QlikMaps Encoded Polyline encoding is like the Encoded Polyline encoding, but it can also be used to represent donuts and multi areas.

The ISO 6709 Geographic Point encoding serializes a geometry into the ISO 6709 point format. Non-point geometries are serialized as a sequence of geographic points.

The MGRS encoding calculates a Military Grid Reference System (MGRS) code based on the geometry of a feature. The MGRS code for a position consists of a group of letters and numbers which include the following elements:

• grid zone designation
• the 100,000-meter square letter identification
• the grid coordinates (also referred to as rectangular coordinates); the numerical portion of the reference expressed to a desired refinement

For MGRS, if a non-point feature (that is, a feature with more than one point) is passed in, then the first point of the geometry will be used for the conversion.

The Microsoft SQL Server Binary encoding is used to serialize geometries to the native storage format used in Microsoft SQL Server.

The name of the attribute that will hold the encoded geometry.

Removes geometry after extraction. The default value is No. If the value is set to Yes, the geometry will be removed from the feature after it has been extracted into an attribute. This option can be useful for saving memory space if the true geometry will no longer be needed.

The name of the attribute that will hold the encoded levels of a polyline.

You can choose the length in characters of the resulting geohash; this also shows the approximate precision. Please note that the precision of a geohash is limited by the precision of the source geometry.

For XML output formats (except FME XML), this parameter controls whether or not the output contains XML namespace declarations. All well-formed XML output must contain namespace declarations. However, if you are manually inserting the transformer output into a larger XML document, you may want to omit the namespace declarations.

Determines if FME writes the Geometries as a gml:Polygon or a gml:PolygonPatch. The default value is 'no', which prints out gml:Surface geometries. If 'yes', FME creates the geometry as a gml:Polygon in the output.

This parameter can overwrite the CRS value that is written in the GML instance’s srsName attributes.

By default, the FME coordinate system name in a feature is transferred directly onto the srsName attribute. Using this parameter allows you to provide your own URN CRS string for the srsName attributes.

This parameter specifies the axis order for a coordinate tuple in a GML <pos> or <posList> element.

The valid values are:

• xy
• yx
• xyz
• yxz

There is no default value.

A gml_id geometry trait, if present, is used to populate the gml:id attribute of a GML geometry element.

For example, a FME Point with the gml_id trait will be written as <gml:Point gml:id="…">

When this parameter is set to Yes, a gml:id will be automatically generated for GML geometries without a corresponding gml_id geometry trait.

The default value is No.

This parameter is enabled when Geometry Encoding is GeoJSON or EsriJSON. The transformer uses this value to limit the number of decimal digits printed for each coordinate. Valid values are 1 to 15. The default value is 7, which gives roughly 1 centimeter accuracy when writing WGS84 coordinates. A lower number of digits can dramatically reduce the size of the output JSON data.

You can choose between versions 1.1 and 1.2.

Version 1.2 contains two key improvements: support for measures and z-values. Note that the only measure considered when producing an OGC representation is the "default" (unnamed) measure.

The precision of the strings used to represent the coordinates of the geometry. The options are:

• 64-bit: Enough precision to store all double-precision IEEE floating-point numbers.
• 32-bit: Enough precision to store all single-precision IEEE floating-point numbers.

This parameter allows you to choose the URL of the mapping service to be used by the OGC Open GeoSMS. The default value is Google Maps.

The ellipsoid used for the conversion. This can be any ellipsoid name supported by FME.

The type of lettering used can be WGS84 or Bessel.

The granularity of the resulting code is determined by the specified Precision which is an integer from 0 to 5 (inclusive). A precision of 5 locates a point within 1-meter square and a precision of 0 locates a point within 100-km square.

If Geometry Encoding is Microsoft SQL Server Binary, choose whether it is a serialized Geometry or Geography.

Indicates the encoding for the lat/long coordinates. The coordinates of the feature will be treated as degrees, regardless of any specified coordinate systems. The Reprojector transformer can be used to first convert other coordinate systems into lat/long coordinates.

Specifies the maximum number of decimal places.

Using the Text Editor

The Text Editor provides a convenient way to construct text strings (including regular expressions) from various data sources, such as attributes, parameters, and constants, where the result is used directly inside a parameter.

Text Editor

Using the Arithmetic Editor

The Arithmetic Editor provides a convenient way to construct math expressions from various data sources, such as attributes, parameters, and feature functions, where the result is used directly inside a parameter.

Arithmetic Editor

Conditional Values

Set values depending on one or more test conditions that either pass or fail.

Parameter Condition Definition Dialog

Content

Expressions and strings can include a number of functions, characters, parameters, and more.

When setting values - whether entered directly in a parameter or constructed using one of the editors - strings and expressions containing String, Math, Date/Time or FME Feature Functions will have those functions evaluated. Therefore, the names of these functions (in the form @<function_name>) should not be used as literal string values.

Content Types

String Functions	These functions manipulate and format strings.
Special Characters	A set of control characters is available in the Text Editor.
Math Functions	Math functions are available in both editors.
Date/Time Functions	Date and time functions are available in the Text Editor.
Math Operators	These operators are available in the Arithmetic Editor.
FME Feature Functions	These return primarily feature-specific values.
FME Parameters	FME and workspace-specific parameters may be used.
Creating and Modifying User Parameters	Create your own editable parameters.

Note: Not all tools are available in all transformers.