Request WGS-84 compliant geocoordinates for a location based on 2G/3G/4G cell and/or WLAN measurements.
643 matches
Other/HERE Network Positioning API v2
Location query
v1.0.0Input
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
- 73
- 74
- 75
- 76
- 77
- 78
- 79
- 80
- 81
- 82
- 83
- 84
- 85
- 86
- 87
- 88
- 89
- 90
- 91
- 92
- 93
- 94
- 95
- 96
- 97
- 98
- 99
- 100
- 101
- 102
- 103
- 104
- 105
- 106
- 107
- 108
- 109
- 110
- 111
- 112
- 113
- 114
- 115
- 116
- 117
- 118
- 119
- 120
- 121
- 122
- 123
- 124
- 125
- 126
- 127
- 128
- 129
- 130
- 131
- 132
- 133
- 134
- 135
- 136
- 137
- 138
- 139
- 140
- 141
- 142
- 143
- 144
- 145
- 146
- 147
- 148
- 149
- 150
- 151
- 152
- 153
- 154
- 155
- 156
- 157
- 158
- 159
- 160
- 161
- 162
- 163
- 164
- 165
- 166
- 167
- 168
- 169
- 170
- 171
- 172
- 173
- 174
- 175
- 176
- 177
- 178
- 179
- 180
- 181
- 182
- 183
- 184
- 185
- 186
- 187
- 188
- 189
- 190
- 191
- 192
- 193
- 194
- 195
- 196
- 197
- 198
- 199
- 200
- 201
- 202
- 203
- 204
- 205
- 206
- 207
- 208
- 209
- 210
- 211
- 212
- 213
- 214
- 215
- 216
- 217
- 218
- 219
- 220
- 221
- 222
- 223
- 224
- 225
- 226
- 227
- 228
- 229
- 230
- 231
- 232
- 233
- 234
- 235
- 236
- 237
- 238
- 239
- 240
- 241
- 242
- 243
- 244
- 245
- 246
- 247
- 248
- 249
- 250
- 251
- 252
- 253
- 254
- 255
- 256
- 257
- 258
- 259
- 260
- 261
- 262
- 263
- 264
- 265
- 266
- 267
- 268
- 269
- 270
- 271
- 272
- 273
- 274
- 275
- 276
- 277
- 278
- 279
- 280
- 281
- 282
- 283
- 284
- 285
- 286
- 287
- 288
- 289
- 290
- 291
- 292
- 293
- 294
- 295
- 296
- 297
- 298
- 299
- 300
- 301
- 302
- 303
- 304
- 305
- 306
- 307
- 308
- 309
- 310
- 311
- 312
- 313
- 314
- 315
- 316
- 317
- 318
- 319
- 320
- 321
- 322
- 323
- 324
- 325
- 326
- 327
- 328
- 329
- 330
- 331
- 332
- 333
- 334
- 335
- 336
- 337
- 338
- 339
- 340
- 341
- 342
- 343
- 344
- 345
- 346
- 347
- 348
- 349
- 350
- 351
- 352
- 353
- 354
- 355
- 356
- 357
- 358
- 359
- 360
- 361
- 362
- 363
- 364
- 365
- 366
- 367
- 368
- 369
- 370
- 371
- 372
- 373
- 374
- 375
- 376
- 377
- 378
- 379
- 380
- 381
- 382
- 383
- 384
- 385
- 386
- 387
- 388
- 389
- 390
- 391
- 392
- 393
- 394
- 395
- 396
- 397
- 398
- 399
- 400
- 401
- 402
- 403
- 404
- 405
- 406
- 407
- 408
- 409
- 410
- 411
- 412
- 413
- 414
- 415
- 416
- 417
- 418
- 419
- 420
- 421
- 422
- 423
- 424
- 425
- 426
- 427
- 428
- 429
- 430
- 431
- 432
- 433
- 434
- 435
- 436
- 437
- 438
- 439
- 440
- 441
- 442
- 443
- 444
- 445
- 446
- 447
- 448
- 449
- 450
- 451
- 452
- 453
- 454
- 455
- 456
- 457
- 458
- 459
- 460
- 461
- 462
- 463
- 464
- 465
- 466
- 467
- 468
- 469
- 470
- 471
- 472
- 473
- 474
- 475
- 476
- 477
- 478
- 479
- 480
- 481
- 482
- 483
- 484
- 485
- 486
- 487
- 488
- 489
- 490
- 491
- 492
- 493
- 494
- 495
- 496
- 497
- 498
- 499
- 500
- 501
- 502
- 503
- 504
- 505
- 506
- 507
- 508
- 509
- 510
- 511
- 512
- 513
- 514
- 515
- 516
- 517
- 518
- 519
- 520
- 521
- 522
- 523
- 524
- 525
- 526
- 527
- 528
- 529
- 530
- 531
- 532
- 533
- 534
- 535
- 536
- 537
- 538
- 539
- 540
- 541
- 542
- 543
- 544
- 545
- 546
- 547
- 548
- 549
- 550
- 551
- 552
- 553
- 554
- 555
- 556
- 557
- 558
- 559
- 560
- 561
- 562
- 563
- 564
- 565
- 566
- 567
- 568
- 569
- 570
- 571
- 572
- 573
- 574
- 575
- 576
- 577
- 578
- 579
- 580
- 581
- 582
- 583
- 584
- 585
- 586
- 587
- 588
- 589
- 590
- 591
- 592
- 593
- 594
- 595
- 596
{
"type": "object",
"properties": {
"Content-Encoding": {
"type": "string",
"enum": [
"gzip"
]
},
"X-Request-ID": {
"type": "string"
},
"cdma": {
"type": "array",
"description": "CDMA cells (CDMA2000)",
"items": {
"type": "object",
"description": "CDMA measurement",
"required": [
"sid",
"nid",
"bsid"
],
"properties": {
"baseLat": {
"type": "number",
"description": "Base station latitude"
},
"baseLng": {
"type": "number",
"description": "Base station longitude"
},
"bsid": {
"type": "integer",
"description": "Base Station ID (CDMA BSID, BID)"
},
"localId": {
"type": "object",
"description": "Local identification parameters of CDMA serving cell",
"required": [
"pnOffset",
"channel"
],
"properties": {
"channel": {
"type": "integer",
"description": "CDMA channel frequency"
},
"pnOffset": {
"type": "integer",
"description": "Pseudonoise offset. This field and CDMA channel frequency together allow for the locally unique identification of the cell.\n"
}
},
"additionalProperties": false
},
"nid": {
"type": "integer",
"description": "Network ID (NID)"
},
"nmr": {
"type": "array",
"description": "CDMA Network measurements",
"items": {
"type": "object",
"description": "CDMA Network measurement",
"required": [
"pnOffset",
"channel"
],
"properties": {
"bsid": {
"type": "integer",
"description": "Base Station ID (CDMA BSID, BID)"
},
"channel": {
"type": "integer",
"description": "CDMA channel frequency"
},
"pilotPower": {
"type": "integer",
"description": "Pilot Power (dBm). If Pilot Power is not available directly, it needs to be calculated from Total Power in the band and Pilot Strength with respect to the Total Power. Pilot power less than -142dBm should be mapped to -142. Pilot power greater than -49dBm should be mapped to -49.\n"
},
"pnOffset": {
"type": "integer",
"description": "Pseudonoise offset. This field and CDMA channel frequency together allow for the locally unique identification of the cell.\n"
}
},
"additionalProperties": false
}
},
"pilotPower": {
"type": "integer",
"description": "Pilot Power (dBm). If Pilot Power is not available directly, it needs to be calculated from Total Power in the band and Pilot Strength with respect to the Total Power. Pilot power less than -142dBm should be mapped to -142. Pilot power greater than -49dBm should be mapped to -49.\n"
},
"rz": {
"type": "integer",
"description": "CDMA Registration Zone (RZ)"
},
"sid": {
"type": "integer",
"description": "System ID (SID)"
}
},
"additionalProperties": false
}
},
"client": {
"type": "object",
"description": "Information about the client",
"required": [
"manufacturer",
"model",
"name",
"version"
],
"properties": {
"firmware": {
"type": "string",
"description": "Device firmware version information"
},
"manufacturer": {
"type": "string",
"description": "Manufacturer of the device (hardware)"
},
"model": {
"type": "string",
"description": "Model of the device (hardware)"
},
"name": {
"type": "string",
"description": "Name of the client software accessing the HERE API"
},
"platform": {
"type": "string",
"description": "Software platform information of the device, for example operating system name and version."
},
"version": {
"type": "string",
"format": "version",
"description": "Version of the client software in format X.Y.Z, where X [0..255] is a major, Y [0..255] is a minor, and Z [0..65535] is a build version number. Increase the version/build number for each release of the client."
}
},
"additionalProperties": false
},
"confidence": {
"type": "integer"
},
"desired": {
"type": "array",
"items": {
"type": "string",
"enum": [
"altitude"
]
}
},
"fallback": {
"type": "array",
"items": {
"type": "string",
"enum": [
"any",
"area",
"singleWifi"
]
}
},
"gsm": {
"type": "array",
"description": "GSM cells (GERAN)",
"items": {
"type": "object",
"description": "GSM measurement",
"required": [
"mcc",
"mnc",
"lac",
"cid"
],
"properties": {
"cid": {
"type": "integer",
"description": "Cell identifier (GERAN CID)"
},
"lac": {
"type": "integer",
"description": "Location Area Code (LAC). Note, value 65534 is invalid."
},
"localId": {
"type": "object",
"description": "Local identification parameters of GSM serving cell",
"required": [
"bsic",
"bcch"
],
"properties": {
"bcch": {
"type": "integer",
"description": "Broadcast Control Channel (BCCH, synonymous to ARFCN = Absolute Radio Frequency Channel)"
},
"bsic": {
"type": "integer",
"description": "Base Station Identity Code (BSIC, for instance, color code)"
}
},
"additionalProperties": false
},
"mcc": {
"type": "integer",
"description": "Mobile Country Code (MCC). Note: 0xx is for test networks, 1xx and 8xx are not used\n"
},
"mnc": {
"type": "integer",
"description": "Mobile Network Code (MNC)."
},
"nmr": {
"type": "array",
"description": "GSM Network measurements",
"items": {
"type": "object",
"description": "GSM Network measurements.\n",
"required": [
"bsic",
"bcch"
],
"properties": {
"bcch": {
"type": "integer",
"description": "Broadcast Control Channel (BCCH, synonymous to ARFCN = Absolute Radio Frequency Channel)"
},
"bsic": {
"type": "integer",
"description": "Base Station Identity Code (BSIC, for instance, color code)"
},
"globalIdentity": {
"description": "The `lac` and `cid` parameters of global ID for GSM neighbor measurement. They should be from the same PLMN (MCC+MNC) as the serving cell.\n",
"required": [
"lac",
"cid"
],
"properties": {
"cid": {
"type": "integer",
"description": "Cell identifier (GERAN CID)"
},
"lac": {
"type": "integer",
"description": "Location Area Code (LAC). Note, value 65534 is invalid."
}
},
"additionalProperties": false
},
"rxLevel": {
"type": "integer",
"description": "Received Signal power (dBm). Power less than -110dBm should be mapped to -110. Power greater than -25dBm should be mapped to -25.\n"
}
},
"additionalProperties": false
}
},
"rxLevel": {
"type": "integer",
"description": "Received Signal power (dBm). Power less than -110dBm should be mapped to -110. Power greater than -25dBm should be mapped to -25.\n"
},
"ta": {
"type": "integer",
"description": "Timing advance (TA). Expressed in the units of GSM bits equaling to 48/13 μs ~ 1107 meters."
}
},
"additionalProperties": false
}
},
"lte": {
"type": "array",
"description": "LTE cells (E-UTRA, 4G)",
"items": {
"description": "LTE measurement",
"required": [
"mcc",
"mnc",
"cid"
],
"properties": {
"cid": {
"type": "integer",
"description": "E-UTRA Cell Identifier (UC-Id), 28 bits (20 bits eNodeB and 8 bits Cell ID). MCC + MNC + CID uniquely identifies the LTE cell, TAC is optional.\n"
},
"localId": {
"type": "object",
"description": "Local identification parameters of LTE serving cell",
"required": [
"pci",
"earfcn"
],
"properties": {
"earfcn": {
"type": "integer",
"description": "Evolved Absolute Radio Frequency Channel (E-ARFCN)"
},
"pci": {
"type": "integer",
"description": "Physical Cell Identity (PCI)"
}
},
"additionalProperties": false
},
"mcc": {
"type": "integer",
"description": "Mobile Country Code (MCC). Note: 0xx is for test networks, 1xx and 8xx are not used\n"
},
"mnc": {
"type": "integer",
"description": "Mobile Network Code (MNC)."
},
"nmr": {
"type": "array",
"description": "LTE Network measurements",
"items": {
"type": "object",
"description": "LTE Network measurement",
"required": [
"pci",
"earfcn"
],
"properties": {
"cid": {
"type": "integer",
"description": "E-UTRA Cell Identifier (UC-Id), 28 bits (20 bits eNodeB and 8 bits Cell ID). MCC + MNC + CID uniquely identifies the LTE cell, TAC is optional.\n"
},
"earfcn": {
"type": "integer",
"description": "Evolved Absolute Radio Frequency Channel (E-ARFCN)"
},
"pci": {
"type": "integer",
"description": "Physical Cell Identity (PCI)"
},
"rsrp": {
"type": "integer",
"description": "Reference Signal Received Power (RSRP) in dBm. Power less than -140dBm should be mapped to -140. Power greater than -44dBm should be mapped to -44.\n"
},
"rsrq": {
"type": "number",
"description": "Reference Signal Received Quality (RSRQ) in dBm. Values less than -19.5dB should be mapped to -19.5, and values greater than -3dB should be mapped to -3dB.\n"
}
},
"additionalProperties": false
}
},
"rsrp": {
"type": "integer",
"description": "Reference Signal Received Power (RSRP) in dBm. Power less than -140dBm should be mapped to -140. Power greater than -44dBm should be mapped to -44.\n"
},
"rsrq": {
"type": "number",
"description": "Reference Signal Received Quality (RSRQ) in dBm. Values less than -19.5dB should be mapped to -19.5, and values greater than -3dB should be mapped to -3dB.\n"
},
"ta": {
"type": "integer",
"description": "Timing Advance. Expressed in the units of 16*Ts (16 Basic time units) = 16/(15000*2048) seconds ~ 156meters. For reference see 3GPP TS 36.213 and 36.211.\n"
},
"tac": {
"type": "integer",
"description": "Tracking Area Code (TAC)"
}
},
"additionalProperties": false
}
},
"required": {
"type": "array",
"items": {
"type": "string",
"enum": [
"altitude"
]
}
},
"tdscdma": {
"type": "array",
"description": "TD-SCDMA cells (UTRA-TDD, 3G UMTS TDD)",
"items": {
"type": "object",
"description": "TD-SCDMA measurement.",
"required": [
"mcc",
"mnc",
"cid"
],
"properties": {
"cid": {
"type": "integer",
"description": "UTRAN Cell Identifier (UC-Id), 28 bits (12 bits RNC and 16 bits Cell ID). MCC + MNC + CID uniquely identifies the WCDMA cell, LAC is optional.\n"
},
"lac": {
"type": "integer",
"description": "Location Area Code (LAC). Note, value 65534 is invalid."
},
"localId": {
"type": "object",
"description": "Local identification parameters of TD-SCDMA serving cell",
"required": [
"uarfcn",
"cellParams"
],
"properties": {
"cellParams": {
"type": "integer",
"description": "Cell Parameters ID (CDMA Spreading Code ID)"
},
"uarfcn": {
"type": "integer",
"description": "UTRAN Absolute Radio Frequency (U-ARFCN)"
}
},
"additionalProperties": false
},
"mcc": {
"type": "integer",
"description": "Mobile Country Code (MCC). Note: 0xx is for test networks, 1xx and 8xx are not used\n"
},
"mnc": {
"type": "integer",
"description": "Mobile Network Code (MNC)."
},
"nmr": {
"type": "array",
"description": "TD-SCDMA Network measurements. Maximum of 8 distinct uarfcn frequencies.",
"items": {
"type": "object",
"description": "TD-SCDMA Network measurement",
"required": [
"uarfcn",
"cellParams"
],
"properties": {
"cellParams": {
"type": "integer",
"description": "Cell Parameters ID (CDMA Spreading Code ID)"
},
"cid": {
"type": "integer",
"description": "UTRAN Cell Identifier (UC-Id), 28 bits (12 bits RNC and 16 bits Cell ID). MCC + MNC + CID uniquely identifies the WCDMA cell, LAC is optional.\n"
},
"pathloss": {
"type": "integer",
"description": "UTRAN pathloss (dBm)"
},
"rscp": {
"type": "integer",
"description": "Received Signal Code Power (RSCP) in dBm. Power less than -120dBm should be mapped to -120. Power greater than -25dBm should be mapped to -25.\n"
},
"uarfcn": {
"type": "integer",
"description": "UTRAN Absolute Radio Frequency (U-ARFCN)"
}
},
"additionalProperties": false
}
},
"pathloss": {
"type": "integer",
"description": "UTRAN pathloss (dBm)"
},
"rscp": {
"type": "integer",
"description": "Received Signal Code Power (RSCP) in dBm. Power less than -120dBm should be mapped to -120. Power greater than -25dBm should be mapped to -25.\n"
},
"ta": {
"type": "integer",
"description": "Timing advance (TA). Round-Trip distance presented in the units of 4*c/7.68e6 ~156 meters. That is, the scaling factor is 4 times the chip length at chip rate of 7.68 Mchips/s. Note that at chip rates 1.28 Mchips/s and 3.84 Mchips/s you need to scale according to chip length of 7.68 Mchips/s, that is, multiply by 6 or 2 if needed.\n"
}
},
"additionalProperties": false
}
},
"wcdma": {
"type": "array",
"description": "WCDMA cells (UTRA-FDD, 3G UMTS)",
"items": {
"type": "object",
"description": "WCDMA measurement",
"required": [
"mcc",
"mnc",
"cid"
],
"properties": {
"cid": {
"type": "integer",
"description": "UTRAN Cell Identifier (UC-Id), 28 bits (12 bits RNC and 16 bits Cell ID). MCC + MNC + CID uniquely identifies the WCDMA cell, LAC is optional.\n"
},
"lac": {
"type": "integer",
"description": "Location Area Code (LAC). Note, value 65534 is invalid."
},
"localId": {
"type": "object",
"description": "Local identification parameters of WCDMA serving cell",
"required": [
"uarfcndl",
"psc"
],
"properties": {
"psc": {
"type": "integer",
"description": "Primary Scrambling Code (PSC, Primary CPICH, Primary Control Pilot Channel)."
},
"uarfcndl": {
"type": "integer",
"description": "UTRAN Absolute Radio Frequency Downlink (UARFCN-DL)"
}
},
"additionalProperties": false
},
"mcc": {
"type": "integer",
"description": "Mobile Country Code (MCC). Note: 0xx is for test networks, 1xx and 8xx are not used\n"
},
"mnc": {
"type": "integer",
"description": "Mobile Network Code (MNC)."
},
"nmr": {
"type": "array",
"description": "WCDMA Network measurements. Maximum of 8 distinct uarfcndl frequencies.",
"items": {
"type": "object",
"description": "WCDMA Network measurement",
"required": [
"uarfcndl",
"psc"
],
"properties": {
"cid": {
"type": "integer",
"description": "UTRAN Cell Identifier (UC-Id), 28 bits (12 bits RNC and 16 bits Cell ID). MCC + MNC + CID uniquely identifies the WCDMA cell, LAC is optional.\n"
},
"pathloss": {
"type": "integer",
"description": "UTRAN pathloss (dBm)"
},
"psc": {
"type": "integer",
"description": "Primary Scrambling Code (PSC, Primary CPICH, Primary Control Pilot Channel)."
},
"rscp": {
"type": "integer",
"description": "Received Signal Code Power (RSCP) in dBm. Power less than -120dBm should be mapped to -120. Power greater than -25dBm should be mapped to -25.\n"
},
"uarfcndl": {
"type": "integer",
"description": "UTRAN Absolute Radio Frequency Downlink (UARFCN-DL)"
}
},
"additionalProperties": false
}
},
"pathloss": {
"type": "integer",
"description": "UTRAN pathloss (dBm)"
},
"rscp": {
"type": "integer",
"description": "Received Signal Code Power (RSCP) in dBm. Power less than -120dBm should be mapped to -120. Power greater than -25dBm should be mapped to -25.\n"
}
},
"additionalProperties": false
}
},
"wlan": {
"type": "array",
"description": "WLAN access positions. For privacy reasons positioning based on a single WLAN AP is not possible; there has to be at least one other matching wlan or cell. Alternatively, you can allow fallbacks to less accurate single WLAN AP location estimates by using the setting `fallback=singleWifi`.\n",
"items": {
"type": "object",
"description": "WLAN measurement",
"required": [
"mac"
],
"properties": {
"mac": {
"type": "string",
"format": "regex",
"description": "The MAC address of the WLAN access point. MAC-48 address with colon (:) or hyphen (-) separators, upper or lower case hex digits. Note that if the SSID contains postfix \"_nomap\", the AP should not be used for positioning.\n"
},
"rss": {
"type": "integer",
"description": "Received signal level (dBm) at the terminal"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}Output
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
{
"type": "object",
"description": "Object wrapper for the response to a location request.",
"required": [
"location"
],
"properties": {
"location": {
"type": "object",
"description": "Object containing information on a location where a measurement was taken.",
"required": [
"accuracy",
"lat",
"lng"
],
"properties": {
"accuracy": {
"type": "number",
"description": "Uncertainty circle radius in meters (degree of confidence according to the `confidence` parameter)."
},
"alt": {
"type": "number",
"description": "Altitude in meters (referenced to the WGS-84 ellipsoid) negative or positive."
},
"altAccuracy": {
"type": "number",
"description": "Uncertainty of the altitude estimate in meters (degree of confidence according to the `confidence` parameter). This field superceeds old `altaccuracy`.\n"
},
"lat": {
"type": "number",
"description": "Latitude in WGS-84 format, decimal representation ranging from -90 to 90."
},
"lng": {
"type": "number",
"description": "Longitude in WGS-84 format, decimal representation ranging from -180 to 180."
}
}
}
}
}