GEOCODE – GET ADDRESS INFORMATION

OVERVIEW

Geocode is an API that converts addresses (such as home or business addresses) into geographic coordinates (longitude, latitude) and place_id, or vice versa. This API allows you to convert an address or geographic coordinates into various geographic information such as location, postal code, district, and even business places.

Map fusion Geocode API has two main types:

1. Reverse Geocode: Converts geographic coordinates (longitude, latitude) into an address.
2. Forward Geocode: Converts an address into geographic coordinates.

Why use Geocode
Geocode is used on websites or mobile apps when you need to convert an address into coordinates to display on a map, or vice versa, converting coordinates into an address to help display content on maps within the Map fusion platform.

You can use the Geocode API when you have a full address, for example, “Shwedagon Pagoda, Yangon, Myanmar“

How Geocode Works

• Forward Geocode: Converts addresses such as “Shwedagon Pagoda, Yangon, Myanmar” into latitude and longitude coordinates. You can use these coordinates to place markers on a map, center the map, or re-locate it in the view frame.
• Reverse Geocode: Converts latitude/longitude or place_id into a readable address. You can use the address for various purposes, including deliveries or pickups.

How to use Geocode

First, you need to register an account and create your Map fusion API key by following the detailed instructions here.

URL: /geocode

Method: GET

CONVERTING COORDINATES TO ADDRESS (FORWARD GEOCODE)

Definition
Forward geocode is the process of converting a specific address into geographic coordinates (latitude and longitude). When you input an address into the system, the Geocode service will search for and return the corresponding coordinates for that address.

How Forward Geocode Works
When you enter an address, the system performs the process of converting the text information into geographic coordinates (latitude, longitude) on the map. This process includes:

• Data Normalization: The system will clean the input data, removing unnecessary words and organizing the address information into a specific structure.
• Database Search: The system compares the normalized address with geographic information available in its database.
• Returning Results: When a matching result is found, the system will return the corresponding geographic coordinates along with additional information such as street names, districts, and so on.

How to integrate map fusion forward geocode

Required parameter

• address – The address for which you want to obtain the coordinates.

Example of request:

'https://api.mapfusion.io/v1/geocode?address=%E1%80%98%E1%80%B1%E1%80%97%E1%80%AD%E1%80%94%E1%80%BA%E1%80%B7%E1%80%99%E1%80%B1%E1%80%AC%E1%80%84%E1%80%BA%E1%80%98%E1%80%AF%E1%80%9B%E1%80%AC%E1%80%B8&api_key={YOUR_API_KEY}'

Example Response:

{
    "results": [
        {
            "address_components": [
                {
                    "long_name": "ဘေဗိန့်မောင်ဘုရား",
                    "short_name": "ဘေဗိန့်မောင်ဘုရား"
                },
                {
                    "long_name": "Sa Par Kywei",
                    "short_name": "Sa Par Kywei"
                },
                {
                    "long_name": "Myanmar",
                    "short_name": "Myanmar"
                }
            ],
            "formatted_address": "ဘေဗိန့်မောင်ဘုရား, Sa Par Kywei, Myanmar",
            "geometry": {
                "location": {
                    "lat": 18.9676133,
                    "lng": 96.3079795
                }
            },
            "place_id": "2680688",
            "reference": "2680688",
            "types": [],
            "name": "ဘေဗိန့်မောင်ဘုရား",
            "address": "Sa Par Kywei, Myanmar"
        }
    ],
    "status": "OK"
}

"plus_code": {
        "compound_code": "Q5C9+QJ Yangon, Myanmar",
        "global_code": "7P39Q5C9+QJ"
      },

[
   “house_number”
]

hvQsDQGiINkZG7D82VhHBzyFnHdPRTtU3
Gg6Xek6b_LPmrVmPWd6XSZgVEHZtrTX/lV8FICmrh
ROonRV5FHT4yE==.bm9ybWFs

 {
          "long_name": "Inya Lake",
          "short_name": "Inya Lake"
        },
        {
          "long_name": "Kabar Aye Pagoda Rd",
          "short_name": "Kabar Aye Pagoda Rd"
        },

CRdosr1ubzGqZwEhsJV2xKkCmeNrXbNmYY_
3IMQoaBxeuLQhZqYnZDX92dmu1_EUr7SNa9oZ
cEdGn0w6Ln5J1A==.bm9ybWFs

{
   “location”: {
      “lat”: 21.013672808000024,
       “lng”: 105.79825090900005
   },
   “boundary”: “ofg_CuvvdSjBLCf@kBMBg@”

REVERSE GEOCODE: CONVERT COORDINATES TO ADDRESS

Definition

Reverse geocode is the process of converting coordinates (latitude and longitude) into a specific address or descriptive information about a location, such as street name, city, or country. This service is often used in cases where the coordinates of a certain location are known, but its address or specific details need to be determined.

How Reverse Geocode Works

Unlike forward geocode, reverse geocode performs the reverse operation: converting a pair of geographic coordinates (latitude, longitude) into a specific address. When you provide a location (longitude, latitude), the system searches the geographic database to determine the nearest address to that location. The returned result may include house numbers, street names, cities, and other detailed information.

How to Create a Reverse Geocode Request

Required Parameters

• latlng: The coordinates of the point for which information is needed.

Example Request:

https://api.mapfusion.io/v1/geocode?api_key={YOUR_API_KEY}&latlng=18.973159%2C%2096.310605'

Example Response:

{
    "results": [
        {
            "address_components": [
                {
                    "long_name": "ဘေဗိန့်မောင်ဘုရား",
                    "short_name": "ဘေဗိန့်မောင်ဘုရား"
                },
                {
                    "long_name": "Sa Par Kywei",

                    "short_name": "Sa Par Kywei"
                },
                {
                    "long_name": "Myanmar",
                    "short_name": "Myanmar"
                }
            ],
            "formatted_address": "ဘေဗိန့်မောင်ဘုရား, Sa Par Kywei, Myanmar",
            "geometry": {
                "location": {
                    "lat": 18.9676133,
                    "lng": 96.3079795
               }
            },
            "place_id": "2680688",
            "reference": "2680688",
            "types": [],
            "name": "ဘေဗိန့်မောင်ဘုရား",
            "address": "Sa Par Kywei, Myanmar"
        }
    ],
    "status": "OK"
}

{
 "compound_code": "+7QHX Bahan, Yangon, Myanmar", "global_code": "7QHX+7QHX"
 }

[
   “house_number”
]

[ 
{ 
"long_name": "Sakura Tower", "short_name": "Sakura Tower"
 }, 
{ 
"long_name": "Pyay Road", "short_name": "Pyay Rd"
 }, 
{ 
"long_name": "Bahan", "short_name": "Bahan" 
}, 
{ "long_name": "Yangon", "short_name": "Yangon" 
},
 { 
"long_name": "Myanmar", "short_name": "Myanmar" 
}
 ]

{
 "location": {
 "lat": 16.786443,
 "lng": 96.159425
 }, 
"boundary":"ofg_Si8qVnxBmM1p@5CB"_CuvvdSjBLCf@kBMBg@”
}

CONCLUSION

The MapFusion Geocode API is a reliable and efficient solution for processing geographic data with precision. By converting addresses into coordinates (Forward Geocode) and coordinates into addresses (Reverse Geocode), this API enhances map-based services, making it an excellent choice for ride-hailing, delivery, travel, and other location-dependent applications.

Integrating the Geocode API into your system can improve navigation accuracy, enhance user experience, and optimize location-based services. Start using the MapFusion Geocode API today to harness the full power of digital mapping!