Geoptimization API

Total Page:16

File Type:pdf, Size:1020Kb

Geoptimization API 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
Recommended publications
  • Fortran Programming Guide
    Sun Studio 12: Fortran Programming Guide Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054 U.S.A. Part No: 819–5262 Copyright 2007 Sun Microsystems, Inc. 4150 Network Circle, Santa Clara, CA 95054 U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more U.S. patents or pending patent applications in the U.S. and in other countries. U.S. Government Rights – Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements. This distribution may include materials developed by third parties. Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd. Sun, Sun Microsystems, the Sun logo, the Solaris logo, the Java Coffee Cup logo, docs.sun.com, Java, and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. The OPEN LOOK and SunTM Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry.
    [Show full text]
  • Creating Telephony Applications for Both Windows® and Linux
    Application Note Dialogic Research, Inc. Dual OS Applications Creating Telephony Applications for Both Windows® and Linux: Principles and Practice Application Note Creating Telephony Applications for Both Windows® and Linux: Principles and Practice Executive Summary To help architects and programmers who only have experience in a Windows® environment move their telephony applications to Linux, this application note provides information that aims to make the transition easier. At the same time, it takes into account that the original code for Windows may not be abandoned. The ultimate goal is to demonstrate how to create flexible OS-agnostic telephony applications that are easy to build, deploy, and maintain in either environment. Creating Telephony Applications for Both Windows® and Linux: Principles and Practice Application Note Table of Contents Introduction .......................................................................................................... 2 Moving to a Dual Operating System Environment ................................................. 2 CMAKE ......................................................................................................... 2 Boost Jam .................................................................................................... 2 Eclipse .......................................................................................................... 3 Visual SlickEdit ............................................................................................. 3 Using Open Source Portable
    [Show full text]
  • R in a Nutshell
    R IN A NUTSHELL Second Edition Joseph Adler Beijing • Cambridge • Farnham • Köln • Sebastopol • Tokyo R in a Nutshell, Second Edition by Joseph Adler Copyright © 2012 Joseph Adler. All rights reserved. Printed in the United States of America. Published by O’Reilly Media, Inc., 1005 Gravenstein Highway North, Sebastopol, CA 95472. O’Reilly books may be purchased for educational, business, or sales promotional use. Online editions are also available for most titles (http://my.safaribooksonline.com). For more infor- mation, contact our corporate/institutional sales department: 800-998-9938 or [email protected]. Editors: Mike Loukides and Meghan Blanchette Indexer: Fred Brown Production Editor: Holly Bauer Cover Designer: Karen Montgomery Proofreader: Julie Van Keuren Interior Designer: David Futato Illustrators: Robert Romano and Re- becca Demarest September 2009: First Edition. October 2012: Second Edition. Revision History for the Second Edition: 2012-09-25 First release See http://oreilly.com/catalog/errata.csp?isbn=9781449312084 for release details. Nutshell Handbook, the Nutshell Handbook logo, and the O’Reilly logo are registered trade- marks of O’Reilly Media, Inc. R in a Nutshell, the image of a harpy eagle, and related trade dress are trademarks of O’Reilly Media, Inc. Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this book, and O’Reilly Media, Inc., was aware of a trademark claim, the designations have been printed in caps or initial caps. While every precaution has been taken in the preparation of this book, the publisher and author assume no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.
    [Show full text]
  • An Introduction to R Notes on R: a Programming Environment for Data Analysis and Graphics Version 4.1.1 (2021-08-10)
    An Introduction to R Notes on R: A Programming Environment for Data Analysis and Graphics Version 4.1.1 (2021-08-10) W. N. Venables, D. M. Smith and the R Core Team This manual is for R, version 4.1.1 (2021-08-10). Copyright c 1990 W. N. Venables Copyright c 1992 W. N. Venables & D. M. Smith Copyright c 1997 R. Gentleman & R. Ihaka Copyright c 1997, 1998 M. Maechler Copyright c 1999{2021 R Core Team Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one. Permission is granted to copy and distribute translations of this manual into an- other language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the R Core Team. i Table of Contents Preface :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 1 1 Introduction and preliminaries :::::::::::::::::::::::::::::::: 2 1.1 The R environment :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 2 1.2 Related software and documentation ::::::::::::::::::::::::::::::::::::::::::::::: 2 1.3 R and statistics :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 2 1.4 R and the window system ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
    [Show full text]
  • Practical Perl Tools: Date: January 9, 2008 2:10:14 PM EST Subject: Re: [SAGE] Crontabs Vs /Etc/ Back in Timeline Cron.[Daily,Hourly,*] Vs /Etc/Cron.D
    yo u k n o W, I Wa s j u s t m I n d I n g my own business, reading my email and stuff, d Av I d n . B l A n K- e d e l MA n when the following message from the SAGE mailing list came on my screen (slightly ex- cerpted but reprinted with permission): From: [email protected] practical Perl tools: Date: January 9, 2008 2:10:14 PM EST Subject: Re: [SAGE] crontabs vs /etc/ back in timeline cron.[daily,hourly,*] vs /etc/cron.d/ David N. Blank-Edelman is the Director of Technology On a more specific aspect of this (without at the Northeastern University College of Computer regard to best practice), does anyone know and Information Science and the author of the O’Reilly book Perl for System Administration. He has spent the of a tool that converts crontabs into Gantt past 22+ years as a system/network administrator in charts? I’ve always wanted to visualize how large multiplatform environments, including Brandeis University, Cambridge Technology Group, and the MIT the crontab jobs (on a set of machines) line Media Laboratory. He was the program chair of the up in time. Each entry would need to be LISA ’05 conference and one of the LISA ’06 Invited Talks co-chairs. supplemented with an estimate of the dura- [email protected]@ccs.neu.edu tion of the job (3 minutes vs 3 hours). JM I just love sysadmin-related visualization ideas. This also seemed like a fun project with some good discrete parts well-suited to a column.
    [Show full text]
  • Warning: Discarded Datum Unknown:” What Does It Mean?
    1 “Warning: Discarded datum Unknown:” What Does it Mean? Richard E. Plant February 21, 2021 Additional topic to accompany Spatial Data Analysis in Ecology and Agriculture using R, Second Edition http://psfaculty.plantsciences.ucdavis.edu/plant/sda2.htm Chapter and section references are contained in that text, which is referred to as SDA2. 1. Introduction The reason that I felt the need to write this Additional Topic is shown in the following code sequence, taken from SDA2 Section 1.3. The objective is to create the image shown in Fig. 1, which is Fig. 1.5 in SDA2.The code is from the file 1.3.1.r on the SDA2 website. Figure 1. Reproduction of Figure 1.5 in SDA2. 2 The first step is to read the shapefile containing the data. > library(rgdal) > library(sf) > data.Set1.sf <- st_read("set1\\landcover.shp") Reading layer `landcover' from data source `C:\Data\Set1\landcover.shp' using driver `ESRI Shapefile' Simple feature collection with 1811 features and 6 fields geometry type: POLYGON dimension: XY bbox: xmin: 576446.9 ymin: 4396700 xmax: 589578.4 ymax: 4420790 CRS: NA Both of the library() function calls generate output that we will skip over for now but come back to in a moment. After reading it, we convert the sf object data.Set1.sf to an sp object and assign a projection. Here something unexpected happens. > data.Set1.cover <- as(data.Set1.sf, "Spatial") > proj4string(data.Set1.cover) <- CRS("+proj=utm +zone=10 +ellps=WGS84") Warning message: In showSRID(uprojargs, format = "PROJ", multiline = "NO") : Discarded datum Unknown based on WGS84 ellipsoid in CRS definition SDA2 was written using R version 3.4.3, and there was no warning message.
    [Show full text]
  • PROJ – Usage of Transformations in Switzerland (Swisstopo)
    Federal Office of Topography swisstopo PROJ – usage of transformations in Switzerland (swisstopo) E. Brockmann (Geodesy), M. Clausen (Web/GIS) Swiss Reference Frames • Old System LV03 (Triangulation based) • New System LV95 (GNSS based) • y,x • E,N • origin y0= 600’000, x0=200’000 • origin E0= 2’600’000, N0=1’200’000 Usage of PROJ at swisstopo, EUREF19, E. Brockmann et al 2 swisstopo LV95-LV03 Differences (FINELTRA; horizontally) 1995 1903 A) FINELTRA: Finite Element Transformation (identical forward and backward) B) 1x1 km grid available (forward and backward < 1cm) Data set name: New is official CHENyx06 system from 2017 onwards for federal law geobasisdata country LV95 LV03 pub. E,N y,x year 2006 New is official system from 2020 onwards for ALL geobasisdata ±1.5 m differences • 10 - 30 cm accuracy transformation available since 1995 • 2 - 3 cm accuracy transformation available beginning 2007 Usage of PROJ at swisstopo, EUREF19, E. Brockmann et al 28.05.2019 3 swisstopo Web Tools for coordinate transformations REFREAME: CH – UTM – ETRS NAVREF: CH – WGS84 - horizontal - vertical (levelled / ellipsoidal) https://www.swisstopo.admin.ch/en/maps-data-online/calculation-services/reframe.html https://www.swisstopo.admin.ch/en/maps-data-online/calculation-services/navref.html Usage of PROJ at swisstopo, EUREF19, E. Brockmann et al 4 swisstopo https://www.swisstopo.admin.ch/en/maps-data-online/calculation-services/m2m.html Other methods • Web API (REST service) call: geodesy.geo.admin.ch/reframe/wgs84tolv95?easting=7.43863&northing=46.95108&altitude=550.0 return: {"easting": "2599999.81004", "northing": "1199999.68019", "altitude": "500.37779"} JSON ¦¦ GeoJSON - also available 2D: heights-only • REFRAME library for own .NET or C++ applications (e.g.
    [Show full text]
  • Cookbook 1: How to Serve a Onegeology Level 1 Conformant
    How to serve a OneGeology level 1 conformant Web Map Service (WMS) - Cookbook 1 PDF version of this OneGeology WMS cookbook Summary of changes since last major update March 2016 February 2016 December 2015 November 2015 October 2015 September 2014 August 2013 June 2013 Table of contents 1. Registering your WMS service with the OneGeology Portal registry 1. Background 2. Who should be using this guidance? 3. What type of data should be served as a contribution to OneGeology Level 1? 2. WMS Profile 1. WMS service name 2. WMS service title 1. WMS root layer name 3. WMS service URL 4. WMS service-level metadata 1. Required service-level metadata 2. Recommended service-level metadata 5. Layer metadata 1. Geographic extent 2. Data owner 3. Language 4. Scale 5. Theme 6. Layer title examples 7. Layer name examples 6. Other layer metadata (e.g. keywords) 1. Layer styling information 7. Core TC211/ISO:19115:2003 Metadata 8. GetFeatureInfo response 3. Scanning a paper map 1. Scanning 2. Georeferencing a scanned map 3. Image formats and transparency 4. The legend for the scanned map 4. Setting up a MapServer WMS 1. Prerequisites for setting up a WMS 2. MS4W software installation 1. Using the MS4W zip (or full exemplar zip) 2. Using the MS4W NSIS installer 3. Updating an existing MS4W installation 4. If you already have an Apache installation 3. Configuring your MapServer WMS 1. Step-by-step configuration for MS4W 1. Installing the exemplar services into an existing MS4W installation 1 | Generated from www.onegeology.org/wmscookbook on 22 Jun 2016 How to serve a OneGeology level 1 conformant Web Map Service (WMS) - Cookbook 1 PDF version of this OneGeology WMS cookbook Summary of changes since last major update March 2016 February 2016 December 2015 November 2015 October 2015 September 2014 August 2013 June 2013 Table of contents 1.
    [Show full text]
  • Build Systems Przemek (Pshemek) Lach Seng 371 Source
    Build Systems Przemek (Pshemek) Lach SEng 371 Source ● Slides are based on content from book. ● Examples and diagrams also used from book. ● Software build systems; principles and experience. (2011). Reference and Research Book News, 26(3) Motivation Why Build? ● Anytime you want to do more than compile half a dozen files. ● Simplifies software development and testing. ● You want to make a change to your code and hit 'play' which will compile all your code, run all your tests, and maybe even automatically generate documentation and deploy your application. What Can You Build? ● Compilation of software from source to executable. ○ C, C++, Java, C# ● Packaging. ○ Python, JavaScript/Node (Interpreted Languages) ○ Web based applications ■ Combination of compiling source, or hybrid source, along with configuration files. ● Unit and integration testing. ● Automatically generate documentation. Good, Better, Best Write the compile statement each time on command line. Using Make tool you can simply/automate this process. Make can be configured to simplify even further and improve performance: only re- compile files that have changed; identify the names of the output files; which compiler to use etc.... An Increase In Complexity ● As a project grows a Make file can become very complicated. ● What usually happens is people start to roll their own build framework hacks. ● The problems really start when your project starts using 3rd party code that also uses a hacked framework; what then? ● Even on small projects (20 people) about 10% of time is spent on build issues. 10% On What? ● Bad dependencies resulting in hard to fix compilation errors. ● Bad dependencies resulting in bad software images.
    [Show full text]
  • WMS Performance Tests! Mapserver & Geoserver FOSS4G 2007
    W W W . R E F R A C T I O N S . N E T WMSWMS PerformancePerformance Tests!Tests! MapserverMapserver && GeoserverGeoserver FOSS4GFOSS4G 20072007 Shapefiles vs. PostGIS, Concurrency, and other exciting tests... Presented by Brock Anderson and Justin Deoliveira W W W . R E F R A C T I O N S . N E T PresentationPresentation OutlineOutline • Goals of testing. • Quick review of WMS. • Description of the test environment. • Discussion of performance tests and results. • Questions. W W W . R E F R A C T I O N S . N E T GoalsGoals 1. Compare performance of WMS GetMap requests in Mapserver and Geoserver. 2. Identify configuration settings that will improve performance. 3. Identify and fix inefficiencies in Geoserver. We do not test stability, usability, etc., * We do not test styling or labelling. We focus on vector input . W W W . R E F R A C T I O N S . N E T KeepingKeeping thethe teststests fairfair • Not an easy job! • We tried to understand what each server does under the hood to ensure we're not accidentally performing unnecessary processing on either server. W W W . R E F R A C T I O N S . N E T WebWeb MapMap ServiceService (WMS)(WMS) http://server.org/wms? request =getmap& layers =states,lakes& bbox =-85,36,-60,49& format =png&... WMS User A Map W W W . R E F R A C T I O N S . N E T TestTest EnvironmentEnvironment Client Computer Server Computer Apache 2.2.4 (with mod_fcgi) Vector Data Vector Mapserver 4.10.2 WMS requests JMeter Data 2.2 Tomcat 6.0.14 WMS requests Shapefiles Geoserver 1.6 beta 3 Additional Server Specs: Dual core (1.8Ghz per core).
    [Show full text]
  • Switching from Matlab to R
    Appendix A Switching from Matlab to R Most analysts find that it is not difficult to switch from Matlab to R, especially if a few key differences are kept in mind. This appendix provides a list of such differences, gleaned from the experience of the author and his colleagues (especially Clark Richards, who helped to compile the list). Syntax 1. Assignment to a variable is denoted with “=” in Matlab, but with “<-”inR. (Actually, it is possible to use “=” for R assignment, but not recommended.) 2. In R, assignment statements do not print their value, so there is no need for the Matlab convention of using “;” for silencing an assignment. 3. In R, as in most modern languages except Matlab, square brackets are used for indexing; see Sect. 2.3.4. 4. R matrices are not constructed with a square-bracket syntax, but rather with matrix(), as.matrix(), cbind() or rbind(); see Sect. 2.3.5. 5. In Matlab, vectors (one-dimensional sequences of values) are often represented as single-column matrices. The same form can be used in R, but most functions work with vectors, instead. The drop() function, which drops unused matrix dimensions, helps to convert Matlab data to R format, e.g. the following shows how to create vectors for regression with lm(). library(R.matlab) m <- readMat("filename.mat") x <- drop(m$x) y <- drop(m$y) lm(y ~ x) 6. R coerces arrays to a lower dimension whenever it can (Sect. 2.3.5.2), but the drop=FALSE argument can override this, e.g. © Springer Science+Business Media, LLC, part of Springer Nature 2018 241 D.
    [Show full text]
  • Tmap: Thematic Maps in R
    JSS Journal of Statistical Software April 2018, Volume 84, Issue 6. doi: 10.18637/jss.v084.i06 tmap: Thematic Maps in R Martijn Tennekes Statistics Netherlands Abstract Thematic maps show spatial distributions. The theme refers to the phenomena that is shown, which is often demographical, social, cultural, or economic. The best known thematic map type is the choropleth, in which regions are colored according to the dis- tribution of a data variable. The R package tmap offers a coherent plotting system for thematic maps that is based on the layered grammar of graphics. Thematic maps are cre- ated by stacking layers, where per layer, data can be mapped to one or more aesthetics. It is also possible to generate small multiples. Thematic maps can be further embellished by configuring the map layout and by adding map attributes, such as a scale bar and a compass. Besides plotting thematic maps on the graphics device, they can also be made interactive as an HTML widget. In addition, the R package tmaptools contains several convenient functions for reading and processing spatial data. Keywords: thematic maps, spatial data, R. 1. Introduction Visualization is important in statistics and data science. Without looking at the data, it is difficult to understand the underlying phenomena, to unveil anomalies, and, moreover, to extract valuable knowledge (Tufte 1983). Software tools to visually explore, analyze, and present data are therefore greatly needed. The R environment (R Core Team 2017) and its extension packages contain many possibilities to craft elegant and clarifying graphics, most notably package ggplot2 (Wickham 2009). Although it is possible to achieve great looking geospatial visualizations in R, the required programming is often complicated and the available functions are often limited in terms of features and flexibility.
    [Show full text]