https://github.com/seripap/google-geocode-parser
This is a utility to help parse raw geocoded data returned from Google Geocode API services.
https://github.com/seripap/google-geocode-parser
Last synced: 20 days ago
JSON representation
This is a utility to help parse raw geocoded data returned from Google Geocode API services.
- Host: GitHub
- URL: https://github.com/seripap/google-geocode-parser
- Owner: seripap
- Created: 2018-03-29T15:33:58.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-04-03T14:10:36.000Z (about 6 years ago)
- Last Synced: 2025-05-13T00:05:58.768Z (20 days ago)
- Language: JavaScript
- Size: 151 KB
- Stars: 1
- Watchers: 4
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Google Geocode Parser [](https://travis-ci.org/seripap/Google-Geocode-Parser)
This is a utility to help parse raw geocoded data returned from Google Geocode API services.
## Usage
```
$ npm install --save google-geocode-parser
```
```
const GeocodeParser = require('google-geocode-parser');
const request = await fetch('https://maps.googleapis.com/maps/api/geocode/json?address=247%20water%20street%20brooklyn');
const results = await request.json();
const parsed = new GeocodeParser(results);
```
## API
### getComponent(key, useShort)
Gets an adddress component by `key`. Returns string
#### Params
- `key`: String: Type value (any valid keys from address_components).
- `useShort`: Bool: Returns `short_name` value.
### isType([type])
Verifies if results is a certain type. Returns bool.
#### Params
- `type`: Array: Values to verify
### parse()
Returns a parsed output of the results.
#### Sample
```
{
formatted,
address,
city,
geometry,
state,
zip
}
```
## Helpers
These are simple built in functions designed to quickly parse results returned from the Google Geocode service.
- `.isValid` - Geocode status === OK
- `isNeighborhood()`
- `isAirport()`
- `isCity()`
- `isAddress()`
- `isState()`
- `isCounty()`
- `isZip()`
- `getCity()`
- `getCountry()`
- `getState()`
- `getNeighborhood()`
- `getZip()`
- `getGeo()`
- `getStreetNumber()`
- `getStreetAddress()`
- `getSuffix()`
- `getPredirectional()`
- `getPostdirectional()`
- `getStreetName()`
- `getLat()`
- `getLng()`
- `getLatLng()`