[ aws . iotwireless ]

get-position-estimate

Description

Get estimated position information as a payload in GeoJSON format. The payload measurement data is resolved using solvers that are provided by third-party vendors.

See also: AWS API Documentation

Synopsis

  get-position-estimate
[--wi-fi-access-points <value>]
[--cell-towers <value>]
[--ip <value>]
[--gnss <value>]
[--timestamp <value>]
<outfile>
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Options

--wi-fi-access-points (list)

Retrieves an estimated device position by resolving WLAN measurement data. The position is resolved using HERE’s Wi-Fi based solver.

(structure)

Wi-Fi access point.

MacAddress -> (string) [required]

Wi-Fi MAC Address.

Constraints:

• min: 12
• max: 17
• pattern: ^([0-9A-Fa-f]{2}[:-]?){5}([0-9A-Fa-f]{2})$

Rss -> (integer) [required]

Received signal strength (dBm) of the WLAN measurement data.

Constraints:

• min: -128
• max: 0

Shorthand Syntax:

MacAddress=string,Rss=integer ...

JSON Syntax:

[
  {
    "MacAddress": "string",
    "Rss": integer
  }
  ...
]

--cell-towers (structure)

Retrieves an estimated device position by resolving measurement data from cellular radio towers. The position is resolved using HERE’s cellular-based solver.

Gsm -> (list)

GSM object information.

Constraints:

• min: 1
• max: 16

(structure)

GSM object.

Mcc -> (integer) [required]

Mobile Country Code.

Constraints:

• min: 200
• max: 999

Mnc -> (integer) [required]

Mobile Network Code.

Constraints:

• min: 0
• max: 999

Lac -> (integer) [required]

Location area code.

Constraints:

• min: 1
• max: 65535

GeranCid -> (integer) [required]

GERAN (GSM EDGE Radio Access Network) Cell Global Identifier.

Constraints:

• min: 0
• max: 65535

GsmLocalId -> (structure)

GSM local identification (local ID) information.

Bsic -> (integer) [required]

GSM base station identity code (BSIC).

Constraints:

• min: 0
• max: 63

Bcch -> (integer) [required]

GSM broadcast control channel.

Constraints:

• min: 0
• max: 1023

GsmTimingAdvance -> (integer)

Timing advance value, which corresponds to the length of time a signal takes to reach the base station from a mobile phone.

Constraints:

• min: 0
• max: 63

RxLevel -> (integer)

Rx level, which is the received signal power, measured in dBm (decibel-milliwatts).

Constraints:

• min: -110
• max: -25

GsmNmr -> (list)

GSM object for network measurement reports.

Constraints:

• min: 1
• max: 32

(structure)

GSM object for network measurement reports.

Bsic -> (integer) [required]

GSM base station identity code (BSIC).

Constraints:

• min: 0
• max: 63

Bcch -> (integer) [required]

GSM broadcast control channel.

Constraints:

• min: 0
• max: 1023

RxLevel -> (integer)

Rx level, which is the received signal power, measured in dBm (decibel-milliwatts).

Constraints:

• min: -110
• max: -25

GlobalIdentity -> (structure)

Global identity information of the GSM object.

Lac -> (integer) [required]

Location area code of the global identity.

Constraints:

• min: 1
• max: 65535

GeranCid -> (integer) [required]

GERAN (GSM EDGE Radio Access Network) cell global identifier.

Constraints:

• min: 0
• max: 65535

Wcdma -> (list)

WCDMA object information.

Constraints:

• min: 1
• max: 16

(structure)

WCDMA.

Mcc -> (integer) [required]

Mobile Country Code.

Constraints:

• min: 200
• max: 999

Mnc -> (integer) [required]

Mobile Network Code.

Constraints:

• min: 0
• max: 999

Lac -> (integer)

Location Area Code.

Constraints:

• min: 1
• max: 65535

UtranCid -> (integer) [required]

