{"_id":"560dac776660a03700976de2","category":{"_id":"560dac2cd10a730d0081ac92","project":"560d5ac71ec45619006069d6","version":"560d5ac71ec45619006069d9","__v":2,"pages":["560dac776660a03700976de2","560dac8a2254e70d00f90b6b"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-01T21:57:00.777Z","from_sync":false,"order":2,"slug":"on-highway-functionality","title":"On Highway Functionality"},"project":"560d5ac71ec45619006069d6","version":{"_id":"560d5ac71ec45619006069d9","__v":6,"project":"560d5ac71ec45619006069d6","createdAt":"2015-10-01T16:09:43.711Z","releaseDate":"2015-10-01T16:09:43.711Z","categories":["560d5ac81ec45619006069da","560dabb698a6ae3700673f9f","560dabe1961d492300d94b4b","560dac2cd10a730d0081ac92","560dacb26660a03700976de4","560ebbffcac9dc0d007af87a"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"githubsync":"","user":"560d5a4faf97231900938125","editedParams":true,"editedParams2":true,"__v":2,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-10-01T21:58:15.902Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"method":"get","results":{"codes":[{"status":200,"language":"json","code":"{\n  \"status\": 100,\n  \"status_message\": \"On Highway\",\n  \"exits\": [\n    {\n      \"id\": 14690,\n      \"exit_latitude\": \"33.508211\",\n      \"exit_longitude\": \"-86.818687\",\n      \"destination_latitude\": \"33.510356\",\n      \"destination_longitude\": \"-86.819406\",\n      \"city\": \"Birmingham\",\n      \"state\": \"Alabama\",\n      \"postal_code\": \"35203\",\n      \"exit_description\": \"3rd Ave N\",\n      \"sign_label_line_one\": \"EXIT\",\n      \"sign_label_line_two\": \"260B\",\n      \"sign_number\": \"260B\",\n      \"formatted_sign_name\": \"Exit 260B\",\n      \"highway_exit_type_id\": 1,\n      \"highway_exit_type\": \"Exit\",\n      \"highway_exit_sign_background_color\": \"#67B964\",\n      \"highway_exit_sign_text_color\": \"#ffffff\",\n      \"highway_in_state\": {\n        \"id\": 656,\n        \"highway\": {\n          \"id\": 42,\n          \"display_name\": \"I-65\",\n          \"sign_name\": \"65\",\n          \"sign_web_background_image\": \"interstate-bg.svg\",\n          \"sign_background_image_small\": \"interstatesign_small.png\",\n          \"sign_background_image_large\": \"interstatesign_large.png\",\n          \"sign_text_color\": \"#FFFFFF\",\n          \"highway_sign_class\": \"interstate-bg\",\n          \"highway_type_id\": 1,\n          \"highway_type\": \"Interstate\",\n          \"positive_direction\": \"North\",\n          \"negative_direction\": \"South\",\n          \"direction_suffix\": \"bound\"\n        },\n        \"state\": {\n          \"id\": 1,\n          \"short_name\": \"AL\",\n          \"long_name\": \"Alabama\"\n        },\n        \"direction\": {\n          \"current_direction\": \"North\",\n          \"reverse_direction\": \"South\",\n          \"direction_suffix\": \"bound\"\n        }\n      }\n    }\n  ]\n}","name":"On Highway"},{"code":"{\n  \"status\": 200,\n  \"status_message\": \"Near Highway\",\n  \"exits\": [\n    {\n      \"id\": 14690,\n      \"exit_latitude\": \"33.508211\",\n      \"exit_longitude\": \"-86.818687\",\n      \"destination_latitude\": \"33.510356\",\n      \"destination_longitude\": \"-86.819406\",\n      \"city\": \"Birmingham\",\n      \"state\": \"Alabama\",\n      \"postal_code\": \"35203\",\n      \"exit_description\": \"3rd Ave N\",\n      \"sign_label_line_one\": \"EXIT\",\n      \"sign_label_line_two\": \"260B\",\n      \"sign_number\": \"260B\",\n      \"formatted_sign_name\": \"Exit 260B\",\n      \"highway_exit_type_id\": 1,\n      \"highway_exit_type\": \"Exit\",\n      \"highway_exit_sign_background_color\": \"#67B964\",\n      \"highway_exit_sign_text_color\": \"#ffffff\",\n      \"highway_in_state\": {\n        \"id\": 656,\n        \"highway\": {\n          \"id\": 42,\n          \"display_name\": \"I-65\",\n          \"sign_name\": \"65\",\n          \"sign_web_background_image\": \"interstate-bg.svg\",\n          \"sign_background_image_small\": \"interstatesign_small.png\",\n          \"sign_background_image_large\": \"interstatesign_large.png\",\n          \"sign_text_color\": \"#FFFFFF\",\n          \"highway_sign_class\": \"interstate-bg\",\n          \"highway_type_id\": 1,\n          \"highway_type\": \"Interstate\",\n          \"positive_direction\": \"North\",\n          \"negative_direction\": \"South\",\n          \"direction_suffix\": \"bound\"\n        },\n        \"state\": {\n          \"id\": 1,\n          \"short_name\": \"AL\",\n          \"long_name\": \"Alabama\"\n        },\n        \"direction\": {\n          \"current_direction\": \"North\",\n          \"reverse_direction\": \"South\",\n          \"direction_suffix\": \"bound\"\n        }\n      }\n    },\n    {\n      \"id\": 15101,\n      \"exit_latitude\": \"33.514801\",\n      \"exit_longitude\": \"-86.823554\",\n      \"destination_latitude\": \"33.512667\",\n      \"destination_longitude\": \"-86.822745\",\n      \"city\": \"Birmingham\",\n      \"state\": \"Alabama\",\n      \"postal_code\": \"35204\",\n      \"exit_description\": \"6th Ave N; Downtown\",\n      \"sign_label_line_one\": \"EXIT\",\n      \"sign_label_line_two\": \"260\",\n      \"sign_number\": \"260\",\n      \"formatted_sign_name\": \"Exit 260\",\n      \"highway_exit_type_id\": 1,\n      \"highway_exit_type\": \"Exit\",\n      \"highway_exit_sign_background_color\": \"#67B964\",\n      \"highway_exit_sign_text_color\": \"#ffffff\",\n      \"highway_in_state\": {\n        \"id\": 656,\n        \"highway\": {\n          \"id\": 42,\n          \"display_name\": \"I-65\",\n          \"sign_name\": \"65\",\n          \"sign_web_background_image\": \"interstate-bg.svg\",\n          \"sign_background_image_small\": \"interstatesign_small.png\",\n          \"sign_background_image_large\": \"interstatesign_large.png\",\n          \"sign_text_color\": \"#FFFFFF\",\n          \"highway_sign_class\": \"interstate-bg\",\n          \"highway_type_id\": 1,\n          \"highway_type\": \"Interstate\",\n          \"positive_direction\": \"North\",\n          \"negative_direction\": \"South\",\n          \"direction_suffix\": \"bound\"\n        },\n        \"state\": {\n          \"id\": 1,\n          \"short_name\": \"AL\",\n          \"long_name\": \"Alabama\"\n        },\n        \"direction\": {\n          \"current_direction\": \"South\",\n          \"reverse_direction\": \"North\",\n          \"direction_suffix\": \"bound\"\n        }\n      }\n    },\n    {\n      \"id\": 14455,\n      \"exit_latitude\": \"33.519851\",\n      \"exit_longitude\": \"-86.818642\",\n      \"destination_latitude\": \"33.519886\",\n      \"destination_longitude\": \"-86.814979\",\n      \"city\": \"Birmingham\",\n      \"state\": \"Alabama\",\n      \"postal_code\": \"35203\",\n      \"exit_description\": \"17th St; Downtown\",\n      \"sign_label_line_one\": \"EXIT\",\n      \"sign_label_line_two\": \"125A\",\n      \"sign_number\": \"125A\",\n      \"formatted_sign_name\": \"Exit 125A\",\n      \"highway_exit_type_id\": 1,\n      \"highway_exit_type\": \"Exit\",\n      \"highway_exit_sign_background_color\": \"#67B964\",\n      \"highway_exit_sign_text_color\": \"#ffffff\",\n      \"highway_in_state\": {\n        \"id\": 662,\n        \"highway\": {\n          \"id\": 41,\n          \"display_name\": \"I-59\",\n          \"sign_name\": \"59\",\n          \"sign_web_background_image\": \"interstate-bg.svg\",\n          \"sign_background_image_small\": \"interstatesign_small.png\",\n          \"sign_background_image_large\": \"interstatesign_large.png\",\n          \"sign_text_color\": \"#FFFFFF\",\n          \"highway_sign_class\": \"interstate-bg\",\n          \"highway_type_id\": 1,\n          \"highway_type\": \"Interstate\",\n          \"positive_direction\": \"North\",\n          \"negative_direction\": \"South\",\n          \"direction_suffix\": \"bound\"\n        },\n        \"state\": {\n          \"id\": 1,\n          \"short_name\": \"AL\",\n          \"long_name\": \"Alabama\"\n        },\n        \"direction\": {\n          \"current_direction\": \"North\",\n          \"reverse_direction\": \"South\",\n          \"direction_suffix\": \"bound\"\n        }\n      }\n    },\n    {\n      \"id\": 11443,\n      \"exit_latitude\": \"33.519851\",\n      \"exit_longitude\": \"-86.818642\",\n      \"destination_latitude\": \"33.519886\",\n      \"destination_longitude\": \"-86.814979\",\n      \"city\": \"Birmingham\",\n      \"state\": \"Alabama\",\n      \"postal_code\": \"35203\",\n      \"exit_description\": \"17th St; Downtown\",\n      \"sign_label_line_one\": \"EXIT\",\n      \"sign_label_line_two\": \"125A\",\n      \"sign_number\": \"125A\",\n      \"formatted_sign_name\": \"Exit 125A\",\n      \"highway_exit_type_id\": 1,\n      \"highway_exit_type\": \"Exit\",\n      \"highway_exit_sign_background_color\": \"#67B964\",\n      \"highway_exit_sign_text_color\": \"#ffffff\",\n      \"highway_in_state\": {\n        \"id\": 667,\n        \"highway\": {\n          \"id\": 36,\n          \"display_name\": \"I-20\",\n          \"sign_name\": \"20\",\n          \"sign_web_background_image\": \"interstate-bg.svg\",\n          \"sign_background_image_small\": \"interstatesign_small.png\",\n          \"sign_background_image_large\": \"interstatesign_large.png\",\n          \"sign_text_color\": \"#FFFFFF\",\n          \"highway_sign_class\": \"interstate-bg\",\n          \"highway_type_id\": 1,\n          \"highway_type\": \"Interstate\",\n          \"positive_direction\": \"East\",\n          \"negative_direction\": \"West\",\n          \"direction_suffix\": \"bound\"\n        },\n        \"state\": {\n          \"id\": 1,\n          \"short_name\": \"AL\",\n          \"long_name\": \"Alabama\"\n        },\n        \"direction\": {\n          \"current_direction\": \"East\",\n          \"reverse_direction\": \"West\",\n          \"direction_suffix\": \"bound\"\n        }\n      }\n    },\n    {\n      \"id\": 14523,\n      \"exit_latitude\": \"33.520848\",\n      \"exit_longitude\": \"-86.82034\",\n      \"destination_latitude\": null,\n      \"destination_longitude\": null,\n      \"city\": \"Birmingham\",\n      \"state\": \"Alabama\",\n      \"postal_code\": \"35203\",\n      \"exit_description\": \"I 65\",\n      \"sign_label_line_one\": \"EXIT\",\n      \"sign_label_line_two\": \"124B\",\n      \"sign_number\": \"124B\",\n      \"formatted_sign_name\": \"Exit 124B\",\n      \"highway_exit_type_id\": 9,\n      \"highway_exit_type\": \"Junction\",\n      \"highway_exit_sign_background_color\": \"#67B964\",\n      \"highway_exit_sign_text_color\": \"#ffffff\",\n      \"highway_in_state\": {\n        \"id\": 662,\n        \"highway\": {\n          \"id\": 41,\n          \"display_name\": \"I-59\",\n          \"sign_name\": \"59\",\n          \"sign_web_background_image\": \"interstate-bg.svg\",\n          \"sign_background_image_small\": \"interstatesign_small.png\",\n          \"sign_background_image_large\": \"interstatesign_large.png\",\n          \"sign_text_color\": \"#FFFFFF\",\n          \"highway_sign_class\": \"interstate-bg\",\n          \"highway_type_id\": 1,\n          \"highway_type\": \"Interstate\",\n          \"positive_direction\": \"North\",\n          \"negative_direction\": \"South\",\n          \"direction_suffix\": \"bound\"\n        },\n        \"state\": {\n          \"id\": 1,\n          \"short_name\": \"AL\",\n          \"long_name\": \"Alabama\"\n        },\n        \"direction\": {\n          \"current_direction\": \"South\",\n          \"reverse_direction\": \"North\",\n          \"direction_suffix\": \"bound\"\n        }\n      }\n    },\n    {\n      \"id\": 11745,\n      \"exit_latitude\": \"33.520848\",\n      \"exit_longitude\": \"-86.82034\",\n      \"destination_latitude\": null,\n      \"destination_longitude\": null,\n      \"city\": \"Birmingham\",\n      \"state\": \"Alabama\",\n      \"postal_code\": \"35203\",\n      \"exit_description\": \"I 65\",\n      \"sign_label_line_one\": \"EXIT\",\n      \"sign_label_line_two\": \"124B\",\n      \"sign_number\": \"124B\",\n      \"formatted_sign_name\": \"Exit 124B\",\n      \"highway_exit_type_id\": 9,\n      \"highway_exit_type\": \"Junction\",\n      \"highway_exit_sign_background_color\": \"#67B964\",\n      \"highway_exit_sign_text_color\": \"#ffffff\",\n      \"highway_in_state\": {\n        \"id\": 667,\n        \"highway\": {\n          \"id\": 36,\n          \"display_name\": \"I-20\",\n          \"sign_name\": \"20\",\n          \"sign_web_background_image\": \"interstate-bg.svg\",\n          \"sign_background_image_small\": \"interstatesign_small.png\",\n          \"sign_background_image_large\": \"interstatesign_large.png\",\n          \"sign_text_color\": \"#FFFFFF\",\n          \"highway_sign_class\": \"interstate-bg\",\n          \"highway_type_id\": 1,\n          \"highway_type\": \"Interstate\",\n          \"positive_direction\": \"East\",\n          \"negative_direction\": \"West\",\n          \"direction_suffix\": \"bound\"\n        },\n        \"state\": {\n          \"id\": 1,\n          \"short_name\": \"AL\",\n          \"long_name\": \"Alabama\"\n        },\n        \"direction\": {\n          \"current_direction\": \"West\",\n          \"reverse_direction\": \"East\",\n          \"direction_suffix\": \"bound\"\n        }\n      }\n    }\n  ]\n}","language":"json","status":200,"name":"Near Highway"},{"name":"Not On Highway","code":"{\n  \"status\": 300,\n  \"status_message\": \"Not On Highway\"\n}","language":"json","status":200}]},"settings":"","examples":{"codes":[]},"auth":"optional","params":[{"_id":"560eaa36dfdd5a2100e8f019","ref":"","in":"path","required":true,"desc":"Latitude of the user's previous location","default":"","type":"double","name":"first_latitude"},{"_id":"560ead6439fad419002ae1d6","ref":"","in":"path","required":true,"desc":"Longitude of the user's previous location","default":"","type":"double","name":"first_longitude"},{"_id":"560ead6439fad419002ae1d5","ref":"","in":"path","required":false,"desc":"Latitude of the user's current location","default":"","type":"double","name":"second_latitude"},{"_id":"560ead6439fad419002ae1d4","ref":"","in":"path","required":false,"desc":"Longitude of the user's current location","default":"","type":"double","name":"second_longitude"}],"url":"/highwaydetection/:first_latitude/:first_longitude/:second_latitude/:second_longitude"},"isReference":false,"order":0,"body":"** JSON Response **\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Key\",\n    \"h-1\": \"Value\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"`status`\",\n    \"0-1\": \"Integer\",\n    \"0-2\": \"100 = On Highway\\n200 = Near Highway\\n300 = Not On Highway\",\n    \"2-0\": \"`exits`\",\n    \"2-1\": \"Array of [Exit](doc:exit)s\",\n    \"2-2\": \"[Optional]. This is only present if we are \\\"On Highway\\\" or \\\"Near Highway\\\".\\n\\nIf in the case of \\\"Near Highway\\\", you can present the user with a menu comprised of all results from this array and let them select which highway they would like to be placed on.\\n\\nIf present, you can feed the `exit`.`id` to the [Upcoming Exits API](doc:upcoming-exits).\",\n    \"1-0\": \"`status_message`\",\n    \"1-1\": \"String\",\n    \"1-2\": \"\\\"On Highway\\\", \\\"Near Highway\\\", or \\\"Not On Highway\\\"\"\n  },\n  \"cols\": 3,\n  \"rows\": 3\n}\n[/block]\nThe most powerful capability of the iExit API is to be able to detect if a user is currently traveling on an exit-based highway and if so, display upcoming exits ahead of them in real time. You should be able to picture this as a nice feature that pops up on your smart car's infotainment dashboard the moment you pull onto the highway. This API, along with the [Upcoming Exits API](doc:upcoming-exits), make this possible.\n\nThe idea behind the On Highway Detection API is simple: provide two consecutive locations so that we may know your direction of travel, and it will return whether you are on or off the highway. Look at the example below, where the red pin (`<33.509739, -86.819707>`) is the user's previous location and the green pin (`<33.511262, -86.820773>`) is their current location.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/l9XsF7hScyX5QGA9uGqF_Screen%20Shot%202015-10-02%20at%2012.08.04%20PM.png\",\n        \"Screen Shot 2015-10-02 at 12.08.04 PM.png\",\n        \"434\",\n        \"436\",\n        \"#c2373b\",\n        \"\"\n      ],\n      \"caption\": \"The two coordinates used in the above example of a successful `On Highway` detection. The red coordinate is the user's previous location, and the green is their current location. They are, in fact, traveling on I-65 Northbound.\"\n    }\n  ]\n}\n[/block]\nAs you can see, this user is traveling on I-65 Northbound near Birmingham, Alabama. And if you enter these two coordinates into this API, you will see that it returns a `status` of \"On Highway\" along with an [Exit](doc:exit) object in the `starting_exit` field to use with the [Upcoming Exits API](doc:upcoming-exits).\n\nNow consider the example below. The red previous location (`<33.511273, -86.820006>`) and the green current location (`<33.510638, -86.821334>`) show that the user is not on the highway. Despite these location's proximity to I-65, they are traveling perpendicular to the highway, which the API is smart enough to detect. So because this user is not on the highway, we will not return a Status:100 response. But since they are near several highway (I-65, I-20, and I-59), we will return a Status:200 (Near Highway) response with 6 exits in the `exits` array. These 6 exits are made up of 1) I-65 N, 2) I-65 S, 3) I-20 E, 4) I-20 W, 5) I-59 N, and 6) I-59 S.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/hUyTvsl5QmeeOOnobQxf_Screen%20Shot%202015-10-02%20at%2012.13.01%20PM.png\",\n        \"Screen Shot 2015-10-02 at 12.13.01 PM.png\",\n        \"518\",\n        \"492\",\n        \"#b24445\",\n        \"\"\n      ],\n      \"caption\": \"These two coordinates would result in this API returning `Not On Highway`. Even though they are near I-65, their direction of travel prevents them from being placed on I-65.\"\n    }\n  ]\n}\n[/block]\nIn the iExit Android app, when a user selects \"Fine Me On The Highway\", the first step is to make a background HTTP request to this API. If it returns with a Status:100 (On Highway) response, then we know the user is on the highway and then we can use the `exit`.`id` value as input to the [Upcoming Exits API](doc:upcoming-exits).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5UmHNvuvRnKHQ8XxcdhS_FindingOnHighway.png\",\n        \"FindingOnHighway.png\",\n        \"720\",\n        \"1280\",\n        \"#1f4636\",\n        \"\"\n      ],\n      \"caption\": \"This is the overlay shown in the iExit Android app when it's requesting this API to determine if the user is on the highway.\"\n    }\n  ]\n}\n[/block]\n** Common Next API(s) **\n- [Upcoming Exits](doc:upcoming-exits) (by using `starting_exit`.`id` if `status` == \"On Highway\".","excerpt":"Detects if the user is traveling on an exit-based US highway by using two consecutive location coordinates.","slug":"on-highway-detection","type":"endpoint","title":"On Highway Detection"}

getOn Highway Detection

Detects if the user is traveling on an exit-based US highway by using two consecutive location coordinates.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

first_latitude:
required
double
Latitude of the user's previous location
first_longitude:
required
double
Longitude of the user's previous location
second_latitude:
double
Latitude of the user's current location
second_longitude:
double
Longitude of the user's current location

Result Format


Documentation

** JSON Response ** [block:parameters] { "data": { "h-0": "Key", "h-1": "Value", "h-2": "Description", "0-0": "`status`", "0-1": "Integer", "0-2": "100 = On Highway\n200 = Near Highway\n300 = Not On Highway", "2-0": "`exits`", "2-1": "Array of [Exit](doc:exit)s", "2-2": "[Optional]. This is only present if we are \"On Highway\" or \"Near Highway\".\n\nIf in the case of \"Near Highway\", you can present the user with a menu comprised of all results from this array and let them select which highway they would like to be placed on.\n\nIf present, you can feed the `exit`.`id` to the [Upcoming Exits API](doc:upcoming-exits).", "1-0": "`status_message`", "1-1": "String", "1-2": "\"On Highway\", \"Near Highway\", or \"Not On Highway\"" }, "cols": 3, "rows": 3 } [/block] The most powerful capability of the iExit API is to be able to detect if a user is currently traveling on an exit-based highway and if so, display upcoming exits ahead of them in real time. You should be able to picture this as a nice feature that pops up on your smart car's infotainment dashboard the moment you pull onto the highway. This API, along with the [Upcoming Exits API](doc:upcoming-exits), make this possible. The idea behind the On Highway Detection API is simple: provide two consecutive locations so that we may know your direction of travel, and it will return whether you are on or off the highway. Look at the example below, where the red pin (`<33.509739, -86.819707>`) is the user's previous location and the green pin (`<33.511262, -86.820773>`) is their current location. [block:image] { "images": [ { "image": [ "https://files.readme.io/l9XsF7hScyX5QGA9uGqF_Screen%20Shot%202015-10-02%20at%2012.08.04%20PM.png", "Screen Shot 2015-10-02 at 12.08.04 PM.png", "434", "436", "#c2373b", "" ], "caption": "The two coordinates used in the above example of a successful `On Highway` detection. The red coordinate is the user's previous location, and the green is their current location. They are, in fact, traveling on I-65 Northbound." } ] } [/block] As you can see, this user is traveling on I-65 Northbound near Birmingham, Alabama. And if you enter these two coordinates into this API, you will see that it returns a `status` of "On Highway" along with an [Exit](doc:exit) object in the `starting_exit` field to use with the [Upcoming Exits API](doc:upcoming-exits). Now consider the example below. The red previous location (`<33.511273, -86.820006>`) and the green current location (`<33.510638, -86.821334>`) show that the user is not on the highway. Despite these location's proximity to I-65, they are traveling perpendicular to the highway, which the API is smart enough to detect. So because this user is not on the highway, we will not return a Status:100 response. But since they are near several highway (I-65, I-20, and I-59), we will return a Status:200 (Near Highway) response with 6 exits in the `exits` array. These 6 exits are made up of 1) I-65 N, 2) I-65 S, 3) I-20 E, 4) I-20 W, 5) I-59 N, and 6) I-59 S. [block:image] { "images": [ { "image": [ "https://files.readme.io/hUyTvsl5QmeeOOnobQxf_Screen%20Shot%202015-10-02%20at%2012.13.01%20PM.png", "Screen Shot 2015-10-02 at 12.13.01 PM.png", "518", "492", "#b24445", "" ], "caption": "These two coordinates would result in this API returning `Not On Highway`. Even though they are near I-65, their direction of travel prevents them from being placed on I-65." } ] } [/block] In the iExit Android app, when a user selects "Fine Me On The Highway", the first step is to make a background HTTP request to this API. If it returns with a Status:100 (On Highway) response, then we know the user is on the highway and then we can use the `exit`.`id` value as input to the [Upcoming Exits API](doc:upcoming-exits). [block:image] { "images": [ { "image": [ "https://files.readme.io/5UmHNvuvRnKHQ8XxcdhS_FindingOnHighway.png", "FindingOnHighway.png", "720", "1280", "#1f4636", "" ], "caption": "This is the overlay shown in the iExit Android app when it's requesting this API to determine if the user is on the highway." } ] } [/block] ** Common Next API(s) ** - [Upcoming Exits](doc:upcoming-exits) (by using `starting_exit`.`id` if `status` == "On Highway".

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}