Terminal Location

Default

addressQueriesLocationGet

It allows you to retrieve the localization information of TIM customers.

Example

Request

GET /location/v1/tel:+393351111111/queries/location HTTP/1.1 Host: example.com Authorization: Bearer 90302092932902309392390 
Response
HTTP/1.1 200 OK Content-Type: application/xml Date: Thu, 02 Jun 2011 02:51:59 GMT   <terminalLocationList> <terminalLocation> <address>tel:+393351111111</address> <locationRetrievalStatus>Retrieved</locationRetrievalStatus> <currentLocation> <latitude>46.093056</latitude> <longitude>11.116111</longitude> <altitude></altitude> <accuracy>100</accuracy> <timestamp>2011-06-02T02:53:23.000Z</timestamp> </currentLocation> </terminalLocation> </terminalLocationList>


/{address}/queries/location

Usage and SDK Samples

curl -X GET "https://easyapilab.telecomitalia.it:8248/location/v1/{address}/queries/location"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.DefaultApi;

import java.io.File;
import java.util.*;

public class DefaultApiExample {

    public static void main(String[] args) {
        
        DefaultApi apiInstance = new DefaultApi();
        String authorization = authorization_example; // String | Example: Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==
        String address = address_example; // String | MSISDN : Telephone number as tel ' URI in international format (global-number ) with 9-16 digits and no parameters (es. tel : +393351111111).
        try {
            terminalLocationList result = apiInstance.addressQueriesLocationGet(authorization, address);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DefaultApi#addressQueriesLocationGet");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.DefaultApi;

public class DefaultApiExample {

    public static void main(String[] args) {
        DefaultApi apiInstance = new DefaultApi();
        String authorization = authorization_example; // String | Example: Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==
        String address = address_example; // String | MSISDN : Telephone number as tel ' URI in international format (global-number ) with 9-16 digits and no parameters (es. tel : +393351111111).
        try {
            terminalLocationList result = apiInstance.addressQueriesLocationGet(authorization, address);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling DefaultApi#addressQueriesLocationGet");
            e.printStackTrace();
        }
    }
}
String *authorization = authorization_example; // Example: Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==
String *address = address_example; // MSISDN : Telephone number as tel ' URI in international format (global-number ) with 9-16 digits and no parameters (es. tel : +393351111111).

DefaultApi *apiInstance = [[DefaultApi alloc] init];

// It allows you to retrieve the localization information of TIM customers.
[apiInstance addressQueriesLocationGetWith:authorization
    address:address
              completionHandler: ^(terminalLocationList output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var TerminalLocation = require('terminal_location');

var api = new TerminalLocation.DefaultApi()

var authorization = authorization_example; // {String} Example: Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==

var address = address_example; // {String} MSISDN : Telephone number as tel ' URI in international format (global-number ) with 9-16 digits and no parameters (es. tel : +393351111111).


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.addressQueriesLocationGet(authorization, address, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class addressQueriesLocationGetExample
    {
        public void main()
        {
            
            var apiInstance = new DefaultApi();
            var authorization = authorization_example;  // String | Example: Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==
            var address = address_example;  // String | MSISDN : Telephone number as tel ' URI in international format (global-number ) with 9-16 digits and no parameters (es. tel : +393351111111).

            try
            {
                // It allows you to retrieve the localization information of TIM customers.
                terminalLocationList result = apiInstance.addressQueriesLocationGet(authorization, address);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DefaultApi.addressQueriesLocationGet: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\Api\DefaultApi();
$authorization = authorization_example; // String | Example: Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==
$address = address_example; // String | MSISDN : Telephone number as tel ' URI in international format (global-number ) with 9-16 digits and no parameters (es. tel : +393351111111).

try {
    $result = $api_instance->addressQueriesLocationGet($authorization, $address);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DefaultApi->addressQueriesLocationGet: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::DefaultApi;

my $api_instance = WWW::SwaggerClient::DefaultApi->new();
my $authorization = authorization_example; # String | Example: Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==
my $address = address_example; # String | MSISDN : Telephone number as tel ' URI in international format (global-number ) with 9-16 digits and no parameters (es. tel : +393351111111).

eval { 
    my $result = $api_instance->addressQueriesLocationGet(authorization => $authorization, address => $address);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling DefaultApi->addressQueriesLocationGet: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.DefaultApi()
authorization = authorization_example # String | Example: Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==
address = address_example # String | MSISDN : Telephone number as tel ' URI in international format (global-number ) with 9-16 digits and no parameters (es. tel : +393351111111).

try: 
    # It allows you to retrieve the localization information of TIM customers.
    api_response = api_instance.address_queries_location_get(authorization, address)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling DefaultApi->addressQueriesLocationGet: %s\n" % e)

Parameters

Path parameters
Name Description
address*
String
MSISDN : Telephone number as tel ' URI in international format (global-number ) with 9-16 digits and no parameters (es. tel : +393351111111).
Required
Header parameters
Name Description
Authorization*
String
Example: <code>Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==</code>
Required

Responses

Status: 200 -

Status: 400 -
StatoMessaggio
01Formato address non valido o obbligatorio
02Il throughput richiesto e' superiore a quello consentito
03L'utenza non ha fornito il consenso alla localizzazione
04L'MSISDN e' sconosciuto
05L'MSISDN ha il terminale spento o non raggiungibile
06L'MSISDN e' acceso ed autorizzato, ma non e' possibile stabilire la posizione

Status: 404 - URI non valida

Status: 500 -
statusmessage
01Errore interno

Status: 502 -
statusmessage
01Bad Gateway