Installation of POI-Data

General

• POIs (Point Of Interest) are geographical objects like hotels, restaurants or petrol stations.
• They are shipped in an Apache Derby database. It contains all the POI-data required for the PTV xLocate Server, the PTV xMap Server and the PTV xServer Bundle.
• Unlike basic map data, POI-data is only supplied for a whole map and not for specific countries within a map.

The layers are based on the map and version used, i.e. when upgrading your map, you also need to upgrade the POI-data.

Data Storage on DVD

The xServer folder contains POI-data for a dedicated map:

• POI_<Mapname>.zip

  This is the compressed file of the database with the POI-data for the PTV xLocate Server, PTV xMap Server and the PTV xServer Bundle.
  

Only for PTV xLocate Server

• xlocate-geodatasource.xml

  This is the configuration file of the database for PTV xLocate 1.18 or newer. Due to changes concerning Lucene, this configuration has performance improvements compared to older versions.
  

Only for PTV xMap Server

• POI_POI_<Mapname>.zip

  This is the compressed file of the bitmaps for the POI-data.
  

• xmap-geodatasource.xml

  This is the configuration file of the database for PTV xMap 1.18 or newer. Due to changes concerning Lucene, this configuration has performance improvements compared to older versions.
  

• geodata-poi-default.xml

  This is the additional configuration file with information how to display the geographic objects.
  

Only for PTV xServer Bundle

• POI_POI_<Mapname>.zip

  This is the compressed file of the bitmaps for the POI-data.

• xserverbundle-geodatasource.xml

  This is the configuration file of the database for PTV xServer Bundle 1.18 or newer. Due to changes concerning Lucene, this configuration has performance improvements compared to older versions.
  

• geodata-poi-default.xml

  This is the additional configuration file with information how to display the geographic objects.
  

Installation of the Data

In order to execute the following steps please stop the corresponding PTV xServer and restart it afterwards.

• Add the POI-data: Extract the POI_<Mapname>.zip file directly to the <PTV xServer folder>/data/ folder.

Only for PTV xLocate Server

• Add the database configuration:

  Copy the xlocate-geodatasource.xml file to the <PTV xLocate folder>/conf/ folder. Then back up the existing default-geodatasource.xml file (e.g. by renaming to default-geodatasource.xml.ori). Finally rename the xlocate-geodatasource.xml file to default-geodatasource.xml.

• Add additional configuration:

  Back up the existing geodata-poi-default.xml file in the <PTV xLocate folder>/conf/ folder (e.g. by renaming to geodata-poi-default.xml.ori). Then copy the geodata-poi-default.xml file to the <PTV xLocate folder>/conf/ folder.

Only for PTV xMap Server

• Add the POI icons for rendering on the map:

  Extract the POI_POI_<Mapname>.zip file directly to the <PTV xMap folder>/data/ folder. There was a change in the folder structure of the icons. The icons are now filed under their size, e.g. "22x22/poi". If you have any trouble rendering the icons, make sure the bitmap path in the file geodata-poi-default.xml is set correctly.

• Add the database configuration:

  Copy the xmap-geodatasource.xml file to the <PTV xMap folder>/conf/ folder. Then back up the existing default-geodatasource.xml file (e.g. by renaming to default-geodatasource.xml.ori). Finally rename the xmap-geodatasource.xml file to default-geodatasource.xml.

• Add additional configuration:

  Back up the existing geodata-poi-default.xml file in the <PTV xMap folder>/conf/ folder (e.g. by renaming to geodata-poi-default.xml.ori). Then copy the geodata-poi-default.xml file to the <PTV xMap folder>/conf/ folder.

Only for PTV xServer Bundle

• Add the POI icons for rendering on the map:

  Extract the POI_POI_<Mapname>.zip file directly to the <PTV xServer Bundle folder>/data/ folder. There was a change in the folder structure of the icons. The icons are now filed under their size, e.g. "22x22/poi". If you have any trouble rendering the icons, make sure the bitmap path in the file geodata-poi-default.xml is set correctly.

