General Introduction to Geographic Maps
This topic introduces the Geographic Map component of Logi Report in general.
You can integrate a geographic map in Logi Report with Google Maps, OpenStreetMap, or OpenCycleMap.
- Google Maps
Using the Google Maps JavaScript API, you can display three types of maps in Logi Report reports: Roadmap, Satellite, and Terrain. Logi Report only supports the Google Maps JavaScript API Version 3.Users with higher permission level can access more resources about Google Maps. For the 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. - OpenStreetMap and OpenCycleMap
Using the OpenLayers JavaScript API, you can display OpenStreetMap and two types of OpenCycleMap, Cycle Map, and Transport Map in Logi Report reports.
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 specified tip information when users move the mouse over the markers at runtime. For geographic maps in web reports and library components, each group level can even have some areas with area tips, and you can display each area with a polygon of distinct color.
The interactive features of geographic maps only work in Page Report Studio, Web Report Studio, and JDashboard that do not run on Internet Explorer 8. In Designer, you can preview geographic maps in web reports and library components as static maps and export them as static maps to Mail, HTML, PDF, Excel, RTF, PostScript, and Fax.
In addition, to use the interactive geographic map features, you have to make sure your Server and web browser have access to the internet. If you are in an intranet, you should specify the proxy for both of them. To specify the proxy for Server, you need to open the batch file JRServer.bat in <install_root>\bin
, and then add the following parameters in the file::
- http.proxyHost: The host name of the proxy server.
- http.proxyPort: The port number, the default value being 80.
- http.nonProxyHosts: A list of hosts that should be reached directly, bypassing the proxy. This is a list of patterns separated by "|". The patterns may start or end with a "*" for wildcards. Logi Report reaches any host matching one of these patterns through a direct connection instead of through a proxy.
Besides HTTP protocol, Logi Report also supports HTTPS protocol. 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
.