This package has been deprecated

Author message:

use @furkot/geocode instead

furkot-geocode

2.0.2 • Public • Published

NPM version Build Status Dependency Status

furkot-geocode

Geocoding service for Furkot

Install

$ npm install --save furkot-geocode

Usage

var furkotGeocode = require('furkot-geocode');
var options = {}; // options activating geocoding services

var geocode = furkotGeocode(options);

var query = {}; // geocoding query

geocode(query, function (result) {
  // process result
}

Configuration options

Geocoding component expects a configuration options object with following fields:

  • max - maximum number of places to return
  • order - list of names of geocoding services in the order they will be tried
  • XXX_key - API key for service XXX (if service XXX requires a key)
  • XXX_enable - function that takes query and returns true when service XXX is expected to handle that query; if the function is absent, the service XXX won't be used even if listed in the order
  • XXX_parameters - object with additional parameters specific to service XXX

Query parameters

Common parameters:

  • max - maximum number of places to return (overrides configuration option)
  • lang - language code, defaults to en

Reverse geocoding:

  • ll - array of coordinates [ longitude, latitude ]

Forward geocoding:

  • address - string representing an address
  • place - string representing place name; either addess or place is expected
  • partial - a boolean flag set when geocoding is done as part of autocomplete
  • bounds - a hint to the region place resides in as array of south west and north east [[SW longitude, SW latitude], [NE longitude, NE latitude]]

Results format

If successful, geocoding service will return object with field places - an array of objects, each describing one place with following fields (not all fields are always set):

  • place - place name (may be absent if address doesn't correspond to a named place)
  • type - place type
  • address - formated address
  • house - building number
  • street - street name
  • community - neighborhood or village
  • town - town or city
  • county - administrative area more general than town
  • province - state or province (usually abbreviated)
  • country - country (short form but not abbreviated)

License

MIT © Natalia Kowalczyk

Package Sidebar

Install

npm i furkot-geocode

Weekly Downloads

1

Version

2.0.2

License

MIT

Unpacked Size

38.4 kB

Total Files

18

Last publish

Collaborators

  • melitele
  • pirxpilot