Security News
RubyGems.org Adds New Maintainer Role
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
@spurreiter/geocoder
Advanced tools
Node geocoding library, google maps, bing maps, mapquest, mapbox, here maps, arcgis, nominatim, ...
This project is derived from node-geocoder with focus on modern code with esm modules.
Features:
Provider | forward | reverse | ip | Notes |
---|---|---|---|---|
ArcGisGeocoder | ✅ | ✅ | ❌ | |
BingMapsGeocoder | ✅ | ✅ | ❌ | results are in English only |
GoogleGeocoder | ✅ | ✅ | ❌ | |
GeocodioGeocoder | ✅ | ✅ | ❌ | results are in English only; Country must be part of query, otherwise fallback to US; Only US and major cities in CA supported |
HereGeocoder | ✅ | ✅ | ❌ | |
IpStackGeocoder | ❌ | ❌ | ✅ | |
LocationIqGeocoder | ✅ | ✅ | ❌ | |
GeoLite2Geocoder | ❌ | ❌ | ✅ | Local GeoLite2 provider or MaxMind API. Output as of @maxmind/geoip2-node |
MapBoxGeocoder | ✅ | ✅ | ❌ | |
MapQuestGeocoder | ✅ | ✅ | ❌ | open-data and licensed versions are supported |
OpenCageGeocoder | ✅ | ✅ | ❌ | |
OpendataFranceGeocoder | ✅ | ✅ | ❌ | France only |
OpenMapQuest | ✅ | ✅ | ❌ | Search Results based on OSM |
OsmGeocoder | ✅ | ✅ | ❌ | Searches nominatim.org |
PeliasGeocoder | ✅ | ✅ | ❌ | Local or Geocode.earth |
PickpointGeocoder | ✅ | ✅ | ❌ | Search Results based on OSM |
TomTomGeocoder | ✅ | ✅ | ❌ | |
YandexGeocoder | ✅ | ✅ | ❌ |
import { fetchAdapter, OsmGeocoder } from '@spurreiter/geocoder'
const adapter = fetchAdapter()
const geocoder = new OsmGeocoder(adapter,
{ language: 'en', limit: 5, referer: 'https://mysite' })
const results = await geocoder.forward('135 pilkington avenue, birmingham')
// [
// {
// formattedAddress: '135, Pilkington Avenue, Maney, Sutton Coldfield, Wylde Green, Birmingham, West Midlands Combined Authority, West Midlands, England, B72 1LH, United Kingdom',
// latitude: 52.5487921,
// longitude: -1.8164308339635031,
// country: 'United Kingdom',
// countryCode: 'GB',
// state: 'England',
// county: 'West Midlands Combined Authority',
// city: 'Birmingham',
// zipcode: 'B72 1LH',
// district: 'West Midlands',
// streetName: 'Pilkington Avenue',
// streetNumber: '135',
// neighbourhood: undefined,
// extra: {
// id: 90394480,
// confidence: 0.411,
// bbox: [ -1.816513, 52.5487473, -1.8163464, 52.5488481 ]
// }
// }
// ]
const results = await geocoder.reverse({ lat: 40.714232, lng: -73.9612889 })
// [
// {
// formattedAddress: '279, Bedford Avenue, Williamsburg, Brooklyn, Kings County, New York, 11211, United States',
// latitude: 40.714205,
// longitude: -73.96131519274765,
// country: 'United States',
// countryCode: 'US',
// state: 'New York',
// county: undefined,
// city: 'New York',
// zipcode: '11211',
// district: undefined,
// streetName: 'Bedford Avenue',
// streetNumber: '279',
// neighbourhood: undefined,
// extra: {
// id: 279767984,
// confidence: 0,
// bbox: [ -73.9613744, 40.7141617, -73.961256, 40.7142482 ]
// }
// }
// ]
Allows to sequentially ask various geocoders for results. Successful results from the first geocoder are returned.
Works with forward and reverse geocoding.
import { Cascade, fetchAdapter, HereGeocoder, OsmGeocoder } from '@spurreiter/geocoder'
const language = "es"
const geocoders = [
new HereGeocoder(adapter, { apiKey: 'your-api-key', language }),
new OsmGeocoder(adapter, { language, referer: 'https://mysite' })
]
const cascade = new Cascade(geocoders)
const results = await cascade.forward('135 pilkington avenue, birmingham')
// results contains data from 1st geocoder which responds without error.
Combine results from various geocoders into one result set.
Works with forward and reverse geocoding.
import { Combine, fetchAdapter, HereGeocoder, OsmGeocoder } from '@spurreiter/geocoder'
const geocoders = [
new HereGeocoder(adapter, { apiKey: 'your-api-key' }),
new OsmGeocoder(adapter, { referer: 'https://mysite' })
]
const combine = new Combine(geocoders)
const results = await combine.forward(
{ address: '135 pilkington avenue, birmingham', language: 'es' })
// results contains data from all reachable geocoders.
Formatters allow to format the geocoder result object to various formats like geoJson or gpx.
The output of the GeoJSON formatter is according to RFC-7946 and geocodejson-spec.
import { geoJsonFormatter } from '@spurreiter/geocoder'
const query = '135 pilkington avenue, birmingham'
const results = await geocoder.forward(query)
const geoJson = geoJsonFormatter(results, {query})
// {
// type: 'FeatureCollection',
// geocoding: {
// version: '0.1.0',
// license: null,
// attribution: null,
// query: '135 pilkington avenue, birmingham'
// },
// features: [{...}, ...]
// }
import { gpxFormatter } from '@spurreiter/geocoder'
const query = '135 pilkington avenue, birmingham'
const results = await geocoder.forward(query)
const gpx = gpxFormatter(results)
// <?xml version="1.0" encoding="UTF-8"?>
// <gpx version="1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.topografix.com/GPX/1/0" xsi:schemaLocation="http://www.topografix.com/GPX/1/0 http://www.topografix.com/GPX/1/0/gpx.xsd">
// <wpt lat="52.5487921" lon="-1.8164308339635031"><name>135, Pilkington Avenue, Maney, Sutton Coldfield, Wylde Green, Birmingham, West Midlands Combined Authority, West Midlands, England, B72 1LH, United Kingdom</name></wpt>
// </gpx>
If you are missing a provider, which should be part of this project, please consider forking this project and filing a pull-request.
FAQs
Node geocoding library, google maps, bing maps, mapquest, mapbox, here maps, arcgis, nominatim, ...
The npm package @spurreiter/geocoder receives a total of 71 weekly downloads. As such, @spurreiter/geocoder popularity was classified as not popular.
We found that @spurreiter/geocoder demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
Security News
Node.js will be enforcing stricter semver-major PR policies a month before major releases to enhance stability and ensure reliable release candidates.
Security News
Research
Socket's threat research team has detected five malicious npm packages targeting Roblox developers, deploying malware to steal credentials and personal data.