Geocode Address
Geocode an address, partial address or just the name of a place.
Address
geocoding is the process of taking a string and attempting to match this with possible real world locations.
This is the opposite process of
reverse geocoding.
Once a location is found you can then retrieve the geographic coordinates as latitude and longitude.
If more than one location is found for a given string then results are ordered by most relevant to the original search address and with the highest geographic accuracy.
Use this API to:
- Display geocoded locations on a map component
- Validate postal addresses
- Search for postal codes
- Extract address components like city, state and country details
- Implement auto-complete for address inputs
- Fuzzy search for the nearest locations from partial or misspelled addresses
Note:
If your address data is already split into its individual components (street, city, suburb etc.) we recommend you pass this as a comma separated string to the address parameter.
End Point
https://neutrinoapi.com/geocode-address
Test API
| Parameter | Required | Type | Default | Description |
|---|
| address | yes | string | | The address, partial address or name of a place to try and locate |
| country-code | no | string | | The ISO 2-letter country code to be biased towards (the default is no country bias) |
| language-code | no | string | en | The language to display results in, available languages are:- de, en, es, fr, it, pt, ru
|
| fuzzy-search | no | boolean | false | If no matches are found for the given address, start performing a recursive fuzzy search until a geolocation is found. This option is recommended for processing user input or implementing auto-complete. We use a combination of approximate string matching and data cleansing to find possible location matches |
| Parameter | Type | Description |
|---|
| found | integer | The number of possible matching locations found |
| locations | array | Array of matching location objects:| Key | Type | Description |
|---|
| latitude | float | The location latitude | | longitude | float | The location longitude | | address | string | The fully formatted address | | address-components | map | The components which make up the address such as road, city, state, etc | | city | string | The city of the location | | state | string | The state of the location | | country | string | The country of the location | | country-code | string | The ISO 2-letter country code of the location | | country-code3 | string | The ISO 3-letter country code of the location | | currency-code | string | ISO 4217 currency code associated with the country | | postal-code | string | The postal code for the location | | location-type | string | The detected location type ordered roughly from most to least precise, possible values are:
- address - indicates a precise street address
- street - accurate to the street level but may not point to the exact location of the house/building number
- city - accurate to the city level, this includes villages, towns, suburbs, etc
- postal-code - indicates a postal code area (no house or street information present)
- railway - location is part of a rail network such as a station or railway track
- natural - indicates a natural feature, for example a mountain peak or a waterway
- island - location is an island or archipelago
- administrative - indicates an administrative boundary such as a country, state or province
| | location-tags | array | Array of strings containing any location tags associated with the address. Tags are additional pieces of metadata about a specific location, there are thousands of different tags. Some examples of tags: shop, office, cafe, bank, pub | | timezone | map | Map containing timezone details for the location:- id - the time zone ID as per the IANA time zone database (tzdata)
- name - the time zone name
- abbr - the time zone abbreviation
- date - the current date within the time zone (ISO format)
- time - the current time within the time zone (ISO format)
|
|
| Free Tier | Tier 1 | Tier 2 | Tier 3 |
|---|
| 25 | 1,000 | 10,000 | 100,000 |