Accessing PTV xServer internet with PTV client classes

While xServer internet uses HTTP basic authentication with <user>/<password>, it is highly recommended to work with the token assigned to your subscription using the combination “xtok”/<token>. Using the token is a safer way than using your far more sensible account data.

PTV provides pre-generated assemblies which contain the classes to access xServer internet. For this tutorial you need the xLocate JavaScript client. You have to reference this client-file in your application. Javascript does not have any implicit "import" mechanism but you can set a reference in your html-file.

<script type="text/javascript" src="https://svc-eu-n-test.cloud.ptvgroup.com/xlocate/xlocate-client.js"></script>

You can either reference the client directly (as shown above) or download PTV xLocate Javascript client and host it yourself.

This is a sample for a simple geocoding application and shows how to access the xLocate server.

// enter your token here!
var token = '<INSERT-YOUR-TOKEN-HERE>';
var xtok = 'xtok';

// initialize a sample address
var address = {
            "country":"L",
			"postCode": "",
            "city": "Wellenstein",
            "city2": "",
            "street": "Rue de la Moselle 5",
            "houseNumber": ""
                };

//initialize a client with the requestURL 
//the requestURL is the base URL of the service to use, before the /rs/ part
var client = new XLocateClient("https://xlocate-eu-n-test.cloud.ptvgroup.com/xlocate");

//set credentials and callerContext
client.setCredentials(xtok,token);
client.callerContext= {properties:[{
            "key": "CoordFormat",
            "value": "PTV_MERCATOR"
        }, {
            "key": "Profile",
            "value": "default"
        }]};

    
//send a request 
var result = client.findAddress(address,null,null,null,client.callerContext);   

You can try this code with our JSFiddle sample here.