UTRAN (UMTS Terrestrial Radio Access Network) Cell Global Identifier.

Constraints:

• min: 0
• max: 268435455

WcdmaLocalId -> (structure)

WCDMA local ID information.

Uarfcndl -> (integer) [required]

WCDMA UTRA Absolute RF Channel Number downlink.

Constraints:

• min: 0
• max: 16383

Psc -> (integer) [required]

Primary Scrambling Code.

Constraints:

• min: 0
• max: 511

Rscp -> (integer)

Received Signal Code Power (signal power) (dBm).

Constraints:

• min: -120
• max: -25

PathLoss -> (integer)

Path loss, or path attenuation, is the reduction in power density of an electromagnetic wave as it propagates through space.

Constraints:

• min: 46
• max: 158

WcdmaNmr -> (list)

WCDMA object for network measurement reports.

Constraints:

• min: 1
• max: 32

(structure)

Network Measurement Reports.

Uarfcndl -> (integer) [required]

WCDMA UTRA Absolute RF Channel Number downlink.

Constraints:

• min: 0
• max: 16383

Psc -> (integer) [required]

Primary Scrambling Code.

Constraints:

• min: 0
• max: 511

UtranCid -> (integer) [required]

UTRAN (UMTS Terrestrial Radio Access Network) Cell Global Identifier.

Constraints:

• min: 0
• max: 268435455

Rscp -> (integer)

Received Signal Code Power (signal power) (dBm)

Constraints:

• min: -120
• max: -25

PathLoss -> (integer)

Path loss, or path attenuation, is the reduction in power density of an electromagnetic wave as it propagates through space.

Constraints:

• min: 46
• max: 158

Tdscdma -> (list)

TD-SCDMA object information.

Constraints:

• min: 1
• max: 16

(structure)

TD-SCDMA object.

Mcc -> (integer) [required]

Mobile Country Code.

Constraints:

• min: 200
• max: 999

Mnc -> (integer) [required]

Mobile Network Code.

Constraints:

• min: 0
• max: 999

Lac -> (integer)

Location Area Code.

Constraints:

• min: 1
• max: 65535

UtranCid -> (integer) [required]

UTRAN (UMTS Terrestrial Radio Access Network) Cell Global Identifier.

Constraints:

• min: 0
• max: 268435455

TdscdmaLocalId -> (structure)

TD-SCDMA local identification (local ID) information.

Uarfcn -> (integer) [required]

TD-SCDMA UTRA (Universal Terrestrial Radio Access Network) absolute RF channel number (UARFCN).

Constraints:

• min: 0
• max: 16383

CellParams -> (integer) [required]

Cell parameters for TD-SCDMA.

Constraints:

• min: 0
• max: 127

TdscdmaTimingAdvance -> (integer)

TD-SCDMA Timing advance.

Constraints:

• min: 0
• max: 1530

Rscp -> (integer)

Signal power of the received signal (Received Signal Code Power), measured in decibel-milliwatts (dBm).

Constraints:

• min: -120
• max: -25

PathLoss -> (integer)

Path loss, or path attenuation, is the reduction in power density of an electromagnetic wave as it propagates through space.

Constraints:

• min: 46
• max: 158

TdscdmaNmr -> (list)

TD-SCDMA object for network measurement reports.

Constraints:

• min: 1
• max: 32

(structure)

TD-SCDMA object for network measurement reports.

Uarfcn -> (integer) [required]

TD-SCDMA UTRA (Universal Terrestrial Radio Access Network) absolute RF channel number.

Constraints:

• min: 0
• max: 16383

CellParams -> (integer) [required]

Cell parameters for TD-SCDMA network measurement reports object.

Constraints:

• min: 0
• max: 127

UtranCid -> (integer)

UTRAN (UMTS Terrestrial Radio Access Network) cell global identifier.

Constraints:

• min: 0
• max: 268435455

Rscp -> (integer)