• Add the database configuration:

  Copy the xserverbundle-geodatasource.xml file to the <PTV xServer Bundle folder>/conf/ folder. Then back up the existing default-geodatasource.xml file (e.g. by renaming to default-geodatasource.xml.ori). Finally rename the xserverbundle-geodatasource.xml file to default-geodatasource.xml.

• Add additional configuration:

  Back up the existing geodata-poi-default.xml file in the <PTV xServer Bundle folder>/conf/ folder (e.g. by renaming to geodata-poi-default.xml.ori). Then copy the geodata-poi-default.xml file to the <PTV xServer Bundle folder>/conf/ folder.

Test your Installation

Test for the PTV xLocate Server

Test your configuration with the PTV Raw Request Runner in the PTV xLocate Management Console. Send the following JSON request. The example contains a findPOIByAddress request in Luxembourg. Please note the usage of the POI type number 7314 for hotels (see chapter POI-Type Overview).

PTV xLocate JSON Sample Request

{
  "addrs": {
    "country": "L",
    "state": "",
    "postCode": "",
    "city": "Luxembourg",
    "city2": "",
    "street": "",
    "houseNumber": "",
    "poiType": "7314",
    "poiName": "",
    "geoDataSourceLayer": "default.points-of-interest"
  },
  "options": [],
  "sorting": [],
  "additionalFields": [],
  "callerContext": {
    "properties": [
      {
        "key": "CoordFormat",
        "value": "PTV_MERCATOR"
      },
      {
        "key": "Profile",
        "value": "default"
      }
    ]
  }
}

As a result you should get a list of hotels in Luxembourg.

Find further information in the PTV xServer manual online: List of POI types, use cases etc.

Test for the PTV xMap Server

Test your configuration with the PTV Raw Request Runner in the PTV xMap Management Console. Send the following JSON request. To show POI-data, you need to add the layer information to the request - as marked in red in the request:

PTV xMap JSON Sample Request

{
  "mapSection": {
    "center": {
      "point": {
        "x": 681737.63,
        "y": 6375240.97
      }
    },
    "scale": 992,
    "scrollHorizontal": 0,
    "scrollVertical": 0,
    "zoom": 0
  },
  "mapParams": {
    "showScale": true,
    "useMiles": false
  },
  "imageInfo": {
    "format": "BMP",
    "width": 400,
    "height": 400,
    "imageParameter": ""
  },
  "layers": [
    {
      "$type": "SMOLayer",
      "name": "default.points-of-interest",
      "visible": true,
      "objectInfos": "GEOMETRY",
      "configuration": ""
    }
  ],
  "includeImageInResponse": true,
  "callerContext": {
    "properties": [
      {
        "key": "CoordFormat",
        "value": "PTV_MERCATOR"
      },
      {},
      {}
    ]
  }
}

As a result you should get a map section with rendered POI icons of all available POI-types.

By specifying the POI-type in the layer configuration you only receive the configured POI-type:

"layers": [
    {
      "$type": "SMOLayer",
      "name": "default.points-of-interest;[POITYPE]='7321'",
      "visible": true,
      "objectInfos": "GEOMETRY",
      "configuration": ""
    }
  ],

The POI-type "7321" stands for hospitals. Your result should show the hospitals on the map.

Find further information in the PTV xServer manual online: List of POI types, use cases etc.

Test for the PTV xServer Bundle

To test your POI-data installation for your PTV xServer Bundle you can perform the tests described for the PTV xLocate and PTV xMap server in the chapters above.

Find further information in the PTV xServer manual online: List of POI types, use cases etc.

Optimal Performance Optimisation

To achieve a better performance for both PTV xLocate Server and PTV xMap Server, the following two changes in the <PTV xServer folder>/conf/wrapper.conf file are recommended:

• Add an additional Java parameter to raise the page cache size of the Derby database:

  wrapper.java.additional.<New number>=-Dderby.storage.pageCacheSize=10000

POI-Type Overview

A list of all available POI-types can be found in the section List of POI types.

Copyright © 2024 PTV Logistics GmbH All rights reserved. | Imprint