The geographic map component is a data component integrated with Google Maps, OpenStreetMap or OpenCycleMap, which enables analyzing data geographically. Geo Analysis extends traditional data analysis on static maps, where zooming and panning are common, to more dynamic methods of interacting with geographic data. Drill down the hierarchy from country to state to county. Navigate through and analyze the data using a familiar map interface.
Using the Google Maps Javascript API, three types of maps can be displayed in JReport: roadmap, satellite and terrain. JReport only supports the Google Maps Javascript API Version 3.
Users with higher permission level can access more resources about Google Maps. For Google Maps API documentation, it is suggested that you apply for one API key to Google Maps application. If you have one API key, you can add it directly in the configuration file mapConfiguration.xml in <install_root>\bin
with the following format: <property name="google.api.key">your key</property>
. If you are a business user with a client ID, you can add it in the configuration file mapConfiguration.xml with the following format: <property name="google.api.client">your client id</property>
. Then you can access more resources about Google Maps.
The interactive features of Google maps only work in Page Report Studio, Web Report Studio and JDashboard; however, static Google map images are supported in PDF and HTML formats with some limitations (for details, refer to Google Static Maps API).
Using OpenLayers Javascript API, OpenStreetMap and two types of OpenCycleMap, namely, Cycle Map and Transport Map, can be displayed in JReport.
OpenStreetMap and OpenCycleMap cannot be displayed in the Designer View mode or be exported or printed in JReport Designer as the Static Maps API is not supported at present. Their interactive features only work in Page Report Studio, Web Report Studio and JDashboard.
Every geographic map component has its own data definition and can be manipulated by report developers. You can create a geographic map with a defined data source and group levels. Each group level has some markers with marker tips which show the defined tip information when you move the mouse over the markers at runtime. For geographic maps in web reports or library components, each group level can even have some areas with area tips, and each area can be shown with a polygon of distinct color.
Pick a task from the following:
Notes:
<install_root>\bin
, and then add the following parameters in the file::
Besides HTTP protocol, HTTPS protocol is also supported by JReport. Loading the Maps API over HTTPS is necessary in SSL applications to avoid security warnings in most browsers, and is recommended for applications that include sensitive user data, such as a user's location, in requests.
You can specify the required URL in the configuration file mapConfiguration.xml in <install_root>\bin
.