Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit 2b6a801
Showing
279 changed files
with
48,277 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,5 @@ | ||
| Route4MeSDK.sln | ||
| Route4MeSDKTest/Route4MeSDKTest.csproj | ||
| *.userprefs | ||
| /**/obj/ | ||
| /packages/ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,4 @@ | ||
| <?xml version="1.0" encoding="utf-8"?> | ||
| <packages> | ||
| <package id="NUnit.ConsoleRunner" version="3.6.0" /> | ||
| </packages> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,26 @@ | ||
| # ============================================================================= | ||
| # Access Route4Me's logistics-as-a-service API using our C# SDK | ||
| # | ||
| # Copyright (C) 2016-2017 Route4Me | ||
| # | ||
| # ============================================================================= | ||
|
|
||
| sudo: false | ||
| language: csharp | ||
| solution: Route4MeSDK.sln | ||
|
|
||
| mono: | ||
| - latest | ||
| - 3.8.0 | ||
| # - 2.10.8 # fails: https://travis-ci.org/maxkoryukov/route4me-csharp-sdk/jobs/194265821 | ||
|
|
||
| # dotnet: | ||
| # - 1.0.0-preview2-003121 | ||
|
|
||
| cache: | ||
| directories: | ||
| - packages | ||
|
|
||
| script: | ||
| - xbuild /p:Configuration=Release Route4MeSDK.sln | ||
| - mono ./packages/NUnit.ConsoleRunner.3.6.0/tools/nunit3-console.exe ./Route4MeSDKTest/bin/Debug/Route4MeSDKTest.exe |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,223 @@ | ||
| # Route4Me Route Optimization SaaS C# SDK | ||
|
|
||
| [](https://travis-ci.org/route4me/route4me-csharp-sdk) | ||
| [](https://ci.appveyor.com/project/novapulsar/route4me-csharp-sdk) | ||
|
|
||
|
|
||
| ### What does the Route4Me SDK permit me to do? | ||
| This SDK makes it easier for you use the Route4Me API, which creates optimally sequenced driving routes for many drivers. | ||
|
|
||
| ### Who can use the Route4Me SDK (and API)? | ||
| The service is typically used by organizations who must route many drivers to many destinations. In addition to route optimization for new (future) routes, the API can also be used to analyze historical routes, and to distribute routes to field personnel. | ||
|
|
||
| ### Who is prohibited from using the Route4Me SDK (and API)? | ||
| The Route4Me SDK and API cannot be resold or used in a product or system that competes directly with Route4Me. This means that developers cannot resell route optimization services to other businesses or developers. However, developers can integrate our route optimization SDK/API into their software applications. Developers and startups are also permitted to use our software for internal purposes (i.e. a same day delivery startup). | ||
|
|
||
|
|
||
| ### How does the API/SDK Integration Work? | ||
| A Route4Me customer, integrator, or partner incorporates the Route4Me SDK or API into their code base. | ||
| Route4Me permits any paying subscriber to interact with every part of its system using it’s API. | ||
| The API is RESTful, which means that it’s web based and can be accessed by other programs and machines | ||
| The API/SDK should be used to automate the route planning process, or to generate many routes with minimal manual intervention | ||
|
|
||
|
|
||
|
|
||
| ### Do optimized routes automatically appear inside my Route4Me account? | ||
| Every Route4Me SDK instance needs a unique API key. The API key can be retrieved inside your Route4Me.com account, inside the Settings tab called API. When a route is planned, it appears inside the corresponding Route4Me account. Because Route4Me web and mobile accounts are synchronized, the routes will appear in both environments at the same time. | ||
|
|
||
| ### Can I test the SDK with other addresses without a valid API Key? | ||
| No. The sample API key only permits you to optimize routes with the sample address coordinates that are part of this SDK. | ||
|
|
||
| ### Does the SDK have rate limits? | ||
| The number of requests you can make per second is limited by your current subscription plan. Typically, there are different rate limits for these core features: | ||
| Address Geocoding & Address Reverse Geocoding | ||
| Route Optimization & Management | ||
| Viewing a Route | ||
|
|
||
| ### What is the recommended architecture for the Route4Me SDK? | ||
| There are two typical integration strategies that we recommend. Using this SDK, you can make optimization requests and then the SDK polls the Route4Me API to detect state changes as the optimization progresses. Alternatively, you can provide a webhook/callback url, and the API will notify that callback URL every time there is a state change. | ||
|
|
||
| ### I don't need route management or mobile capabilities. Is there a lower level Route4Me API just for the optimization engine? | ||
| Yes. Please contact support@route4me.com to learn about the low-level RESTful API. | ||
|
|
||
| ### How fast is the route Route4Me Optimization Web Service? | ||
| Most routes having less than 200 destinations are optimized in 1 second or less. | ||
|
|
||
| ### Can I disable optimization when planning routes? | ||
| Yes. You can send routes with optimization disabled if you want to conveniently see them on a map, or distribute them to your drivers in the order you prefer. | ||
|
|
||
| ### Can the API be used for aerial vehicles such as drones or self-driving cars? | ||
| Yes. The API can accept lat/lng and an unlimited amount of per-address metadata. The metadata will be preserved as passthrough data by our API, so that the receiving device will have access to critical data when our API invokes a webhook callback to the device. | ||
|
|
||
| ### Are all my optimized routes stored permanently stored in the Route4Me database? | ||
| Yes. All routes are permanently stored in the database and are no longer accessible to you after your subscription is terminated. | ||
|
|
||
|
|
||
| ### Can I incorporate your API into my mobile application? | ||
| Route4Me’s route planning and optimization technology can only be added into applications that do not directly compete with Route4Me. | ||
| This means the application’s primary capabilities must be unrelated to route optimization, route planning, or navigation. | ||
|
|
||
| ### Can I pay you to develop a custom algorithm? | ||
| Yes | ||
|
|
||
| ### Can I use your API and resell it to my customers? | ||
| White-labeling and private-labeling Route4Me is possible but the deal’s licensing terms vary considerably based on customer count, route count, and the level of support that Route4Me should provide to your customers. | ||
|
|
||
| ### Does the API/SDK have TMS or EDI, or EDI translator capabilities? | ||
| Route4Me is currently working on these features but they are not currently available for sale. | ||
|
|
||
| ### Can the API/SDK send notifications back to our system using callbacks, notifications, pushes, or webhooks? | ||
|
|
||
| Because Route4Me processes all routes asynchronously, Route4Me will conveniently notify the endpoint you specify as the route optimization job progresses through each state of the optimization. Every stage of the route optimization process has a unique stage id. | ||
|
|
||
| ### Does the Route4Me API and SDK work in my country? | ||
| Route4Me.com, as well as all of Route4Me’s mobile applications use the Route4Me SDK’s and API. | ||
| Since Route4Me works globally, this means that all of Route4Me’s capabilities are available using the SDK’s in every country | ||
|
|
||
|
|
||
| ### Will the Route4Me API/SDK work in my program on the Mac, PC, or Linux? | ||
| Customers are encouraged to select their preferred operating system environment. The Route4Me API/SDK will function on any operating system that supports the preferred programming language of the customer. At this point in time, almost every supported SDK can run on any operating system. | ||
|
|
||
|
|
||
| ### Does the Route4Me API/SDK require me to buy my own servers? | ||
| Route4Me has its own computing infrastructure that you can access using the API and SDKs. Customers typically have to run the SDK code on their own computers and/or servers to access this infrastructure. | ||
|
|
||
| ### Does Route4Me have an on-premise solution? | ||
| Route4Me does not currently lease or sell servers, and does not have on-premise appliance solution. This would only be possible in exceptionally unique scenarios. | ||
|
|
||
|
|
||
| ### Does the Route4Me API/SDK require me to have my own programmers? | ||
| The time required to integrate the SDK can be as little as 1 hour or may take several weeks, depending on the number of features being incorporated into the customer’s application and how much integration testing will be done by the client. A programmer’s involvement is almost always required to use Route4Me’s technology when accessing it through the API. | ||
|
|
||
|
|
||
|
|
||
| ### Installation and Usage | ||
|
|
||
| 1. Add reference to Route4MeSDKLibrary.dll | ||
| 2. Use the class Route4MeSDK.Route4MeManager for accessing the Route4ME API | ||
| 3. Use methods Route4MeManager.GetRoute(), Route4MeManager.UpdateOptimization() etc. to access the main functionality of Route4Me API. | ||
| 4. Use generic methods Route4MeManager.GetStringResponseFromAPI() and Route4MeManager.GetJsonObjectFromAPI<T>() for accessing any Route4Me API functionally via custom defined classes (see example in Route4MeSDKTest.SingleDriverRoundTripGeneric.cs) | ||
|
|
||
| ### Examples and Tests | ||
|
|
||
| 1. See project Route4MeSDKTest (class Route4MeSDKTest.Examples) for some examples of using Route4MeSDKLibrary | ||
| 2. See an example of creating a simple route below | ||
|
|
||
| ### Creating a Simple Route | ||
|
|
||
| ``` C# | ||
| using Route4MeSDK.DataTypes; | ||
| using Route4MeSDK.QueryTypes; | ||
|
|
||
| namespace Route4MeSDK.Examples | ||
| { | ||
| public sealed partial class Route4MeExamples | ||
| { | ||
| public void SingleDriverRoundTrip() | ||
| { | ||
| // Create the manager with the api key | ||
| Route4MeManager route4Me = new Route4MeManager(c_ApiKey); | ||
|
|
||
| // Prepare the addresses | ||
| Address[] addresses = new Address[] | ||
| { | ||
| #region Addresses | ||
|
|
||
| new Address() { AddressString = "754 5th Ave New York, NY 10019", | ||
| Alias = "Bergdorf Goodman", | ||
| //designate the point of origination in the route | ||
| //single driver routes should have one point of origin (single depot) | ||
| //multiple depot routes can have multiple addresses marked as depots | ||
| //and the optimization algorithm will determine the optimal departure depot | ||
| //for each generated route | ||
| IsDepot = true, | ||
| Latitude = 40.7636197, //all addresses must be properly geocoded | ||
| Longitude = -73.9744388, //all addresses must be properly geocoded | ||
| Time = 0 }, | ||
|
|
||
| new Address() { AddressString = "717 5th Ave New York, NY 10022", | ||
| Alias = "Giorgio Armani", | ||
| Latitude = 40.7669692, //all addresses must be properly geocoded | ||
| Longitude = -73.9693864, //all addresses must be properly geocoded | ||
| Time = 0 }, | ||
|
|
||
| new Address() { AddressString = "888 Madison Ave New York, NY 10014", | ||
| Alias = "Ralph Lauren Women's and Home", | ||
| Latitude = 40.7715154, //all addresses must be properly geocoded | ||
| Longitude = -73.9669241, //all addresses must be properly geocoded | ||
| Time = 0 }, | ||
|
|
||
| new Address() { AddressString = "1011 Madison Ave New York, NY 10075", | ||
| Alias = "Yigal Azrou'l", | ||
| Latitude = 40.7772129, //all addresses must be properly geocoded | ||
| Longitude = -73.9669, //all addresses must be properly geocoded | ||
| Time = 0 }, | ||
|
|
||
| new Address() { AddressString = "440 Columbus Ave New York, NY 10024", | ||
| Alias = "Frank Stella Clothier", | ||
| Latitude = 40.7808364, //all addresses must be properly geocoded | ||
| Longitude = -73.9732729,//all addresses must be properly geocoded | ||
| Time = 0 }, | ||
|
|
||
| new Address() { AddressString = "324 Columbus Ave #1 New York, NY 10023", | ||
| Alias = "Liana", | ||
| Latitude = 40.7803123,//all addresses must be properly geocoded | ||
| Longitude = -73.9793079,//all addresses must be properly geocoded | ||
| Time = 0 }, | ||
|
|
||
| new Address() { AddressString = "110 W End Ave New York, NY 10023", | ||
| Alias = "Toga Bike Shop", | ||
| Latitude = 40.7753077,//all addresses must be properly geocoded | ||
| Longitude = -73.9861529,//all addresses must be properly geocoded | ||
| Time = 0 }, | ||
|
|
||
| new Address() { AddressString = "555 W 57th St New York, NY 10019", | ||
| Alias = "BMW of Manhattan", | ||
| Latitude = 40.7718005,//all addresses must be properly geocoded | ||
| Longitude = -73.9897716,//all addresses must be properly geocoded | ||
| Time = 0 }, | ||
|
|
||
| new Address() { AddressString = "57 W 57th St New York, NY 10019", | ||
| Alias = "Verizon Wireless", | ||
| Latitude = 40.7558695,//all addresses must be properly geocoded | ||
| Longitude = -73.9862019,//all addresses must be properly geocoded | ||
| Time = 0 }, | ||
|
|
||
| #endregion | ||
| }; | ||
|
|
||
| // Set parameters | ||
| RouteParameters parameters = new RouteParameters() | ||
| { | ||
| AlgorithmType = AlgorithmType.TSP, | ||
| StoreRoute = false, | ||
| RouteName = "Single Driver Round Trip", | ||
|
|
||
| RouteTime = 0, | ||
| RouteMaxDuration = 86400, | ||
| VehicleCapacity = "1", | ||
| VehicleMaxDistanceMI = "10000", | ||
|
|
||
| Optimize = Optimize.Distance.Description(), | ||
| DistanceUnit = DistanceUnit.MI.Description(), | ||
| DeviceType = DeviceType.Web.Description(), | ||
| TravelMode = TravelMode.Driving.Description(), | ||
| }; | ||
|
|
||
| OptimizatonParameters optimizatonParameters = new OptimizatonParameters() | ||
| { | ||
| Addresses = addresses, | ||
| Parameters = parameters | ||
| }; | ||
|
|
||
| // Run the query | ||
| string errorString; | ||
| DataObject dataObject = route4Me.RunOptimization(optimizatonParameters, out errorString); | ||
|
|
||
| // Output the result | ||
| PrintExampleOptimizationResult("SingleDriverRoundTrip", dataObject, errorString); | ||
| } | ||
| } | ||
| } | ||
|
|
||
| ``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,31 @@ | ||
|
|
||
| Microsoft Visual Studio Solution File, Format Version 12.00 | ||
| # Visual Studio 2012 | ||
| Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Route4MeSDKLibrary", "Route4MeSDKLibrary\Route4MeSDKLibrary.csproj", "{37E5D3FC-BBF7-4BD8-98E6-A58DC9138D98}" | ||
| EndProject | ||
| Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Route4MeSDKTest", "Route4MeSDKTest\Route4MeSDKTest.csproj", "{DBA0AA41-4223-4404-B3E6-4948FE147A40}" | ||
| EndProject | ||
| Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = ".nuget", ".nuget", "{8BA18B34-5258-42D7-BCAE-6EEB86520598}" | ||
| ProjectSection(SolutionItems) = preProject | ||
| .nuget\packages.config = .nuget\packages.config | ||
| EndProjectSection | ||
| EndProject | ||
| Global | ||
| GlobalSection(SolutionConfigurationPlatforms) = preSolution | ||
| Debug|Any CPU = Debug|Any CPU | ||
| Release|Any CPU = Release|Any CPU | ||
| EndGlobalSection | ||
| GlobalSection(ProjectConfigurationPlatforms) = postSolution | ||
| {37E5D3FC-BBF7-4BD8-98E6-A58DC9138D98}.Debug|Any CPU.ActiveCfg = Debug|Any CPU | ||
| {37E5D3FC-BBF7-4BD8-98E6-A58DC9138D98}.Debug|Any CPU.Build.0 = Debug|Any CPU | ||
| {37E5D3FC-BBF7-4BD8-98E6-A58DC9138D98}.Release|Any CPU.ActiveCfg = Release|Any CPU | ||
| {37E5D3FC-BBF7-4BD8-98E6-A58DC9138D98}.Release|Any CPU.Build.0 = Release|Any CPU | ||
| {DBA0AA41-4223-4404-B3E6-4948FE147A40}.Debug|Any CPU.ActiveCfg = Debug|Any CPU | ||
| {DBA0AA41-4223-4404-B3E6-4948FE147A40}.Debug|Any CPU.Build.0 = Debug|Any CPU | ||
| {DBA0AA41-4223-4404-B3E6-4948FE147A40}.Release|Any CPU.ActiveCfg = Release|Any CPU | ||
| {DBA0AA41-4223-4404-B3E6-4948FE147A40}.Release|Any CPU.Build.0 = Release|Any CPU | ||
| EndGlobalSection | ||
| GlobalSection(SolutionProperties) = preSolution | ||
| HideSolutionNode = FALSE | ||
| EndGlobalSection | ||
| EndGlobal |
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,53 @@ | ||
| | ||
| namespace Route4MeSDK | ||
| { | ||
| /// <summary> | ||
| /// Route4Me infrastructure settings | ||
| /// Api version 4 hosts constants | ||
| /// </summary> | ||
| public static class R4MEInfrastructureSettings | ||
| { | ||
| #region Api V4 | ||
|
|
||
| public const string ApiVersion = "4"; | ||
|
|
||
| public const string MainHost = "https://www.route4me.com"; | ||
| public const string ApiHost = MainHost + "/api.v4/optimization_problem.php"; | ||
| public const string ShowRouteHost = MainHost + "/route4me.php"; | ||
| public const string RouteHost = MainHost + "/api.v4/route.php"; | ||
| public const string SetGpsHost = MainHost + "/track/set.php"; | ||
| public const string GetUsersHost = MainHost + "/api.v4/user.php"; | ||
| public const string UserAuthentication = MainHost + "/actions/authenticate.php"; | ||
| public const string ValidateSession = MainHost + "/datafeed/session/validate_session.php"; | ||
| public const string UserRegistration = MainHost + "/actions/register_action.php"; | ||
| public const string UserConfiguration = MainHost + "/api.v4/configuration-settings.php"; | ||
| public const string AddRouteNotesHost = MainHost + "/actions/addRouteNotes.php"; | ||
| public const string ActivityFeedHost = MainHost + "/api.v4/activity_feed.php"; | ||
| public const string GetAddress = MainHost + "/api.v4/address.php"; | ||
| public const string DuplicateRoute = MainHost + "/actions/duplicate_route.php"; | ||
| public const string MoveRouteDestination = MainHost + "/actions/route/move_route_destination.php"; | ||
| public const string AddressBook = MainHost + "/api.v4/address_book.php"; | ||
| public const string Avoidance = MainHost + "/api.v4/avoidance.php"; | ||
| public const string Territory = MainHost + "/api.v4/territory.php"; | ||
| public const string Order = MainHost + "/api.v4/order.php"; | ||
| public const string MergeRoutes = MainHost + "/actions/merge_routes.php"; | ||
| public const string RouteReoptimize = MainHost + "/api.v3/route/reoptimize_2.php"; | ||
| public const string RouteSharing = MainHost + "/actions/route/share_route.php"; | ||
|
|
||
| public const string MarkAddressDeparted = MainHost + "/api/route/mark_address_departed.php"; | ||
| public const string MarkAddressVisited = MainHost + "/actions/address/update_address_visited.php"; | ||
|
|
||
| public const string Geocoder = MainHost + "/api/geocoder.php"; | ||
| public const string RapidStreetData = "https://rapid.route4me.com/street_data"; | ||
| public const string RapidStreetZipcode = "https://rapid.route4me.com/street_data/zipcode"; | ||
| public const string RapidStreetService = "https://rapid.route4me.com/street_data/service"; | ||
|
|
||
| //public const string AssetTracking = MainHost + "/api/asset/find_route.php"; | ||
| public const string AssetTracking = MainHost + "/api.v4/status.php"; | ||
| public const string ViewVehicles = MainHost + "/api/vehicles/view_vehicles.php"; | ||
|
|
||
| public const string HybridOptimization = MainHost + "/api.v4/hybrid_date_optimization.php"; | ||
|
|
||
| #endregion | ||
| } | ||
| } |
Oops, something went wrong.