sggeocode v0.2.8

Introduction

Get Lat Lng from SmartyStreets and Google Geocoder

Installation

npm install sggeocode

Example

const {SgGeocode} = require('sgGeocode');

let keys = {
    webKey: 'your key here',
    googleApiKey: 'your google api key here'
}

let options = {
    fullAddress: '123 W Chandler Blvd Chandler AZ',
}

SgGeocode.getLatLng(options, keys).then((res) => {
    console.log(res)
});

Parameter

You pass in the following parameters in the keys object

• webKey - SmartyStreets web key
• googleApiKey - Google Places API key

You can pass in the following parameters in the options object

• fullAddress - Complete Address
• zipcode - 5 digit zip code
• city - City name
• state - State code

The Lookup object can be constructed in 3 different ways 1. Lookup by Address (fullAddress)

let options = {
    fullAddress: '123 W Chandler Blvd Chandler AZ'
}

2. Lookup by Zip ('zipcode', or combination of 'city' and 'state', or all three of them) (Google API key is optional when constructing zip object)

let options = {
    zipcode: '12345'
}

//OR a combination of City-State

let options = {
    city: 'Chandler',
    state: 'AZ'
}

//OR all three of them
let options = {
    zipcode: '12345'
    city: 'Chandler',
    state: 'AZ'
}

3. Lookup by Google autocomplete object ('prediction'),

let options = {
    //name the autocomplete object as 'prediction'
    prediction: {
        "description" : "Chandler, AZ 85225, USA",
        "matched_substrings" : [
           {
              "length" : 5,
              "offset" : 13
           }
        ],
        "terms" : [
           {
              "offset" : 0,
              "value" : "Chandler"
           },
           {
              "offset" : 10,
              "value" : "AZ"
           },
           {
              "offset" : 13,
              "value" : "85225"
           },
           {
              "offset" : 20,
              "value" : "USA"
           }
        ],
        "types" : [ "postal_code", "geocode" ]
     }
}

Result

• After a successful call you should receive a response oject like

{
    lat: 32.12345,
    lng: -111.98765
}

• When no results are found, response object should look like this

{
    status: 'ZERO_RESULTS'
}

• Unsuccessful calls should receive a response object as,

{
    error: "error message"
}