Code power of the received signal, measured in decibel-milliwatts (dBm).

Constraints:

• min: -120
• max: -25

PathLoss -> (integer)

Path loss, or path attenuation, is the reduction in power density of an electromagnetic wave as it propagates through space.

Constraints:

• min: 46
• max: 158

Lte -> (list)

LTE object information.

Constraints:

• min: 1
• max: 16

(structure)

LTE object.

Mcc -> (integer) [required]

Mobile Country Code.

Constraints:

• min: 200
• max: 999

Mnc -> (integer) [required]

Mobile Network Code.

Constraints:

• min: 0
• max: 999

EutranCid -> (integer) [required]

E-UTRAN (Evolved Universal Terrestrial Radio Access Network) Cell Global Identifier.

Constraints:

• min: 0
• max: 268435455

Tac -> (integer)

LTE tracking area code.

Constraints:

• min: 0
• max: 65535

LteLocalId -> (structure)

LTE local identification (local ID) information.

Pci -> (integer) [required]

Physical cell ID.

Constraints:

• min: 0
• max: 503

Earfcn -> (integer) [required]

Evolved universal terrestrial radio access (E-UTRA) absolute radio frequency channel number (FCN).

Constraints:

• min: 0
• max: 262143

LteTimingAdvance -> (integer)

LTE timing advance.

Constraints:

• min: 0
• max: 1282

Rsrp -> (integer)

Signal power of the reference signal received, measured in dBm (decibel-milliwatts).

Constraints:

• min: -140
• max: -44

Rsrq -> (float)

Signal quality of the reference Signal received, measured in decibels (dB).

Constraints:

• min: -19.5
• max: -3

NrCapable -> (boolean)

Parameter that determines whether the LTE object is capable of supporting NR (new radio).

LteNmr -> (list)

LTE object for network measurement reports.

Constraints:

• min: 1
• max: 32

(structure)

LTE object for network measurement reports.

Pci -> (integer) [required]

Physical cell ID.

Constraints:

• min: 0
• max: 503

Earfcn -> (integer) [required]

E-UTRA (Evolved universal terrestrial Radio Access) absolute radio frequency channel Number (EARFCN).

Constraints:

• min: 0
• max: 262143

EutranCid -> (integer)

E-UTRAN (Evolved Universal Terrestrial Radio Access Network) cell global identifier (EUTRANCID).

Constraints:

• min: 0
• max: 268435455

Rsrp -> (integer)

Signal power of the reference signal received, measured in dBm (decibel-milliwatts).

Constraints:

• min: -140
• max: -44

Rsrq -> (float)

Signal quality of the reference Signal received, measured in decibels (dB).

Constraints:

• min: -19.5
• max: -3

Cdma -> (list)

CDMA object information.

Constraints:

• min: 1
• max: 16

(structure)

CDMA (Code-division multiple access) object.

SystemId -> (integer) [required]

CDMA system ID (SID).

Constraints:

• min: 1
• max: 32767

NetworkId -> (integer) [required]

CDMA network ID (NID).

Constraints:

• min: 0
• max: 65535

BaseStationId -> (integer) [required]

CDMA base station ID (BSID).

Constraints:

• min: 0
• max: 65535

RegistrationZone -> (integer)

CDMA registration zone (RZ).

Constraints:

• min: 0
• max: 4095

CdmaLocalId -> (structure)

CDMA local identification (local ID) parameters.

PnOffset -> (integer) [required]

Pseudo-noise offset, which is a characteristic of the signal from a cell on a radio tower.

Constraints:

• min: 0
• max: 511

CdmaChannel -> (integer) [required]

CDMA channel information.

Constraints:

• min: 0
• max: 4095

PilotPower -> (integer)

Transmit power level of the pilot signal, measured in dBm (decibel-milliwatts).

Constraints:

• min: -142
• max: -49

BaseLat -> (float)

CDMA base station latitude in degrees.

Constraints:

• min: -90
• max: 90

