GeoLocation

Request

The GeoLocation API is used to retrieve a location from a submitted set of Wi-Fi and/or Cell-ID data.

POST https://apis.location.studio/geo/v2/geolocation/json

Required Parameters

api_key

String

Your Location Studio API Key

Required Headers

HTTP Headers

Content-Type *-Used to specify the nature of the data in the POST request. Currently only accepting: application/json

Required Body

radio_type

String

(optional) The radio type of this cell tower. Supported values are lte, gsm, cdma, and wcdma.

cell_towers

Array

An array of cell towers. Each one of them containing the following parameters.

radio_type - The radio type of this cell tower. Supported values are lte, gsm, cdma, and wcdma.

mobile_country_code - The Mobile Country Code (MCC).

mobile_network_code - The Mobile Network Code (MNC) for GSM, WCDMA and LTE. The SystemID (SID) for CDMA.

location_area_code - The Location Area Code (LAC) for GSM, WCDMA and LTE. The Network ID (NID) for CDMA.

cell_id - The Cell ID (CID) for GSM, WCDMA and LTE. The Basestation ID (BID) for CDMA.

signal_strength - The signal strength for this cell tower in dBm.

timing_advance - The timing advance value for this cell tower (optional).

primary_scrambling_code - The PSC for WCDMA and physical Cell ID for LTE (optional).

serving - Values: 1 = serving cell, 0 = neighboring cell. Default = 1. (optional).

wifi_access_points

Array

An array of Wi-Fi access points. Each one of them containing the following parameters.

mac_address - The BSSID of the Wi-Fi router.

ssid - The SSID of the Wi-Fi router (optional).

signal_strength - The measured signal strength of the Wi-Fi router in dBm.

Response

Description

If a location is found, the following information is returned. If a location is not found, a HTTP status 404 will be returned.

Response:

{
  "location": {
    "lat": 55.71233,
    "lon": 13.21536
  },
  "accuracy": 2774
}

Test