Location Solver und Geräte-Payload

Der folgende Code zeigt ein Beispiel für die JSON-Nutzlast des Geräts, das die Messungsdaten enthält. Wenn AWS IoT Core Device Location diese Daten als Eingabe empfängt, sendet es eine HTTP-Anfrage an den Solver-Anbieter, um die Standortinformationen aufzulösen. Geben Sie zum Abrufen der Informationen Werte für die MAC-Adresse und RSS (Received Signal Strength) an. Stellen Sie dazu entweder die JSON-Nutzlast in diesem Format bereit oder verwenden Sie den WiFiAccessPointsObjektparameter des GetPositionEstimateAPI-Vorgangs.

{
    "Timestamp": 1664313161,    // optional
    "WiFiAccessPoints": [ 
        {
            "MacAddress": "A0:EC:F9:1E:32:C1",  // required
            "Rss": -75                          // required
        }
    ]
}

Wenn Sie diese Messungsdaten verwenden, müssen Sie Informationen wie das Netzwerk und die Landesvorwahl des Mobilfunknetzes sowie optionale zusätzliche Parameter, einschließlich Informationen zur lokalen ID, angeben. Der nachfolgende Code zeigt ein Beispiel für das Nutzlastformat. Weitere Informationen zu diesen Parametern finden Sie unter LTE-Objekt.

{
    "Timestamp": 1664313161,           // optional 
    "CellTowers": {
        "Lte": [
        {
          "Mcc": int,                   // required
          "Mnc": int,                   // required
          "EutranCid": int,             // required. Make sure that you use int for EutranCid.
          "Tac": int,                   // optional
          "LteLocalId": {               // optional
              "Pci": int,               // required 
              "Earfcn": int,            // required 
          },
          "LteTimingAdvance": int,      // optional 
          "Rsrp": int,                  // optional 
          "Rsrq": float,                // optional 
          "NrCapable": boolean,         // optional 
          "LteNmr": [                   // optional
                {
                    "Pci": int,         // required 
                    "Earfcn": int,      // required 
                    "EutranCid": int,   // required
                    "Rsrp": int,        // optional 
                    "Rsrq": float       // optional 
                }
            ]
         }
      ] 
   }
}

Wenn Sie diese Messungsdaten verwenden, müssen Sie Informationen wie das Netzwerk und die Landesvorwahl des Mobilfunknetzes, Informationen zur Basisstation und optionale weitere Parameter angeben. Der nachfolgende Code zeigt ein Beispiel für das Nutzlastformat. Weitere Informationen zu diesen Parametern finden Sie unter GSM-Objekt.

