Static Maps

Top Previous Topic Next Topic  Print this topic

XF Rendering Server 2013 can retrieve and embed static maps from the internet, using the xf:geomap extension. Maps are retrieved from http://maps.google.com.

 

Maps are inline graphic elements just like images, barcodes and charts, so they can be placed and manipulated as such.

 

Usage:

 

 

<xf:geomap xmlns:xf="http://www.ecrion.com/xf/1.0"

       address="ANY_LOCATION_IN_THE_WORLD"

       display-marker="BOOLEAN"

       map-type="GOOGLE_MAP_TYPE"

       zoom="INTEGER"

       key="MY_API_KEY"

       

       <!-- other image-specific attributes -->

       fo:content-width="LENGTH_OR_PERCENT"

       fo:content-height="LENGTH_OR_PERCENT"

       <!-- ... -->

/>

 

 

The attributes have the following meanings:

 

·address - the address the map should point to; it is recommended to be as specific as possible about the location
·display-marker - Boolean value telling whether or not to display a marker on the map in the exact location pointed to
·map-type - the type of the map as supported by the API; possible values are: "roadmap", "mobile", "satellite", "terrain", "hybrid"
·zoom - the zoom level; an integer ranging from "0" to "19", specifying the zoom level; "0" is World View mode, while "19" is Building View mode
·key - an API key that allows faster connection to the Google Maps service; a key will be provided by Google if the user has a Google Account (more details can be found here).

 

The extension also supports any other standard image-specific attributes, as long as they are prefixed with the XSL-FO namespace prefix (i.e. fo:content-width instead of content-width).

 

Example of usage:

 

 

       <xf:geomap xmlns:xf="http://www.ecrion.com/xf/1.0" address="Pacific Avenue Atlantic City NJ USA" display-marker="true" map-type="hybrid" zoom="17" key="MY_API_KEY" fo:content-width="512.000px" fo:content-height="512.000px" />

 

 

Output: