How it works
Benefits
Our Journey
Developers
Blog
Sign in

Quickly integrate with the best geocoding providers

Learn how to use OneSDKSign up for free

Write the integration once

Try out the providers and find the best fit

Don't spend time learning providers' APIs

Don't worry about the selection—you can easily change the provider later. Superface works with the best providers. One or all.

Here.com

FREEMIUM

  • 250K requests/month
  • $1/1000 additional transactions

PRO PLAN $449/month

  • 1mil requests/month
  • $1/1000 additional transactions Customer support
  • 5 requests per second
  • 5k monthly active users
  • Data transfer per month 2.5GB
  • Database storage per month 5GB
Details
Google Maps

FREE TIER

  • free $200 worth usage / month
  • $300 trial credit valid for 90 days for new New Google Cloud and Google Maps Platform users

PRICE PER REQUEST

  • $5 / 1000 requests (0-100k requests/month)
  • $4 / 1000 requests (100k - 500k requests/month)s Customer support
  • 50 requests per second
  • Google map must be used to display results
Details
Azure Maps

FREE TRIAL

  • 5000 free requests / month
  • free $200 worth of usage valid for 30 days

PRO PLAN

  • $4.50 / 1000 requests (0-100k requests/month)
  • $3 / 1000 requests (100-500k requests/month)
  • prices go as low as $0.50 per 1000 requests with usage exceeding 1mil requests / month
Details
OpenCage

FREE TRIAL

  • 2,500 requests/day
  • 1 request/sec

FROM $50/month

  • 10,000 requests/day *15 requests/sec
  • multiple API keys
  • priority support
  • custom pricing for large traffic available
  • paid plan scales up to $1000/month with 500k requests/day
Details
TomTom

FREE

  • 2,500 requests/day

PAY AS YOU GROW

  • $0.50 / 1000 additional requests after exceeding 2,500 requests/day
  • Personalized support for paying users
  • custom enterprise plans available
Details
Nominatim

FREE

FREE

Community maintained, 1 request/second, required to display attribution

Details
1

Install OneSDK for Node.js

Superface OneSDK is an open-source library that will give you one interface to every provider.

$ npm install @superfaceai/one-sdk
2

Write simple code

Use the OneSDK in your Node.js app:

const { SuperfaceClient } = require('@superfaceai/one-sdk');
const sdk = new SuperfaceClient();
 
async function main() {
  // Load the installed profile
  const profile = await sdk.getProfile('address/geocoding');
  const result = await profile.getUseCase('Geocode')
    .perform({
      addressCountry: 'United States',
      addressLocality: 'San Francisco',
      postalCode: 'CA 94103',
      streetAddress: '325 Ninth Street',
    }, {
      provider: 'azure-maps',
      security: {
        'subscription-key': {
          apikey: 'your apikey from azure-maps'
        }
      }
    });
  try {
    const data = result.unwrap();
    console.log(data);
  }
  catch (error) {
    console.error(error)
  }
}
 
main();
# Run the code
$ node index.js
Done!
Learn moreGitHub

Bonus: Multiple geocoding providers

You can configure additional providers for your integration; Just repeat step 3 as many times as you wish.

Do not forget to set your API keys for newly configured providers!

 

With multiple providers configured, you can select which one is used either in the configuration file or directly in the code.

Provider configuration in superface/super.json

{
  "profiles": {
    "address/geocoding": {
      "version": "3.1.2",
      "providers": {
      "nominatim": {},
      "tomtom": {}
    },
    "priority": [
      "nominatim",
      "tomtom"
    ]
    }
  },
  "providers": {
    "nominatim": {
      "security": []
    },
    "tomtom": {
      "security": [
        {
          "id": "apikey",
          "apikey": "$TOMTOM_API_KEY"
        }
      ]
    }
  }
}

Provider configuration in the code

const { SuperfaceClient } = require('@superfaceai/one-sdk');
async function main() { const sdk = new SuperfaceClient();
 
// Load the installed provider
const provider = await sdk.getProvider('nominatim');
// Load the installed profile
const profile = await sdk.getProfile('address/geocoding');
const result = await profile.getUseCase('Geocode')
  .perform({
    addressCountry: 'United States',
    addressLocality: 'San Francisco',
    postalCode: 'CA 94103',
    streetAddress: '325 Ninth Street',
  },{
    provider,
  });
  try {
    const data = result.unwrap();
    console.log(data) }
  catch (error) {
    console.error(error)
}}
 
main();

Bonus: Monitor your geocoding integration

Sign up for Superface and set your SDK token to get real-time insight into your geocoding integration.

$ export SDK_TOKEN=your-superface-sdk-token
Sign up for Superface
We love APIs.
Let's connect 
Get demo
© 2022 Superface