16. GeoMesa Convert

A configurable and extensible library for converting data into SimpleFeatures, found in geomesa-convert in the source distribution.

Converters for various different data formats can be configured and instantiated using the SimpleFeatureConverters factory and a target SimpleFeatureType. Converters are currently available for files in these formats:

• delimited text (CSV, TSV)
• fixed width text
• Avro
• JSON
• XML

The converter allows the specification of fields extracted from the data and transformations on those fields. Syntax of transformations is very much like awk syntax. Fields with names that correspond to attribute names in the SimpleFeatureType will be directly populated in the result SimpleFeature. Fields that do not align with attributes in the SimpleFeatureType are assumed to be intermediate fields used for deriving attributes. Fields can reference other fields by name for building up complex attributes.

SimpleFeatureTypes and converters are specified as HOCON files readable by the Typesafe Config library.

• 16.1. Example Usage
• 16.2. Using SFT and Converter Definitions with Command-Line Tools
• 16.3. Loading Converters and SFTs at Runtime
• 16.4. Prepackaged Converter Definitions
• 16.5. Transformation Function Overview
• 16.6. Transformation Function Usage
• 16.7. Parsing JSON
• 16.8. Parsing XML
• 16.9. Parsing Avro
• 16.10. Extending the Converter Library
• 16.11. Parsing and Validation
• 16.12. Using Caches for Enrichment