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* |
Responses
Status: 200 -
Status: 400 -
| Stato | Messaggio |
|---|---|
| 01 | Formato address non valido o obbligatorio |
| 02 | Il throughput richiesto e' superiore a quello consentito |
| 03 | L'utenza non ha fornito il consenso alla localizzazione |
| 04 | L'MSISDN e' sconosciuto |
| 05 | L'MSISDN ha il terminale spento o non raggiungibile |
| 06 | L'MSISDN e' acceso ed autorizzato, ma non e' possibile stabilire la posizione |
Status: 404 - URI non valida
Status: 500 -
| status | message |
|---|---|
| 01 | Errore interno |
Status: 502 -
| status | message |
|---|---|
| 01 | Bad Gateway |