Route_v2

Flexible instructions to the destination

Method	Request URI	Response Type
POST	https://api.fatos.biz/mogos/v2/route	json(geojson)

Parameters

Request

Parameter	Required	Description	Sample
key	Y	Your API Key	key : xxxxxxxxxxx
origin	Y	Start point (lat, lng)	origin:'37.482767, 126.896290'
destination	Y	End point (lat, lng) For multiple locations '|' Use pipeline	destination:"37.5413623,127.222658|37.750899297688065,127.06066732772979"
option	Y	Route search option "1" Fixed	"option": "1"
option_ex	Y	Route search additional option "1" Fixed	"option_ex": "1"
cartype	Y	Vehicle type (transportation means) 1 : passenger car 127 : Motorcycle	"cartype": "1"
case	Y	Single Route = case "1" Multi Route = case "2"	"case": "1"
lang	N	Select Result Language(Korean: ko, English: en)default = ko	lang:ko
returntype	N	Output format default = json	returntype:json

​

POST Request Sample

body: {
    "key": <API KEY>,
    "origin": "37.482767, 126.896290",
    "destination": "37.5413623,127.222658|37.750899297688065,127.06066732772979",    
    "option": "1",
    "option_ex": "1",
    "cartype": "1",
    "case": "1",
    "lang": "en",
    "returntype": "json"
}

Response

type	string	A GeoJSON object with the type "FeatureCollection" is a feature collection object
features	node	An object of type "FeatureCollection" must have a member with the name "features".
type	string	A GeoJSON object with the type "Feature" is a feature object
geometry	object	Geometry has type and coordinates information
coordinates	array<double>	position
properties	object	Property information
summary	string	road information
distance	int	Total or link distance / m
duration	int	Total or link duration /sec
start_name	string	start name
end_name	string	end name
max_lat	double	Maximum latitude
max_lng	double	Maximum longitude
min_lat	double	Minimum latittude
min_lng	double	Minimum longitude
length	int	link length
remainder_dist	int	remainder distance
remainder_time	int	remainder time
attr_turn_code	int	turn code
attr_road_cate	int	road type code
attr_link_facil	int	Facility code
attr_oneway	int	a one-way street
attr_lane	int	the number of lanes
attr_median	int	Presence of median strip

Response Sample

