More

Incorrect time displaying in ArcGIS API for JavaScript popup template?

Incorrect time displaying in ArcGIS API for JavaScript popup template?


I'm creating a web map that is updated a few times a day showing voltage readings from meters on our distribution network.

This layer has a field called ReadTime, and the data type is Date.

The date is formatted as:0/00/0000 00:00:00 AM

So, I'm using the shortDateLongTime format as shown here.

However, when I click on a meter the date comes in fine, but the time is wrong. For example, a value for one of the meters in the attribute table from ArcMap is6/17/2015 8:00:14 AM, but in the web map it's displaying as6/17/2015, 1:00:14 AM.

I'm assuming I'm missing a setting somewhere, but I haven't been able to find out where.

var popupTemplate = new PopupTemplate({ title: "{VoltageReadings_LOCATION}", fieldInfos: [{ fieldName: "VoltageReadings_READ_TIME", visible: true, label: "Read Time", format: { dateFormat: 'shortDateLongTime' } }], showAttachments: true });

Update to show what worked:

var popupTemplate = new PopupTemplate({ title: "{VoltageReadings_LOCATION}", fieldInfos: [{ fieldName: "VoltageReadings_READ_TIME", visible: true, label: "Read Time", format: { dateFormat: 'shortDateLongTime' } }], showAttachments: true }, { utcOffset: 0 });

It looks like your time wasn't stored in UTC and is getting converted improperly.

The PopupTemplate constructor has an option to set the UTC offset. Take a look at this discussion on the ArcGIS forum for a example on how to use it.


ArcGIS Javascript API - addLayers

I working on a project trying to add feature layers from ArcGIS online to a web map application using the JavaScript API where a user can toggle the layers on and off through a HTML tick box. The layers are importing correctly and are displayed when the tick boxes are bypassed but I can get it to work with the tickboxes. I have hacked code from ArcGIS samples etc so it must be some small thing I keep missing!

Here is the code - basically all I want is the layers to toggle on and off on top of a constant base map based on which checkboxes the user ticks on and off


I don't see any problem in the fiddler you have shared. I get 2 custom options. I may not be able to see the image as the image is missing. But I get 2 tool-tips. According to the documentation, when the actions are <3 then Image and text is shown, when its >=3, only image is shown and the title is shown as tool-tip.

The title of the action. When there are fewer than three actions defined in a popup, this text is displayed to the right of the icon or image representing the action. If there are three or more actions in the popup, then this text is used as a tooltip on the action.


Four-Step Process to Make a Simple Story Map

by Suzanne-Boden

Story maps are popular. Their visual, interactive nature makes them a great medium to share interesting information about a place or topic and spark discussion on real-world issues. To make a classic story map, you start with a web map. There are lots of ways to make a web map and just as many ways to make a story map.

In fact, if you're using the new ArcGIS StoryMaps, you may or may not use a web map—that choice is up to the storyteller. This post shows a simple process to make a classic story map.

The KISS principle is my preferred approach whenever possible overcomplicating things makes it hard to get stuff done. I found a simple way to make a web map. Here's a simple four-step process to craft a story map.

  1. Choose your story topic.
  2. Plan and execute your data strategy.
  3. Create a web map.
  4. Share the web map as a story map.

Step 1: Choose Your Story Topic

A story communicates something. Being concise is one key to effective communication, so for a story map, it's essential to choose a discrete topic and useful to narrow the topic down to a core message. Learning a new skill is often easier (and more fun) when you practice with a project that's personally interesting. Once you've mastered the skill, you can apply it to work projects.

Visitors to the Esri Training Center in Redlands get a printed piece listing local restaurants (with a map of course). That piece inspires an interesting story map topic (to me). The core message (inspired by the 3/50 project) is, despite being a fairly small town, Redlands has an impressive selection of local dining options.

Step 2: Plan and Execute Your Data Strategy

"Data strategy" may sound complicated, but all it means is decide which layers and attributes to include. It's important to choose only the most relevant layers—overloading a map with extraneous data muddies your story (remember, be concise). For this practice project:

  • Layers: Restaurant locations and a basemap for context are all that's needed.
  • Attributes: Restaurant name, address, description, and a web page URL.
  • Basemap: One of the free high-quality ArcGIS Online basemaps will work great.