{   
    "Timestamp": 1664313161,           // optional
    "CellTowers": {
        "Gsm": [ 
        {
          "Mcc": int,                   // required
          "Mnc": int,                   // required
          "Lac": int,                   // required
          "GeranCid": int,              // required
          "GsmLocalId": {               // optional
              "Bsic": int,              // required 
              "Bcch": int,              // required 
          },
          "GsmTimingAdvance": int,      // optional
          "RxLevel": int,               // optional
          "GsmNmr": [                   // optional
            {
                "Bsic": int,            // required
                "Bcch": int,            // required
                "RxLevel": int,         // optional
                "GlobalIdentity": {
                    "Lac": int,         // required
                    "GeranCid": int     // required
                }
             }
          ]
       }
    ]  
}

Wenn Sie diese Messungsdaten verwenden, müssen Sie Informationen wie die Signalleistung und Identifikationsinformationen, Informationen zur Basisstation und optionale weitere Parameter angeben. Der nachfolgende Code zeigt ein Beispiel für das Nutzlastformat. Weitere Informationen zu diesen Parametern finden Sie unter CDMA-Objekt.

{
    "Timestamp": 1664313161,               // optional
    "CellTowers": {
        "Cdma": [ 
        {
            "SystemId": int,                // required 
            "NetworkId": int,               // required 
            "BaseStationId": int,           // required 
            "RegistrationZone": int,        // optional 
            "CdmaLocalId": {                // optional
              "PnOffset": int,              // required 
              "CdmaChannel": int,           // required 
            },
            "PilotPower": int,              // optional 
            "BaseLat": float,               // optional 
            "BaseLng": float,               // optional 
            "CdmaNmr": [                    // optional 
                {
                    "PnOffset": int,        // required 
                    "CdmaChannel": int,     // required 
                    "PilotPower": int,      // optional 
                    "BaseStationId": int    // optional 
                }
             ]
          }
       ]
    }
}

Wenn Sie diese Messungsdaten verwenden, müssen Sie Informationen wie das Netzwerk und die Landesvorwahl, die Signalleistung und Identifikationsinformationen, Informationen zur Basisstation und optionale weitere Parameter angeben. Der nachfolgende Code zeigt ein Beispiel für das Nutzlastformat. Weitere Informationen zu diesen Parametern finden Sie unter CDMA-Objekt.

{
    "Timestamp": 1664313161,           // optional
    "CellTowers": {
        "Wcdma": [ 
        {
          "Mcc": int,                   // required
          "Mnc": int,                   // required 
          "UtranCid": int,              // required 
          "Lac": int,                   // optional 
          "WcdmaLocalId": {             // optional
              "Uarfcndl": int,          // required
              "Psc": int,               // required 
          },
          "Rscp": int,                  // optional
          "Pathloss": int,              // optional 
          "WcdmaNmr": [                 // optional 
                {
                  "Uarfcndl": int,      // required 
                  "Psc": int,           // required 
                  "UtranCid": int,      // required
                  "Rscp": int,          // optional 
                  "Pathloss": int,      // optional 
                }
             ]
          }
       ]
    }
}    

Wenn Sie diese Messungsdaten verwenden, müssen Sie Informationen wie das Netzwerk und die Landesvorwahl, die Signalleistung und Identifikationsinformationen, Informationen zur Basisstation und optionale weitere Parameter angeben. Der nachfolgende Code zeigt ein Beispiel für das Nutzlastformat. Weitere Informationen zu diesen Parametern finden Sie unter CDMA-Objekt.

{
    "Timestamp": 1664313161,           // optional
    "CellTowers": {
        "Tdscdma": [ 
        {
          "Mcc": int,                   // required
          "Mnc": int,                   // required
          "UtranCid": int,              // required
          "Lac": int,                   // optional
          "TdscdmaLocalId": {           // optional
              "Uarfcn": int,            // required 
              "CellParams": int,        // required 
          },
          "TdscdmaTimingAdvance": int,  // optional
          "Rscp": int,                  // optional
          "Pathloss": int,              // optional
          "TdscdmaNmr": [               // optional 
                {
                  "Uarfcn": int,        // required 
                  "CellParams": int,    // required 
                  "UtranCid": int,      // optional
                  "Rscp": int,          // optional
                  "Pathloss": int,      // optional 
                }
             ]
         }
      ]
   }
}

Der folgende Code zeigt ein Beispiel für die JSON-Nutzlast des Geräts, das die Messungsdaten enthält. Wenn AWS IoT Core Device Location die in den Messdaten enthaltenen IP-Adressinformationen empfängt, sucht es nach diesen Informationen in der Datenbank des Solver-Anbieters, die dann zur Auflösung der Standortinformationen verwendet wird. Um die Informationen abzurufen, geben Sie entweder die JSON-Payload in diesem Format an oder geben Sie Werte für den IP-Parameter des GetPositionEstimateAPI-Vorgangs an.

{
    "Timestamp": 1664313161,
    "Ip":{
        "IpAddress":"54.240.198.35"
      }
}

Der folgende Code zeigt ein Beispiel für die JSON-Nutzlast des Geräts, das die Messungsdaten enthält. Wenn AWS IoT Core Device Location die GNSS-Scaninformationen empfängt, die die Nutzlast in den Messdaten enthalten, verwendet es die Transceiver und alle zusätzlichen enthaltenen Hilfsinformationen, um nach Signalen zu suchen und die Standortinformationen aufzulösen. Um die Informationen abzurufen, geben Sie entweder die JSON-Nutzdaten in diesem Format an oder geben Sie Werte für den GNSS-Parameter der API-Operation an. GetPositionEstimate

{   
    "Timestamp": 1664313161,                  // optional
    "Gnss": { 
        "AssistAltitude": number,             // optional
        "AssistPosition": [ number ],         // optional
        "CaptureTime": number,                // optional
        "CaptureTimeAccuracy": number,        // optional
        "Payload": "string",                  // required
        "Use2DSolver": boolean                // optional
   }
}