{
    "name": "0,rp_info",
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    126.89654767513275,
                    37.48329453587037
                ]
            },
            "properties": {
                "summary": "여의대방로|올림픽대로|동부간선도로",
                "summary_ex": "126.921298,37.502302,3482|127.061807,37.521288,24116|127.055271,37.651043,13540",
                "distance": 78927,
                "duration": 9435,
                "start_name": "start1",
                "end_name": "dest1",
                "max_lat": 37.75095262788366,
                "max_lng": 127.22248350407688,
                "min_lat": 37.482647803168845,
                "min_lng": 126.89699827472333,
                "type": "start"
            }
        },
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    127.22265601158142,
                    37.54136032779845
                ]
            },
            "properties": {
                "type": "via"
            }
        },
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    127.060666680336,
                    37.75090006731859
                ]
            },
            "properties": {
                "type": "end"
            }
        },
        {
            "type": "Feature",
            "geometry": {
                "type": "LineString",
                "coordinates": [
                    [
                        126.89654767513275,
                        37.48329453587037
                    ],
                    [
                        126.89654767513275,
                        37.48329453587037
                    ]
                ]
            },
            "properties": {
                "type": 1,
                "attr": 0,
                "attr_has_hipass": 0,
                "attr_has_ic": 0,
                "attr_has_jc": 0,
                "attr_has_outpath": 0,
                "attr_has_sa": 0,
                "attr_has_toll": 0,
                "attr_lane": 0,
                "attr_link_cate": 0,
                "attr_link_facil": 0,
                "attr_max_speed": 0,
                "attr_median": 0,
                "attr_oneway": 0,
                "attr_road_cate": 0,
                "attr_string": "0",
                "attr_surface": 0,
                "attr_traffic": 0,
                "attr_turn_code": 0,
                "duration": 0,
                "lane_guide": "0",
                "length": 0,
                "link_dir": 0,
                "link_id": 0,
                "link_idx": 0,
                "remainder_dist": 0,
                "remainder_time": 0,
                "service_link_idx": 0,
                "string_info": ""
            }
        },
        
     	...
        
        {
            "type": "Feature",
            "geometry": {
                "type": "LineString",
                "coordinates": [
                    [
                        127.06038773059845,
                        37.75068769883081
                    ],
                    [
                        127.0604145526886,
                        37.75079813044446
                    ]
                ]
            },
            "properties": {
                "type": 3,
                "attr": 517543628800.0,
                "attr_has_hipass": 0,
                "attr_has_ic": 0,
                "attr_has_jc": 0,
                "attr_has_outpath": 0,
                "attr_has_sa": 0,
                "attr_has_toll": 0,
                "attr_lane": 2,
                "attr_link_cate": 1,
                "attr_link_facil": 0,
                "attr_max_speed": 30,
                "attr_median": 0,
                "attr_oneway": 0,
                "attr_road_cate": 8,
                "attr_string": "517543628800",
                "attr_surface": 0,
                "attr_traffic": 0,
                "attr_turn_code": 0,
                "duration": 2,
                "length": 12,
                "link_dir": 0,
                "link_id": 221131,
                "link_idx": 516,
                "remainder_dist": 29,
                "remainder_time": 5,
                "service_link_idx": 0,
                "string_info": "|거북로4번길||||||"
            }
        },
        {
            "type": "Feature",
            "geometry": {
                "type": "LineString",
                "coordinates": [
                    [
                        127.0604145526886,
                        37.75079813044446
                    ],
                    [
                        127.06045210361481,
                        37.750951035755655
                    ]
                ]
            },
            "properties": {
                "type": 3,
                "attr": 517543628850.0,
                "attr_has_hipass": 0,
                "attr_has_ic": 0,
                "attr_has_jc": 0,
                "attr_has_outpath": 0,
                "attr_has_sa": 0,
                "attr_has_toll": 0,
                "attr_lane": 2,
                "attr_link_cate": 1,
                "attr_link_facil": 0,
                "attr_max_speed": 30,
                "attr_median": 0,
                "attr_oneway": 0,
                "attr_road_cate": 8,
                "attr_string": "517543628850",
                "attr_surface": 0,
                "attr_traffic": 0,
                "attr_turn_code": 50,
                "duration": 3,
                "length": 17,
                "link_dir": 1,
                "link_id": 220580,
                "link_idx": 517,
                "remainder_dist": 17,
                "remainder_time": 3,
                "service_link_idx": 0,
                "string_info": "|거북로4번길||||||목적지"
            }
        },
        {
            "type": "Feature",
            "geometry": {
                "type": "LineString",
                "coordinates": [
                    [
                        127.06045210361481,
                        37.750951035755655
                    ],
                    [
                        127.060666680336,
                        37.75090006731859
                    ]
                ]
            },
            "properties": {
                "type": 5,
                "attr": 0,
                "attr_has_hipass": 0,
                "attr_has_ic": 0,
                "attr_has_jc": 0,
                "attr_has_outpath": 0,
                "attr_has_sa": 0,
                "attr_has_toll": 0,
                "attr_lane": 0,
                "attr_link_cate": 0,
                "attr_link_facil": 0,
                "attr_max_speed": 0,
                "attr_median": 0,
                "attr_oneway": 0,
                "attr_road_cate": 0,
                "attr_string": "0",
                "attr_surface": 0,
                "attr_traffic": 0,
                "attr_turn_code": 0,
                "duration": 39,
                "lane_guide": "0",
                "length": 20,
                "link_dir": 0,
                "link_id": 0,
                "link_idx": 0,
                "remainder_dist": 0,
                "remainder_time": 0,
                "service_link_idx": 0,
                "string_info": "|거북로4번길||||||목적지"
            }
        }
    ]
}