To execute the strategy, assemble the data and choose a geographic data format. The format depends on the tools at your disposal.

  • If you use ArcGIS Pro or ArcMap and ArcGIS Enterprise, you can author and publish GIS services that are built from feature classes, imagery, or other geographic data. The advantage of using a service is that, as the underlying data changes, updating a web map is easy (you just republish the service, then refresh the map).
  • If you don't have access to tools to create a service, you can use the easy-button method: add data stored in shapefiles, text files, CSV files, or GPX files to the ArcGIS Online map viewer. You can also manually draw features in the map viewer.

Since this example showcases only 14 restaurants, it's easy to create point features to represent the restaurants. I'll just create a shapefile, then add it to the map viewer (here's another useful learning strategy: practice with manageable datasets otherwise, you risk getting derailed by data challenges).

  • When creating a shapefile for use in a web map, select the WGS 1984 geographic coordinate system and the Web Mercator Auxiliary Sphere projected coordinate system, the same coordinate systems used by commonly available basemaps. This will improve web map performance.
  • The map viewer requires that shapefiles be zipped (for small datasets that don't have detailed geometry, just zip the DBF, SHP, SHX, and PRJ files).

When the data is ready, add it to the map viewer to create a web map.

  • Go to www.arcgis.com and sign in to your ArcGIS Online organizational account or public account.
  • Click Map at the top of the window.
  • Zoom to the area of interest and choose a desired basemap from the gallery.
  • Click Add > Layer from File. Browse to the data file and add it. Depending on your data, you may choose to use generalized features or keep the original features. For a small number of simple points, keep the original features.

You can display point features on the map with a single symbol, as a heat map, or with unique symbols based on an attribute value.

  • For this practice story map, each restaurant should have a unique symbol. I can easily accomplish this by selecting the Unique symbols drawing style, then choosing the attribute to show.
  • For the attribute, I'll choose Name and then click the Options button to select the symbol colors, shape, and size.
  • After making the selections, click OK in the Options pane, then Done in the Change Style pane. If you want to adjust the symbology later, in the Contents pane mouse over the layer name, click the small down-facing arrow next to it, then click Change Style.
  • If the story map will include a legend, make sure your layer names are easily understood. You can rename a layer in the Contents pane by clicking its down arrow, then clicking Rename.

With the symbols configured, it's time to configure the pop-ups. When you click a feature on the map, you see a pop-up window with a default display of attributes. You can easily change the defaults to suit your story map needs.

  • In the Contents pane, click the layer down arrow, then click Configure Pop-up. In the Configure Pop-up pane, the pop-up title is already set to the Name attribute, which is good. To customize the pop-up contents, in the Display drop-down list, choose "A custom attribute display," then click Configure.

  • In the Custom Attribute Display dialog box, click the Add Field Name [+] button and choose the attributes you want shown in the pop-up. You can order and format them as desired.

A nice feature is the ability to link an attribute to a web page. In this example, there's an attribute that stores URLs. I can use the custom attribute functionality to display the same link text in all the pop-ups instead of individual (and long) URL strings. Here's how:

  • In the dialog box, select the attribute that contains URLs, then click the Create Link button. In the Link Properties dialog box, select and drag the attribute up to the URL field. Enter link text (e.g., "View web page") in the Description field. Click Set, then OK.
  • After configuring the pop-up content the way you like, save your pop-up changes, then save the web map. You will be prompted to enter a title, tags, and summary. This information will be propagated to the story map, so give it some thought.

Step 4: Share the Web Map as a Story Map

Now you have the story map foundation. ArcGIS Online provides a collection of web application templates (including classic story map templates). Using a template simplifies the work. To use a template, you have to share your web map.

  • In the map viewer, click Share.
    • If you have an ArcGIS Online public account, you need to share with everyone. If you're using an ArcGIS Online organizational account (or free trial) and you have permissions to share content, you can share the map with everyone or with an existing group.
    • If you like a template layout overall but want to make some changes to enhance your story map, you can download the template and use the readme file instructions to configure the changes. You will need access to a web server (and some basic HTML and JavaScript skills).

    In just a short amount of time, I have a link to a simple story map I can share with the world. More importantly, I've developed skills I can use in the future to create story maps on other topics.

    Telling stories has always been an essential way humans communicate and share knowledge. A story told through an accessible GIS map lens is a new way to communicate, and a powerful medium to share geographic knowledge that informs and influences.

    Want to learn more tips, techniques, and best practices to make story maps AND get hands-on practice? Check out Creating Story Maps with ArcGIS.


    6 Methods to Map Your Own Data: A Workshop

    by JosephKerski

    Today, there is no shortage of data available on open data portals, including those on ArcGIS Online (such as the Living Atlas of the World, and via ArcGIS Hub, and in many cities such as Cambridge Massachusetts and many countries such as Germany) and those we test and describe on our data blog http://spatialreserves.wordpress.com. But there will always be a need for people to map their own data. Great instructional value is inherent in doing so, including connectedness to the community, examining real world issues, field planning and methods, the use of data collection tools, outdoor education, and much more.

    If you are new to GIS, especially to web GIS, I encourage you to start with this HDI map of world countries, and this world plate tectonics map.

    Thus, there is no shortage of methods in which to collect your own data. In recent GIS workshops for faculty, I focus on the following 6 methods:

    1. Add data via a GPX file. GPX files can come from a variety of sources, including GPS receivers and smartphone fitness apps. Attached to this essay is a GPX file I collected in and around the University of Hamburg, Germany, using the RunKeeper app. Save this file to your device, and add this to ArcGIS Online or Pro using the Add data tool. Symbolize the points and line as you see fit, and select your basemap of choice. Note the "zinger" that appears in the GPX file. I on purpose did not remove this, because these occasional spikes in the field path provide useful teachable moments. This particular one occurred while I was inside St Michaels Church, gazing around at all the beauty, with the track "collecting" the whole time but losing some Wi-Fi hotspots, cell phone towers, and/or GPS satellites hence guessing at my true position and, for a time, being a few hundred meters off.
    2. Add data via a simple table in Comma Separated Value (CSV) or text file (separated by commas). Attached to this essay is a text file "fieldwork_hamburg_ped_counts.txt" in text format that I collected at 5 locations. The data I collected was the number of pedestrians in one minute at each location, on a Sunday afternoon in winter. Symbolize the points as graduated symbol on pedestrian count. Select a basemap of your choice. Save and share as you see fit. Pedestrian counts is one useful set of data that you can collect with students, comparing different times of day, days of the week, and seasons of the year. Note the high number of pedestrians at point #3 enjoying ice skating!
    3. Add data via an expanded table in text format for the same locations, but with a URL of a picture I took at each location. FYI, my Flickr photos for this activity are from this set here. After adding the data, click on each point, noting the "more info" for each popup that points to the photo. Symbolize as you see fit, and practice customizing the popup. Select a basemap of your choice. Save and share as you see fit.
    4. Use Survey123 to collect data in the area. Use this form to collect tree height, tree species, and tree condition: https://survey123.arcgis.com/share/933b03f8109e411cab344453dbd7a865 Examine the resulting map on: http://arcg.is/1COi0z . If you need the long URL, it is: http://www.arcgis.com/home/webmap/viewer.html?webmap=434cbc3ca6a342eca3122f08414e2be4&extent=9.9432. . After uploading a test point to this Survey and seeing your results on the map, create your OWN survey on this or another topic using the web form method via http://survey123.arcgis.com/. When your survey is finished, create a map from your survey and examine the pattern of your results. Save and share as appropriate. See attached slides for more information on this powerful field data collection tool.
    5. Create a story map of the data collected. Several ways exist to do this, but start with the simplest one: Go to https://storymaps.arcgis.com > Apps > Create Map Tour > Sign in to your ArcGIS Online account > add images from Flickr > access my images of the University of Hamburg and waterfront in the folder joseph_kerski (note underscore) > Done. In the story map, note the photo captions are read from the Flickr header information. Add the number of pedestrians at each point as follows, from points 1 through 5 (with 1 being the northernmost point, 2 to its southwest, and then 3, 4, and 5 progressively closer to the harbor front). Then, customize the color, basemap, logo, and extent. Save and share as you see fit. Under My Stories, edit the map for this story map and add the GPX file that you used earlier. Change one of the photo to an embedded Hamburg video from among the Hamburg choices on my channel: Our Earth - YouTube Re-save. Once you understand this method, use the map tour template as a guide to creating a tour table, for an even faster way of creating a story map.
    6. Use Mapillary to collect your own street view scenes and map them. Download the app and begin collecting on a path on your campus or in your community. Mapillary is an Esri business partner and I love using their tools for professional results without a great deal of work. See my essay here for more information: https://community.esri.com/community/education/blog/2017/03/24/examining-mapillary-views-in-arcgis-o. .

    The capabilities of these tools continue to become more powerful and easier to use with each update. Get out there into the field!


    Try it out!

    You might also ask, “Can’t I just use JavaScript to do all of this work for me?” Yes, you can do that, but using JavaScript instead of Arcade will limit the visualization to the scope of the app. Arcade can run on multiple systems throughout the ArcGIS platform, so the generated expression can be saved to the layer and consumed in other web apps and even ArcGIS Pro if needed.

    Hopefully, you’ve learned something new and have been inspired to write your own functions for generating Arcade expressions for data exploration apps. In fact, we already do this for some Smart Mapping functions in the API. Stay tuned to learn more about how we generate Arcade expressions internally in our Smart Mapping methods.


    Retrieving an Address for a Place ID

    Supply a placeId to find the address for a given place ID. The place ID is a unique identifier that can be used with other Google APIs. For example, you can supply the placeId returned by the Roads API to get the address for a snapped point. For more information about place IDs, see the place ID overview.

    When you supply a placeId , the request cannot contain any of the following fields:

    The following example accepts a place ID, finds the corresponding address, and centers the map at that location. It also brings up an info window showing the formatted address of the relevant place:

    TypeScript

    JavaScript

    Try Sample

    Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.


    Rename the "Define Projection" tool

    by DanPatterson_Re tired

    All too often, people use the Define Projection tool when they really want to use the Project tool, thinking that if they use it, their data will be projected into the coordinate system that they want.

    I suggest that the Define Projection tool

    • be renamed to Initial Projection or Fix Projection something similar OR
    • checks to prevent projected data being defined as geographic should be implemented and persistent in the interface
    • Also, this tool should, or could be disabled, if a coordinate system already exists, allowing the user time to think about what they are really trying to do.

    The two proposals Initial and Fix projection could call the same code essentially, allowing one to define a coordinate system for which one doesn't exist or to fix one that is incorrect.

    by ChrisFox by DanPatterson_Re tired

    After finishing two terms of teaching and warning students about the differences between these tools, the preference seems to use the Define Projection tool erroneously. some even thought the Project tool had to do with "projects" and not "projecting" even though it is appropriately located in the toolbox (grief!). In any event, the warning icon needs to be huge and flashing. or perhaps a popup, or the tool fails if the input and output extents don't jive (ie going from DD data to UTM).

    by ChrisFox by DanPatterson_Re tired

    The problem is still with us. Define projection is the go-to . ruining a good many starts to projects, when the Project tool should be used.

    by DanPatterson_Re tired

    Fix Coordinate System - FCS

    Use FCS if you defined a GCS as a PCS or vica versa

    Six years on, and the grief still continues

    by curtvprice

    I am speaking a bit out of school, as Esri should be left to make these UI decisions. but here's an idea.

    Add a boolean parameter - overwrite existing coordinate system, defaulting to true (checked) so current scripts and models won't be broken. It's really difficult to make a case to rename tools or change behavior because this can terribly break existing tools and workflows.

    However, this suggested implementation would give an opportunity for the tool dialog to warn users in two ways a) in the tool dialog help pane and b) The tool could raise the warning flag if the box is checked (again default) and there is a coordinate system defined already.

    This still won't keep users from going into the dataset properties XY Coordinates tab and changing it there, but it seems the Define Projection tool continues to confuse our students.


    Monitoring the Health of ArcGIS Enterprise

    You’ve just finished installing and configuring your ArcGIS Enterprise site. You’ve got services, maps, and apps published and your organization is making use of them. Perhaps some of these apps or services are mission critical to your organization and you want to make sure they’re working great. What now? How do you make sure you’ve got enough resources dedicated to your site? How do you ensure that these important services and apps are available when they are needed? How do you find out if something goes wrong? These are important questions and with a default ArcGIS Enterprise installation, it can be difficult to obtain the information you seek . What you need is some way of proactively checking up on your site, preferably with some mechanism that notifies you if something is wrong. This is where server monitoring comes in.

    Server monitoring can take the form of a set of simple utilities that tell you the basic health of your system, it can be a comprehensive GIS-server-specific suite of tools with reporting and advanced notification, or somewhere in between. This post will briefly discuss a few options that we at GISinc have had experience with.

    On the light-weight end of the spectrum is a set of Python scripts developed by GISinc that captures basic system health statistics such as CPU, RAM, disk space usage, and status of ArcGIS Server map services. These scripts run as scheduled tasks at intervals determined by you and are stored in a database that can be used to generate reports or presented in a service that can be consumed by an ArcGIS Dashboard for live viewing of the data.

    An ArcGIS Operations Dashboard hosted on an ArcGIS Enterprise site showing collected monitoring data

    These light-weight scripts require minimal system resources to run, and can be configured to notify you via email in the event that RAM, CPU, or Disk space usage exceed user-defined thresholds--and can also notify you if one or more ArcGIS Server services are unresponsive.

    On the opposite end of the server monitoring spectrum is a full-featured, GIS-Server-Specific server monitoring system. The most comprehensive and powerful system currently available that is specific to monitoring GIS Server s is Esri’s ArcGIS Monitor . ArcGIS Monitor includes a full suite of tools to allow you to analyze the performance of your system s , help you monitor the health of the system s , notify you of issues or problems as they occur, and view reports. Access to these tools is provided through an easy-to-use web browser interface that displays information in real time , and all the tools have been designed and optimized to provide the best GIS-specific insight into the performance of your site. Additional plug-in style tools can be added to customize the behavior and capabilities of ArcGIS Monitor so you can configure it to answer most any question you may have about your ArcGIS Enterprise site investment.

    Esri’s ArcGIS Monitor Dashboard

    At GISinc, w e have found that many users fall somewhere in between the se two ends of the server monitoring spectrum. The basic server monitoring script tools may be a little too basic, but perhaps the ArcGIS Monitor solution is a bit too comprehensive or budget may not allow for the acquisition of a high-end GIS-specific monitoring solution. There are numerous options between these ends of the spectrum, ranging from free/open-source monitoring software packages to fully paid , non-GIS-specific software designed specifically for monitoring the health of servers and network performance. Of the solutions available, one that has offered a beneficial balance of capability and reasonable cost is Paessler’s PRTG Network Monitor.

    PRTG Network Monitor’s welcome page shows a quick overview of sensor status

    PRTG Network Monitor is a professional server monitoring software solution that allows you to monitor your GIS server infrastructure using a collection of “sensors”. CPU usage on a server is a sensor. RAM usage on a server is a sensor. A database’s query response time is a sensor. Drive space usage is a sensor. Checking an individual map service for up/down status is a sensor. PRTG offers dozens of built-in sensor types , such as HTTP sensors, port sensors, bandwidth monitoring sensors, system health (CPU, RAM, Disk) sensors, and many others . While none of the sensors are GIS-specific, many of them can be configured to perform almost any monitoring activities that are important for GIS Server sites, such as monitoring the up/down status of individual map services’ REST endpoints. Sensors are licensed in blocks that are reasonably priced, and the first 100 sensors are included for free. For small ArcGIS Enterprise installations, 100 sensors may be all you need.

    PRTG’s Device Overview page for viewing all currently configured sensors

    In addition to a wide variety of sensor types available, PRTG offers automatic notification and alerting via email or by text message. Alerts can be configured for each sensor and the values at which notifications are sent are also configurable. Reports can be generated and exported as PDF files for sharing with others in your organization. Perhaps the most interesting and engaging way to interact with server monitoring data collected by PRTG is using customizable live dashboards, called “maps”.

    PRTG Map (dashboard) overview showing live monitoring data for five servers and several map services

    Maps in PRTG are real-time, customizable overview dashboards that show collected data. These maps can be configured pretty much however you choose and show data using graphs, icons, and tables. Maps can also contain links to other maps so you can construct a suite of dashboards that allow users to see either quick overviews or dig in deeper for more detailed views of system health. Maps can also be shared via web browser URLs so that other stakeholders such as managers can view information about your ArcGIS Enterprise installation and evaluate if sufficient resources have been allocated.

    PRTG Map showing the status of one ArcGIS Server machine

    Regardless of the size of your ArcGIS Enterprise installation, we at GISinc recommend that at least some form of server monitoring be employed so you can evaluate your system’s performance and catch potential problems before they happen or before users are impacted. We would love to work with you to determine and implement a server monitoring solution for your system’s needs, whether simple or complex.


    Frequently asked questions (FAQ)¶

    Opendatasoft is a turnkey SaaS platform developed for business users to easily share, publish and reuse structured datasets.

    Opendatasoft is not open source.

    Opendatasoft is selling a service, not a software. However, some parts of the stack are open source.

    Opendatasoft’s front-end is open source. It is built and packaged as a set of AngularJS directives. This project can be accessed on GitHub and comes with a full fledged documentation.

    Opendatasoft is also already contributing to the Elasticsearch project by releasing in the public space a set of plugins that we have developed and that we use internally:

    Opendatasoft sells a turnkey solution. Users manage their datasets on their domains by themselves. Of course, the Opendatasoft support team is more than willing to help handling complex / specific data management issues.

    Moreover, Opendatasoft maintains a data network which federates public datasets published by Opendatasoft customers as well as datasets published by the Opendatasoft staff.

    1. I’m representing a public administration. My country has already setup an Open Data initiative. Why should I have my own data portal?

    Open Data is about making data that has been produced by public administrations available to citizens. But most of the time, one may want to go beyond the simple delivery of raw files and:

    • Contextualize & increase the value of data
    • Make data easy-to-understand for citizens
    • Provide open services to an ecosystem of developers / reusers

    To that extent, having a data management tool tailored to your needs is mandatory and keep in mind that thanks to the Open APIs provided by Opendatasoft, your national Open Data portal will always have the possibility to reference your public datasets.

    1. If I publish datasets on Opendatasoft, will they automatically be available to everyone on the Web?

    The Opendatasoft platform can be used for both public and private data management projects. A given platform can even host public and private datasets. It is also possible to define the ACL of a recordset at the dataset level.

    The Opendatasoft platform natively supports the following file formats:

    • CSV``
    • GeoJSON
    • JSON
    • JSON lines
    • KML
    • OSM archives (OpenStreetMap)
    • Shapefile
    • MapInfo
    • Excel
    • OpenDocument Spreadsheet
    • Remotely stored files for any of the above formats (HTTP or FTP)

    Specific format parsers can also be made available by the Opendatasoft team for specific requirements.

    The Opendatasoft platform is also able to connect to remote Web services. Opendatasoft supports the following services in its standard version:

    • ArcGIS REST API
    • RSS / Atom feeds
    • Salesforce / Force.com (you’ll have to ask Opendatasoft support to activate it on your domain)

    Custom connectivity capabilities can be added upon request.

    Opendatasoft natively uses a subset of DCAT to describe datasets. The following metadata are available by default:

    • title
    • description
    • language
    • theme
    • keyword
    • license
    • publisher
    • reference

    It is possible to activate the full DCAT template, thus adding the following additional metadata:

    • created
    • issued
    • creator
    • contributor
    • accrual periodicity
    • spatial
    • temporal
    • granularity
    • data quality

    A full INSPIRE template is also available and can be activated on demand.

    The metadata template can be customized (adding custom metadata). To do so, simply issue a support request from your Opendatasoft’s back-office.

    You can create as many datasets as you want within the limit set in your licensing plan.

    As a domain administrator, you can fully customize the styling of your portal. Logos, pictos, colors, styles as well as the header, the footer and the dataset box layout in the catalog page can be fully customized.

    Use the security section in your dataset’s configuration page in Opendatasoft’s back-office to give other users or groups of users a write access to the dataset. These users should also have access to your domain to access your dataset. If this is not the case already, you should contact your domain administrator.

    A rich set of processing features is made available in the publishing console. Simply hit the Add Processor button.

    Opendatasoft supports Google and ESRI geocoding services. However, Opendatasoft doesn’t come with geocoding API keys. The domain administrator has to configure a geocoding API key for one of these services in the back-office configuration (Configuration > Data processing).

    1. I have geocoded data in my dataset but the map view doesn’t display anything. What went wrong?

    Remember that you dataset must contain at least a field of type Geo Point or Geo Shape

    • Geo Point: latitude,longitude in WGS84, e.g.: 48.2567,3.7689 .
    • Geo Shape: any valid Geo JSON geometry in WGS84
    1. What is a facet?

    Facets are the backbone of most of the features made available by the Opendatasoft platform. A facet is simply a field which has been given specific filtering and aggregation capabilities.

    In the example above, the fields country and year have been defined as facets (notice the filter button next to the type select).

    Facets can be seen as dimensions of a dataset. Facets can be defined on the following field types:

    Facets shall only be configured for fields that have a small number of different values compared to the number of records in a dataset. For instance, defining a facet on an field that would uniquely identify a record is useless as filtering on this field wouldn’t bring any added value.

    Facets are then used in a couple of places.

    You can first use them to filter dataset records in the explore console.

    As dimensions, facets support aggregations. You can thus use them to build advanced charts, as in the example below.

    We will be happy to discuss your needs and to propose you one of our plans.

    For a geo data visualization to be available, your dataset needs to contain a Geo Point 2D field with content in the latitude,longitude format. For instance: 48.2567,3.7689 .

    1. In the table view, I have not been able to sort the results using a specific field? What went wrong?

    By default, only the numerical fields are sortable. That is, fields having one of the following types:

    Text fields are not sortable by default. The dataset owner may configure some text fields to be sortable. Sortable text fields can be identified through the API ( sortable annotation).

    1. I published a dataset, but no category is displayed in the left column. What shall I do?

    Categories (facets) are built out of fields which have been defined as a facet. To set a field as a facet, simply click on the filter icon, in the field definition header in the publishing console.

    1. When I go to the analyze view, the displayed chart doesn’t make any sense. How could I change this?

    The dataset owner can easily define the default analytical representation of the dataset using the analyze tab in the publishing console. End-users can also simply choose different settings and build their own analytical data visualization using the available controls.

    There are three ways to embed Opendatasoft’s data visualizations on a website or any content management system:

    • Copy-paste the embed code that can directly be found on the Opendatasoft platform (usually located under the data visualization itself).
    • Use ODS Widgets, our open source widget library to build content pages tailored to your needs with one or several data visualizations at once.
    • Use Opendatasoft’s HTTP/REST APIs to develop your own embed.
    1. What is “Cartograph”?

    Cartograph is a tool developed by Opendatasoft to make it possible to build geo mashups out of datasets stored on the Opendatasoft platform.

    API is an acronym for Applications Programming Interface. An API is a set of methods for computer programs to exchange information in an autonomous way. Opendatasoft APIs allow for remote access to datasets using the HTTP protocol.

    APIs are a set of tools that developers can use to integrate data in their applications (Web applications, mobile applications, business applications. ).

    API endpoints are associated with quotas. Opendatasoft customers can configure their own quotas policy. Contact your Opendatasoft domain owner for more details.

    Whenever you publish a dataset, a dedicated API is created. See APIs documentation for more information.