BaseLng -> (float)

CDMA base station longitude in degrees.

Constraints:

• min: -180
• max: 180

CdmaNmr -> (list)

CDMA network measurement reports.

Constraints:

• min: 1
• max: 32

(structure)

CDMA object for network measurement reports.

PnOffset -> (integer) [required]

Pseudo-noise offset, which is a characteristic of the signal from a cell on a radio tower.

Constraints:

• min: 0
• max: 511

CdmaChannel -> (integer) [required]

CDMA channel information.

Constraints:

• min: 0
• max: 4095

PilotPower -> (integer)

Transmit power level of the pilot signal, measured in dBm (decibel-milliwatts).

Constraints:

• min: -142
• max: -49

BaseStationId -> (integer)

CDMA base station ID (BSID).

Constraints:

• min: 0
• max: 65535

JSON Syntax:

{
  "Gsm": [
    {
      "Mcc": integer,
      "Mnc": integer,
      "Lac": integer,
      "GeranCid": integer,
      "GsmLocalId": {
        "Bsic": integer,
        "Bcch": integer
      },
      "GsmTimingAdvance": integer,
      "RxLevel": integer,
      "GsmNmr": [
        {
          "Bsic": integer,
          "Bcch": integer,
          "RxLevel": integer,
          "GlobalIdentity": {
            "Lac": integer,
            "GeranCid": integer
          }
        }
        ...
      ]
    }
    ...
  ],
  "Wcdma": [
    {
      "Mcc": integer,
      "Mnc": integer,
      "Lac": integer,
      "UtranCid": integer,
      "WcdmaLocalId": {
        "Uarfcndl": integer,
        "Psc": integer
      },
      "Rscp": integer,
      "PathLoss": integer,
      "WcdmaNmr": [
        {
          "Uarfcndl": integer,
          "Psc": integer,
          "UtranCid": integer,
          "Rscp": integer,
          "PathLoss": integer
        }
        ...
      ]
    }
    ...
  ],
  "Tdscdma": [
    {
      "Mcc": integer,
      "Mnc": integer,
      "Lac": integer,
      "UtranCid": integer,
      "TdscdmaLocalId": {
        "Uarfcn": integer,
        "CellParams": integer
      },
      "TdscdmaTimingAdvance": integer,
      "Rscp": integer,
      "PathLoss": integer,
      "TdscdmaNmr": [
        {
          "Uarfcn": integer,
          "CellParams": integer,
          "UtranCid": integer,
          "Rscp": integer,
          "PathLoss": integer
        }
        ...
      ]
    }
    ...
  ],
  "Lte": [
    {
      "Mcc": integer,
      "Mnc": integer,
      "EutranCid": integer,
      "Tac": integer,
      "LteLocalId": {
        "Pci": integer,
        "Earfcn": integer
      },
      "LteTimingAdvance": integer,
      "Rsrp": integer,
      "Rsrq": float,
      "NrCapable": true|false,
      "LteNmr": [
        {
          "Pci": integer,
          "Earfcn": integer,
          "EutranCid": integer,
          "Rsrp": integer,
          "Rsrq": float
        }
        ...
      ]
    }
    ...
  ],
  "Cdma": [
    {
      "SystemId": integer,
      "NetworkId": integer,
      "BaseStationId": integer,
      "RegistrationZone": integer,
      "CdmaLocalId": {
        "PnOffset": integer,
        "CdmaChannel": integer
      },
      "PilotPower": integer,
      "BaseLat": float,
      "BaseLng": float,
      "CdmaNmr": [
        {
          "PnOffset": integer,
          "CdmaChannel": integer,
          "PilotPower": integer,
          "BaseStationId": integer
        }
        ...
      ]
    }
    ...
  ]
}

--ip (structure)

Retrieves an estimated device position by resolving the IP address information from the device. The position is resolved using MaxMind’s IP-based solver.

IpAddress -> (string) [required]

