Welcome to GalliMaps, the solution for enhancing your customers' map experience with our seamless
and reliable map services. We offer API endpoints, web plugins, and Flutter packages to easily
integrate our services into your products.
To get started, you'll need a GalliMaps access key. Simply Sign Up to create your account with Galli Maps and generate access token through the dashboard to start integrating our map services right away.
Detailed documentation for using our APIs, web plugins, and Flutter packages can be found in their
respective sections on our website.
GETAutocomplete Search API
https://route-init.gallimap.com/api/v1/search/autocomplete?accessToken=[ACCESS-TOKEN]&word=[SEARCH-QUERY-STRING]&lat=[CURRENT-LOCATION-LATITUDE]&lng=[CURRENT-LOCATION-LONGITUDE]
An Autocomplete Search API suggests a list of possible completions based on the user's input. This can help users quickly find the place they are looking for, especially if they are unsure of the exact name or spelling. The autocomplete API can also reduce typing errors and speed up the search process, making it more user-friendly. By passing current latitude and longitude parameters as inputs to the API, it can return a list of matching results in ascending order, with the nearest location at the top.
PARAMS
| acessToken | Token key provided by Galli Team |
| word | Query string to autocomplete (minimum 3 characters) |
| lat | Latitude of current location |
| lng | Longitude of current location |
RESPONSE
{
"success": true,
"message": "AutoComplete",
"data": [
{
"name": "[GENERAL ADDRESS]",
"province": "[PROVINCE]",
"distance": "[DISTANCE]",
"district": "[DISTRICT]",
"municipality": "[MUNICIPALITY]",
"ward": "[WARD NO.]",
"geometry": "[GEOMETRY TYPE]",
"nameLower": "[SHORT NAME]",
"id": "[ADDRESS ID]"
}
...
...
]
}RESPONSE KEYS
- success: (boolean) Indicates whether the API call was successful.
- message: (string) A message from the API, typically indicating the result of the operation.
- data: (array) An array of objects, each representing a suggested address. If there are multiple suggestions, each will be included as an element in this array.
- name: (string) The general address suggested by the API.
- province: (string) The province in which the suggested address is located.
- distance: (string) The distance from the current location to the suggested address.
- district: (string) The district in which the suggested address is located.
- municipality: (string) The municipality in which the suggested address is located.
- ward: (string) The ward number of the suggested address.
- geometry: (string) The type of geometry of the suggested address. It can be a point, polyline, or polygon.
- nameLower: (string) The abbreviated or short form of the suggested address name.
- id: (string) The unique identifier of the suggested address.
The result will be in an array if there is more than one suggestion for the autocomplete word.
Note: To obtain the latitude and longitude of a suggested word, use our Search API. Simply pass the selected autocomplete word to the Search API to fetch its precise coordinates, which can then be used to pin the location on the map. Detailed instructions for using the Search API are provided below.
GET Search API
https://route-init.gallimap.com/api/v1/search/currentLocation?accessToken=[ACCESS-TOKEN]&name=[SEARCH-QUERY-STRING]¤tLat=[CURRENT-LOCATION-LATITUDE]¤tLng=[CURRENT-LOCATION-LONGITUDE]
Search API enables users to search for places, landmarks, or specific house numbers using a search query. The API considers the user's current location as a reference point and returns a list of matching search results in ascending order of proximity, with the nearest place at the top of the list.
PARAMS
| acessToken | Token key provided by Galli Team |
| name | Query string to search |
| currentLat | Latitude of current location |
| currentLng | Longitude of current location |
RESPONSE
{
"success": true,
"message": "Search with Current Location",
"data": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"searchedItem": "[SEARCH WORD]",
"province": "[PROVINCE]",
"district": "[DISTRICT]",
"municipality": "[MUNICIPALITY]",
"ward": "[WARD NO.]",
"distance": [DISTANCE IN METERS]
},
"geometry": {
"type": "[GEOMETRY TYPE]",
"coordinates": [
[LONGITUDE],[LATITUDE]
]
}
}
...
...
]
}
}RESPONSE KEYS
- success: (boolean) Indicates whether the API call was successful.
- message: (string) A message from the API, typically indicating the result of the operation.
- data: (object) Contains the main data returned by the API. It is a GeoJSON object of type FeatureCollection.
- type: (string) Specifies the type of GeoJSON object, which is "FeatureCollection" in this case.
- features: (array) An array of features, each representing a matching search result.
- type (within each feature): (string) Specifies the type of GeoJSON object, which is "Feature" in this case.
- properties (within each feature): (object) Contains various properties of the feature.
- searchedItem: (string) The search word used in the query.
- province: (string) The province where the search result is located.
- district: (string) The district where the search result is located.
- municipality: (string) The municipality where the search result is located.
- ward: (string) The ward number where the search result is located.
- distance: (number) The distance in meters from the current location to the search result.
- geometry (within each feature): (object) Contains geometric information about the feature.
- type: (string) The type of geometry, which can be "Point", "MultiLineString", or "MultiPolygon".
- coordinates: (array) The coordinates of the feature, typically [longitude, latitude] for points.
The result will be in an array if there are multiple matching search results.
GET Reverse Geocoding API
https://route-init.gallimap.com/api/v1/reverse/generalReverse?accessToken=[ACCESS-TOKEN]&lat=[LOCATION-LATITUDE]&lng=[LOCATION-LONGITUDE]
Reverse geocoding API allows users to retrieve location-based information about a given set of latitude and longitude coordinates. By passing the latitude and longitude parameters as inputs to the API, it can return a list of places, landmarks, or specific house numbers located within the vicinity of the given coordinates.
PARAMS
| acessToken | Token key provided by Galli Team |
| lat | Latitude of a location |
| lng | Longitude of a location |
RESPONSE
{
"success": true,
"message": "General Reverse GeoCoding",
"data": {
"generalName": "[ADDRESS NAME]",
"roadName": "[ROAD NAME]",
"place": "[PLACE NAME]",
"municipality": "[MUNICIPALITY]",
"ward": "[WARD NO.]",
"district": "[DISTRICT]",
"province": "[PROVINCE]"
}
}RESPONSE KEYS
- success: (boolean) Indicates whether the API call was successful.
- message: (string) A message from the API, typically indicating the result of the operation.
- data: (object) Contains the main data returned by the API.
- generalName: (string) The general address name. This might be a street name, neighborhood, or other general location description.
- roadName: (string) The name of the road or street.
- place: (string) The name of a specific place or landmark.
- municipality: (string) The municipality where the location is situated.
- ward: (string) The ward number where the location is situated.
- district: (string) The district where the location is situated.
- province: (string) The province where the location is situated.
Note: A few of the keys might return an empty response in case there is no data for those keys at the provided coordinates.
GET Routing API
https://route-init.gallimap.com/api/v1/routing?mode=[MODE-OF-TRANSPORT]&srcLat=[SOURCE-LATITUDE]&srcLng=[SOURCE-LONGITUDE]&dstLat=[DESTINATION-LATITUDE]&dstLng=[DESTINATION-LONGITUDE]&accessToken=[ACCESS-TOKEN]
The Routing API enables users to retrieve optimal routing information between two specified
locations. The API accepts the source latitude and longitude, as well as the destination latitude
and longitude, as inputs and returns the optimal routing coordinates between the two points.
One of the key features of the Routing API is its support for multiple modes of
transportation. Depending on the use case, users may need to plan routes for different modes of
transportation, such as driving, walking, or cycling.
PARAMS
| acessToken | Token key provided by Galli Team |
| mode | Choose from driving, walking, cycling |
| srcLat | Latitude of a source location |
| srcLng | Longitude of a source location |
| dstLat | Latitude of a destination location |
| dstLng | Longitude of a destination location |
RESPONSE
{
"success": true,
"message": "Routing Mode: [WALKING/CYCLING/DRIVING]",
"data": {
"success": true,
"message": "Route Extracted",
"data": [
{
"distance": [DISTANCE],
"duration": [DURATION],
"latlngs": [
[
LONGITUDE,
LATITUDE
],
...
...
[
LONGITUDE,
LATITUDE
]
]
}
]
}
}RESPONSE KEYS
- success: (boolean) Indicates whether the API call was successful.
- message: (string) A message from the API, typically indicating the result of the operation and the mode of transport used for routing.
- data: (object) Contains the main data returned by the API.
- success: (boolean) Indicates whether the route extraction was successful.
- message: (string) A message indicating that the route has been extracted.
- data: (array) An array of route information objects, each containing details about a specific route.
- distance: (number) The total distance of the route in meters.
- duration: (number) The total duration of the route in seconds.
- latlngs: (array) An array of latitude and longitude pairs representing the coordinates of the route.
- [LONGITUDE, LATITUDE]: (array) A pair of longitude and latitude values.
The result will include multiple latitude and longitude pairs if the route consists of multiple segments.
GET Distance API
https://route-init.gallimap.com/api/v1/routing/distance?mode=[MODE-OF-TRANSPORT]&srcLat=[SOURCE-LATITUDE]&srcLng=[SOURCE-LONGITUDE]&dstLat=[DESTINATION-LATITUDE]&dstLng=[DESTINATION-LONGITUDE]&accessToken=[ACCESS-TOKEN]
The Distance API allows users to retrieve the distance and duration between two specified locations. The API supports multiple modes of transportation, including walking, cycling, and driving. This feature enables users to retrieve distance and duration information specific to each mode of transportation.
PARAMS
| acessToken | Token key provided by Galli Team |
| mode | Choose from driving, walking, cycling |
| srcLat | Latitude of a source location |
| srcLng | Longitude of a source location |
| dstLat | Latitude of a destination location |
| dstLng | Longitude of a destination location |
RESPONSE
{
"success": true,
"message": "Routing Distance and Duration Only Mode: [WALKING/CYCLING/DRIVING]",
"data": {
"success": true,
"message": "Route Extracted",
"data": [
{
"distance": [DISTANCE],
"duration": [DURATION]
}
]
}
}RESPONSE KEYS
- success: (boolean) Indicates whether the API call was successful.
- message: (string) A message from the API, typically indicating the result of the operation and the mode of transport used for routing.
- data: (object) Contains the main data returned by the API.
- success: (boolean) Indicates whether the route extraction was successful.
- message: (string) A message indicating that the route has been extracted.
- data: (array) An array of route information objects, each containing details about a specific route.
- distance: (number) The total distance of the route in meters.
- duration: (number) The total duration of the route in seconds.
The result will include the distance and duration for the specified mode of transport between the source and destination locations.