Upload Point
Upload a single track point
Service Introduction
You can upload a single track point through this request.
Interface address
https://lbs.navinfo.com/open-api/geofence/v1/track/addpoint
Request method
GET/POST
The post request parameters should be transmitted in x-www-form-urlencoded mode
请求参数
If the user has customized the attribute field of the track in advance, you can select (not required) to add a custom field in the
request parameters and transfer the value.See the following table for the description of uploading a single track point:
| Parameter | Type | Meaning | Required | Default | Remarks |
|---|---|---|---|---|---|
|
ak |
string |
Developer Key |
Yes |
your ak |
|
|
service_id |
int |
The service ID returned when creating the service |
Yes |
||
|
terminal_name |
string |
Terminal name, which identifies the terminal to which the track point belongs |
Yes |
||
|
latitude |
string |
latitude(-90.0 ~ 90.0) |
Yes |
||
|
longitude |
string |
longitude(-180.0 ~ 180.0) |
Yes |
||
|
loc_time |
string |
current location time. |
Yes |
Note: returned in timestamp format，eg：1620626415000。 |
|
|
coord_type_input |
string |
Coordinate type |
No |
gcj02 |
wgs84: WGS84 coordinates |
|
speed |
string |
speed |
No |
Unit: km / h |
|
|
direction |
string |
direction |
No |
Value range: |
|
|
height |
string |
height |
No |
Unit: meter |
|
|
radius |
string |
Positioning accuracy, the value returned by GPS or positioning SDK. |
No |
Unit: meter |
|
|
object_name |
string |
Name of image file uploaded through track SDK |
No |
||
|
positioning_type |
string |
Track point positioning method. |
No |
1 |
|
Response data
| name | Type | Meaning | Remarks |
|---|---|---|---|
|
code |
int |
return status |
|
|
message |
string |
Return status description |
Service example
Upload multiple points
Service Introduction
Multiple track points can be uploaded through this request.
Interface address
https://lbs.navinfo.com/open-api/geofence/v1/track/addpoints
Request method
POST
The post request parameters should be transmitted in x-www-form-urlencoded mode
Request parameters
If the user has customized the attribute field of the track in advance, you can select (not required) to add a custom field in the
request parameters and transfer the value.See the following table for the description of uploading multiple track points:
| Parameter | Type | Meaning | Required | Default | Remarks | |
|---|---|---|---|---|---|---|
|
ak |
string |
Developer Key |
Yes |
your ak |
||
|
service_id |
int |
The service ID returned when creating the service |
Yes |
|||
|
point_list |
array |
points list |
Yes |
Note: the total number of points shall not exceed 100. |
||
|
terminal_name |
string |
Terminal name, which identifies the terminal to which the track point belongs |
Yes |
|||
|
latitude |
string |
latitude(-90.0 ~ 90.0) |
Yes |
|||
|
longitude |
string |
longitude(-180.0 ~ 180.0) |
Yes |
|||
|
loc_time |
string |
current location time. |
Yes |
Note: returned in timestamp format，eg：1620626415000。 |
||
|
coord_type_input |
string |
Coordinate type |
No |
gcj02 |
wgs84: WGS84 coordinates |
|
|
speed |
string |
speed |
No |
Unit: km / h |
||
|
direction |
string |
direction |
No |
Value range: |
||
|
height |
string |
height |
No |
Unit: meter |
||
|
radius |
string |
Positioning accuracy, the value returned by GPS or positioning SDK. |
No |
Unit: meter |
||
|
object_name |
string |
Name of image file uploaded through track SDK |
No |
|||
|
positioning_type |
string |
Track point positioning method. |
No |
1 |
|
|
Response data
| Return Value | Type | Meaning | Remarks | |
|---|---|---|---|---|
|
code |
int |
return status |
||
|
message |
string |
Return status description |
||
|
data |
object |
Return results |
||
|
success_num |
int |
Number of points uploaded successfully |
||
|
param_error |
array |
The point of upload failure caused by incorrect input parameters |
The format is the same as that of track point upload. Uploaded point_ List, the point where the parameter does not conform to the specification and the error information of the point (returned in the "error" field) |
|
|
internal_error |
array |
The point where the upload failed due to an internal server error |
The format is the same as that of track point upload |
|
Parameter demonstration