IP address information.

Shorthand Syntax:

IpAddress=string

JSON Syntax:

{
  "IpAddress": "string"
}

--gnss (structure)

Retrieves an estimated device position by resolving the global navigation satellite system (GNSS) scan data. The position is resolved using the GNSS solver powered by LoRa Cloud.

Payload -> (string) [required]

Payload that contains the GNSS scan result, or NAV message, in hexadecimal notation.

Constraints:

• max: 2048

CaptureTime -> (float)

Optional parameter that gives an estimate of the time when the GNSS scan information is taken, in seconds GPS time (GPST). If capture time is not specified, the local server time is used.

CaptureTimeAccuracy -> (float)

Optional value that gives the capture time estimate accuracy, in seconds. If capture time accuracy is not specified, default value of 300 is used.

AssistPosition -> (list)

Optional assistance position information, specified using latitude and longitude values in degrees. The coordinates are inside the WGS84 reference frame.

Constraints:

• min: 2
• max: 2

(float)

AssistAltitude -> (float)

Optional assistance altitude, which is the altitude of the device at capture time, specified in meters above the WGS84 reference ellipsoid.

Use2DSolver -> (boolean)

Optional parameter that forces 2D solve, which modifies the positioning algorithm to a 2D solution problem. When this parameter is specified, the assistance altitude should have an accuracy of at least 10 meters.

Shorthand Syntax:

Payload=string,CaptureTime=float,CaptureTimeAccuracy=float,AssistPosition=float,float,AssistAltitude=float,Use2DSolver=boolean

JSON Syntax:

{
  "Payload": "string",
  "CaptureTime": float,
  "CaptureTimeAccuracy": float,
  "AssistPosition": [float, ...],
  "AssistAltitude": float,
  "Use2DSolver": true|false
}

--timestamp (timestamp)

Optional information that specifies the time when the position information will be resolved. It uses the Unix timestamp format. If not specified, the time at which the request was received will be used.

outfile (string) [required] Filename where the content will be saved

Global Options

--debug (boolean)

Turn on debug logging.

--endpoint-url (string)

Override command’s default URL with the given URL.

--no-verify-ssl (boolean)

By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.

--no-paginate (boolean)

Disable automatic pagination. If automatic pagination is disabled, the AWS CLI will only make one call, for the first page of results.

--output (string)

The formatting style for command output.

• json
• text
• table
• yaml
• yaml-stream

--query (string)

A JMESPath query to use in filtering the response data.

--profile (string)

Use a specific profile from your credential file.

--region (string)

The region to use. Overrides config/env settings.

--version (string)

Display the version of this tool.

--color (string)

Turn on/off color output.

• on
• off
• auto

--no-sign-request (boolean)

Do not sign requests. Credentials will not be loaded if this argument is provided.

--ca-bundle (string)

The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.

--cli-read-timeout (int)

The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.

--cli-connect-timeout (int)

The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.

--cli-binary-format (string)

The formatting style to be used for binary blobs. The default format is base64. The base64 format expects binary blobs to be provided as a base64 encoded string. The raw-in-base64-out format preserves compatibility with AWS CLI V1 behavior and binary values must be passed literally. When providing contents from a file that map to a binary blob fileb:// will always be treated as binary and use the file contents directly regardless of the cli-binary-format setting. When using file:// the file contents will need to properly formatted for the configured cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (boolean)

Disable cli pager for output.

--cli-auto-prompt (boolean)

Automatically prompt for CLI input parameters.

--no-cli-auto-prompt (boolean)

Disable automatically prompt for CLI input parameters.

Output

GeoJsonPayload -> (blob)

The position information of the resource, displayed as a JSON payload. The payload is of type blob and uses the GeoJSON format, which a format that’s used to encode geographic data structures. A sample payload contains the timestamp information, the WGS84 coordinates of the location, and the accuracy and confidence level. For more information and examples, see Resolve device location (console) .