@flatfile/plugin-enrich-geocode
v0.3.0
Published
A Flatfile plugin for geocoding addresses using the Google Maps Geocoding API
Downloads
140
Readme
@flatfile/plugin-enrich-geocode
The @flatfile/plugin-enrich-geocode
plugin for geocoding addresses using the Google Maps Geocoding API. This plugin enables automatic geocoding of addresses, reverse geocoding of coordinates, and enrichment of location data within your Flatfile imports.
Event Type:
listener.on('commit:created')
Features
- Forward geocoding: Convert addresses to latitude and longitude coordinates
- Reverse geocoding: Convert latitude and longitude coordinates to formatted addresses
- Automatic geocoding based on available data
- Customizable field mapping
- Error handling for invalid inputs and API errors
- Extraction of additional location components (country, postal code)
Parameters
The enrichGeocode
function accepts a configuration object with the following properties:
sheetSlug
(string): The slug of the sheet containing address data. Default: "addresses"addressField
(string): The field name for the address input. Default: "address"latitudeField
(string): The field name for latitude. Default: "latitude"longitudeField
(string): The field name for longitude. Default: "longitude"autoGeocode
(boolean): Whether to automatically geocode records. Default: true
Installation
To install the plugin, use npm:
npm install @flatfile/plugin-enrich-geocode
Example Usage
import type { FlatfileListener } from "@flatfile/listener";
import enrichGeocode from "@flatfile/plugin-enrich-geocode";
export default function (listener: FlatfileListener) {
listener.use(
enrichGeocode(listener, {
sheetSlug: 'customer_addresses',
addressField: 'full_address',
latitudeField: 'lat',
longitudeField: 'lng'
})
);
// ... rest of your Flatfile setup
}