Geoptimization API
Total Page:16
File Type:pdf, Size:1020Kb
Geoptimization API GEOCONCEPT SAS Copyright © 2020 Geoconcept This manual is Geoconcept property 1 Geoptimization API Introduction ...................................................................................................................................... 3 What new features are available? ............................................................................................. 4 Geoptimization JavaScript API .......................................................................................................... 6 Load the JavaScript API ........................................................................................................... 6 Specify your credentials ............................................................................................................ 6 Map ......................................................................................................................................... 6 Map Control ........................................................................................................................... 10 Map Overlay ........................................................................................................................... 12 Map Mode .............................................................................................................................. 21 Layer ...................................................................................................................................... 24 Geolocation ............................................................................................................................ 44 Geocoding .............................................................................................................................. 61 Routing .................................................................................................................................. 64 Event ..................................................................................................................................... 67 Projection ............................................................................................................................... 74 Geoptimization REST API ............................................................................................................... 75 WMTS .................................................................................................................................... 76 Layer informations .................................................................................................................. 77 Coordinates transformation ..................................................................................................... 79 Autocompletion ....................................................................................................................... 81 Geocoding .............................................................................................................................. 84 Geocoding (batch) .................................................................................................................. 90 Address abbreviation .............................................................................................................. 96 Reverse geocoding ................................................................................................................. 99 Find an object ...................................................................................................................... 103 Territory management ........................................................................................................... 110 Route calculation .................................................................................................................. 110 Route calculation (batch) ...................................................................................................... 120 Estimated Time of Arrival (ETA) ............................................................................................ 122 Waypoint sequence .............................................................................................................. 124 Isochrones/Isodistances ........................................................................................................ 130 Matrix calculation .................................................................................................................. 135 Compact matrix calculation ................................................................................................... 142 Search Around ..................................................................................................................... 148 Search Along ........................................................................................................................ 155 Pickup and delivery .............................................................................................................. 161 TourSolver Cloud API ........................................................................................................... 172 Version : FALL-20-4 Date : 12/31/20 2 Introduction Introduction Geoconcept Geoptimization JavaScript API and Geoptimization web services are aimed at developers and integrators, providing a JavaScript library and a complete series of hosted web services that are easily integrated so the geographic dimension can be rapidly added to your applications. Example • Search demonstrator [https://en.geoconcept.com/geocoding-demonstrator] showing search web services (autocomplete, geocoding, address standardization) and WMTS map tiling. • Routing demonstrator [https://en.geoconcept.com/route-api-demonstrator] showing routing (including prohibited transit zones), reverse geocoding web services and WMTS map tiling. How can I get started? To use our Geoptimization JavaScript API and Geoptimization web services, simply fill in this form [https://en.geoconcept.com/test-geoptimization-api] and you will receive an email with login identifiers valid for 30 days. You will be able to trial both documentation and components to integrate within your applications. It goes without saying, during the trial period you will be able to use our services – as described in the documentation - free of charge, without any obligation to provide us with information on your side. Which coverage? Coverage may vary depending on the web service, but most are available on any chosen continental server (see below) for the following geographic area: 3 Geoptimization API To request a specific continental server, replace the XX string, inside the url, with the chosen continent: https://api.geoconcept.com/XX/GCW/geoconcept-web/api/lbs/ What new features are available? In the Fall 2020 release • Upgrade full data release version 2020 • One new map layer: Charging stations for electric vehicles (France) • Add exclusions for Hazardous material to all routing services (Route calculation, Route calculation (batch), Waypoint sequence, Isochrones, Matrix calculation, Search around, Search along, Pickup and delivery) • Features added on the followings services: • Add formatItems and fields the Route calculation service (v6) • Improved formated results for Waypoint sequence (v4) and Compact matrix calculation (v4) In the Spring 2020 release • Add Estimated Time of Arrival (ETA) service to provide time to arrive to destination accounting real-time traffic • Add batch Route calculation service to calculates a set of itineraries in one request • Add Geoconcept Territory Manager API, this API allow to segment a territory or optimize existing ones • Features added on others services: • Addresses coordinates for reverse geocoding (v3) • Add 2 news formats completegeometry and compresscompletegeometry to provide legs geometries on the Route calculation service In the Winter 2020 release • The autocompletion offers global coverage and additional settings to allow geographic filtering • Add the capability to compute toll cost on route calculation varying according to the time of passage and the type of vehicle • Add sections on the Geoconcept JavaScript API: • grey scale and night mode, • heat map layer, • search around, • tracking animation. In the Summer 2019 release • The access url has changed to: https://api.geoconcept.com/. The previous one is kept for compatibility. • Add news parameters on the optimization service. • Add sections on the Geoconcept JavaScript API: 4 What new features are available? • customized icons for points, • external Popover, • using HERE maps layer, • add a GeoJSON, • locate yourself. In the Spring 2019 release? • Complete update of the Geoconcept JavaScript API, based over the OpenLayers JavaScript library release 4.6.4. • Add the pickup and delivery service can be used to list the best solutions for pickup/collection and drop- off/delivery, whether for the transport of people or of goods. In the Autumn 2018 release? Of the most significant new features, we will cite the following: • data has been fully updated, and provides even more exhaustive coverage • there is now an option for advanced specification of route calculations and route matrices: • refined speeds can now take traffic conditions into account • traffic restrictions for heavy goods vehicles (Truck Attributes) • new vehicle profiles (bicycle, bus, emergency truck, emergency vehicle, taxi, …) 5 Geoptimization API Geoptimization JavaScript API The Geoconcept JavaScript API lets you embed maps