Galli Maps v1.0

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.

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.