# 🌐📍Trueway Geocoding API: Forward and Reverse Geocoding ### Developer Portal : ### Unlock the Power of Location with Trueway Geocoding API #### Transform Addresses into Coordinates and Coordinates into Addresses **Trueway Geocoding API** offers a robust and reliable alternative to Google Maps, providing comprehensive geocoding services that meet your business needs at a much more affordable price. Whether you need to convert an address into geographic coordinates (forward geocoding) or transform coordinates into a human-readable address (reverse geocoding), Trueway has you covered with global coverage and multi-language support. #### Why Choose Trueway Geocoding API? * **Global Coverage**: Access accurate geocoding services anywhere in the world. * **Forward Geocoding**: Seamlessly convert street addresses into precise latitude and longitude coordinates. * **Reverse Geocoding**: Easily translate geographic coordinates into human-readable addresses. * **Multi-Language Support**: Receive geocoding results in the language you prefer with support for ISO 639-1 language codes. * **Cost-Effective**: Trueway Geocoding API is more affordable compared to Google Geocoding API, providing you with the same high-quality service at a lower price. #### Powerful Features and Capabilities **Forward Geocoding** Forward geocoding allows you to transform any address into geographic coordinates. Simply provide the street address, and let Trueway handle the rest. **Required Parameter:** * **address**: The street address you wish to geocode. **Optional Parameters:** * **language**: Specify the two-letter language code (ISO 639-1) for results. * **bounds**: Prefer results within a specified rectangular area (format: south, west, north, east). * **country**: Bias results towards a specific country using the two-letter country code (ccTLD or ISO 3166-1). **Reverse Geocoding** Reverse geocoding is perfect for when you need to convert geographic coordinates into a detailed, human-readable address. **Required Parameter:** * **location**: The geographic coordinates (latitude/longitude) you wish to reverse geocode. **Optional Parameter:** * **language**: Specify the two-letter language code (ISO 639-1) for results. #### Detailed Geocoding Responses Every geocoding response from Trueway includes a wealth of information: * **Address Components**: Detailed elements such as street, house number, neighborhood, and locality. * **Postal Code and Country**: Accurate postal codes and country information. * **Region and Area**: Comprehensive regional and area details. * **Location Type**: Identify whether the result is exact, approximate, or a centroid. * **Address Types**: Differentiated types like street address, route, road intersection, administrative area, and more. **Trueway Geocoding API – Your Trusted Partner for Location Data** Whether you are developing a **maps API**, enhancing delivery services, or simply need accurate **geo location API** data, Trueway provides the tools and support you need to succeed. Start your geocoding journey today and unlock the power of location with Trueway Geocoding API. Find out **about my location** with precise **map coordinates** and convert **latitude and longitude to address** effortlessly with our advanced geocoding solutions. #### Request and Response **Request** {% tabs %} {% tab title="curl" %} ```bash curl -X 'GET' \ 'https://prod.api.market/api/v1/trueway/geocoding/GeocodingService/Geocode?address=505%20Howard%20St%2C%20San%20Francisco&country=US&language=en&bounds=-90.0%2C-180.0%2C90.0%2C180.0' \ -H 'accept: application/json' \ -H 'x-api-market-key: API_KEY' ``` {% endtab %} {% tab title="Nodejs" %} ```bash const fetch = require('node-fetch'); let url = 'https://prod.api.market/api/v1/trueway/geocoding/GeocodingService/Geocode?address=505%20Howard%20St%2C%20San%20Francisco&postal_code=SOME_STRING_VALUE&country=US&area=SOME_STRING_VALUE&locality=SOME_STRING_VALUE&street=SOME_STRING_VALUE&language=en®ion=SOME_STRING_VALUE&bounds=-90.0%2C-180.0%2C90.0%2C180.0'; let options = {method: 'GET', headers: {'x-api-market-key': 'SOME_STRING_VALUE'}}; fetch(url, options) .then(res => res.json()) .then(json => console.log(json)) .catch(err => console.error('error:' + err)); ``` {% endtab %} {% tab title="Python" %} ```python import http.client conn = http.client.HTTPSConnection("api.magicapi.dev") headers = { 'x-api-market-key': "SOME_STRING_VALUE" } conn.request("GET", "/api/v1/trueway/geocoding/GeocodingService/Geocode?address=505%20Howard%20St%2C%20San%20Francisco&postal_code=SOME_STRING_VALUE&country=US&area=SOME_STRING_VALUE&locality=SOME_STRING_VALUE&street=SOME_STRING_VALUE&language=en®ion=SOME_STRING_VALUE&bounds=-90.0%2C-180.0%2C90.0%2C180.0", headers=headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` {% endtab %} {% tab title="Java" %} ```java OkHttpClient client = new OkHttpClient(); Request request = new Request.Builder() .url("https://prod.api.market/api/v1/trueway/geocoding/GeocodingService/Geocode?address=505%20Howard%20St%2C%20San%20Francisco&postal_code=SOME_STRING_VALUE&country=US&area=SOME_STRING_VALUE&locality=SOME_STRING_VALUE&street=SOME_STRING_VALUE&language=en®ion=SOME_STRING_VALUE&bounds=-90.0%2C-180.0%2C90.0%2C180.0") .get() .addHeader("x-api-market-key", "SOME_STRING_VALUE") .build(); Response response = client.newCall(request).execute(); ``` {% endtab %} {% endtabs %} **Response** ```json { "results": [ { "address": "505 Howard St, San Francisco, CA 94105, USA", "postal_code": "94105", "country": "United States", "region": "California", "area": "San Francisco County", "locality": "San Francisco", "neighborhood": "SoMa", "street": "Howard Street", "house": "505", "location": { "lat": 37.787926, "lng": -122.396187 }, "location_type": "exact", "type": "street_address" } ] } ``` #### Request and Response of ReverseGeocode #### Request ```bash curl -X 'GET' \ 'https://prod.api.market/api/v1/trueway/geocoding/GeocodingService/ReverseGeocode?location=37.7879493%2C-122.3961974&language=en' \ -H 'accept: application/json' \ -H 'x-api-market-key: API_KEY' ``` #### Response ```json { "results": [ { "address": "505 Howard St, San Francisco, CA 94105, USA", "postal_code": "94105", "country": "United States", "region": "California", "area": "San Francisco County", "locality": "San Francisco", "neighborhood": "SoMa", "street": "Howard Street", "house": "505", "location": { "lat": 37.787926, "lng": -122.396187 }, "location_type": "exact", "type": "poi" }, { "address": "18 Tehama St, San Francisco, CA 94105, USA", "postal_code": "94105", "country": "United States", "region": "California", "area": "San Francisco County", "locality": "San Francisco", "neighborhood": "SoMa", "street": "Tehama Street", "house": "18", "location": { "lat": 37.78795, "lng": -122.396136 }, "location_type": "exact", "type": "street_address" }, { "address": "505 Howard St, San Francisco, CA 94105, USA", "postal_code": "94105", "country": "United States", "region": "California", "area": "San Francisco County", "locality": "San Francisco", "neighborhood": "SoMa", "street": "Howard Street", "house": "505", "location": { "lat": 37.787926, "lng": -122.396187 }, "location_type": "exact", "type": "street_address" }, { "address": "22 Tehama St, San Francisco, CA 94105, USA", "postal_code": "94105", "country": "United States", "region": "California", "area": "San Francisco County", "locality": "San Francisco", "neighborhood": "SoMa", "street": "Tehama Street", "house": "22", "location": { "lat": 37.787717, "lng": -122.395972 }, "location_type": "approximate", "type": "street_address" }, { "address": "QJQ3+5G SoMa, San Francisco, CA, USA", "country": "United States", "region": "California", "area": "San Francisco County", "locality": "San Francisco", "neighborhood": "SoMa", "location": { "lat": 37.787926, "lng": -122.396187 }, "location_type": "centroid", "type": "poi" } ] } ``` ### Developer Portal :