Terminal Management

Overview

Getting Started

Development Guide

Basic Service

Administrative Area Geo/Reverse Geocoding IP Positioning Map Capture

Suggest POI Search

Routing

Batch Calculations Automobile Routing Bus Routing Road matching

EV Travelling

EV Routing Charging Station Search

RTIC/Traffic Events

Road Fuzzy Search RTIC Broadcast RTIC Kanban Traffic Event Broadcast

Geofence

Service Management Terminal Management Custom Attribute Fields Upload Point Geofence Management Geofence Alarm

Tools

Status Code Comparison Table POI Type Table

Change Logs

The terminal management interface mainly realizes the create, update, detele and query

For example, add a vehicle, delete a vehicle, update the attribute information of the vehicle (such as the operation area to which the vehicle belongs), etc.

Create Terminal

Service Introduction

You can add a terminal device under the specified serivce ID through this request.

Interface address

https://lbs.navinfo.com/open-api/geofence/v1/track/terminal/add

Request method

GET/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 terminal in advance, you can select (not required) to add the customized

field in the request parameters and transfer the value. See the following table for the description of creating the terminal:

Parameter	Type	Meaning	Required	Remarks
ak	string	Developer Key	Yes
service_id	int	The service ID returned when creating the service	Yes
terminal_name	string	Terminal name as its unique identification	Yes	Note: terminal in the same service_ Name cannot be repeated; Once terminal is created_ Name is not updatable. Naming rules: only Chinese, English large and small letters, English underscore "_" English horizontal "-" and numbers. Note: a service can create up to 1 million terminals. When the upper limit is reached, no new terminals can be created.
terminal_desc	string	Readability description of terminal	No	Naming rules: only Chinese, English large and small letters, English underscore "_" English horizontal "-" and numbers.

Response data

Name	Type	Meaning	Remarks
code	int	Return status
message	string	Back to status description

Service example

Parameter	Type	Meaning	Required	Default	Remarks
ak	your ak	string	Developer Key	Yes	Click to apply
service_id		int	service id	Yes
terminal_name		string	Terminal name as its unique identification.	Yes	Note: terminal in the same service_ Name cannot be repeated; Once terminal is created_ Name is not updatable. Naming rules: only Chinese, English large and small letters, English underscore "_" English horizontal "-" and numbers. Note: a service can create up to 1 million terminals. When the upper limit is reached, no new terminals can be created.
terminal_desc		string	Readability description of terminal	No	Note: only Chinese, English large and small letters, English underline "_" English horizontal "-" and numbers.

Run

Delete Terminal

Service Introduction

You can delete the terminal under the specified service ID through this request.

Interface address

https://lbs.navinfo.com/open-api/geofence/v1/track/terminal/delete

Request method

GET/POST
The post request parameters should be transmitted in x-www-form-urlencoded mode

Request parameters

See the following table for the description of deleting the terminal:

Parameter	Type	Meaning	Required
ak	string	Developer Key	Yes
service_id	int	The service ID returned when creating the service	Yes
terminal_name	string	Terminal name as its unique identification	Yes

Response data

Name	Type	Meaning	Remarks
code	int	Return status
message	string	Back to status description

Service example

Parameter	Type	Meaning	Required	Default	Remarks
ak	your ak	string	Developer Key	Yes	Click to apply
service_id		int	service id	Yes
terminal_name		string	Terminal name as its unique identification.	Yes

Run

Update Terminal

Service Introduction

The information of the specified terminal can be updated through this request.

Interface address

https://lbs.navinfo.com/open-api/geofence/v1/track/terminal/update

Request method

GET/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 terminal in advance, you can select (not required) to add the customized

field in the request parameters and transfer the value. Please refer to the following table for modifying the service description:

Parameter	Type	Meaning	Required	Remarks
ak	string	Developer Key	Yes
service_id	int	The service ID returned when creating the service	Yes
terminal_name	string	The terminal name cannot be updated.	Yes
terminal_desc	string	终端的可读性描述，可更新	No	Rules: the same as creating terminals.

Response data

Name		Type	Meaning	Remarks
code		int	Return status
message		string	Back to status description
data		object	Returned results
	terminal_desc	string	Terminal description	Modified terminal description

Service example

Parameter	Type	Meaning	Required	Default	Remarks
ak	your ak	string	Developer Key	Yes	Click to apply
service_id		int	service id	Yes
terminal_name		string	The terminal name cannot be updated.	Yes
terminal_desc		string	The readability description of the terminal can be updated.	No	Rules: the same as creating terminals.

Run

Query Terminal

Service Introduction

You can query the terminal information under the corresponding service ID through this request.

Interface address

https://lbs.navinfo.com/open-api/geofence/v1/track/terminal/query

Request method

GET/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 terminal in advance, and the list value is "Y" (participate in retrieval), you can

select (not required) to add a custom field in the request parameter and transfer the value Please refer to the following table

for query service description:

Parameter	Type	Meaning	Required	Default	Remarks
ak	string	Developer Key	Yes
service_id	int	service id	Yes
terminal_name	string	Terminal name	No		Note: batch query is supported. Terminal names are separated by "," and up to 100 are passed in if this parameter is not passed in or a null value is passed in, all terminals under the current service will be queried by default.
active_time	int	Query the terminal with location information uploaded after this time	No		Note: active_ Time and inactive_ Time cannot be entered at the same time; active_ Time and inactive_ Time is passed in timestamp format For example: 1620626415.
inactive_time	int	Query the terminal that has no location information uploaded after this time	No
coord_type_output	string	Returns the coordinate type of the result	No	gcj02	wgs84: WGS84 coordinates gcj02: GCJ02 coordinates
page_index	int	Returns the number of page numbers. Value range: [1,5000].	No	1
page_size	int	Number of paper page. Value range: [1,1000].	No	1	100

Response data

Name				Type	Meaning	Remarks
code				int	Return status
message				string	Back to status description
data				object	Returned results
	total			int	Total results of this search	Represents the total number of results that meet the search criteria
	size			int	Number of results returned on this page	Represents how many qualified terminals are returned on this page
	terminal_list			Array	List of terminals obtained from this query
		terminal_name		string	Terminal name and its unique identification
		terminal_desc		string	Terminal readability description
		modify_time		string	Terminal attribute modification time	This time is the server time
		create_time		string	Terminal creation time	This time is the server time
		lastest_location		object	Latest track point information
			latitude	double	latitude	According to Coord_ type_ Output returns the corresponding coordinates
			longitude	double	longitude	According to Coord_ type_ Output returns the corresponding coordinates
			radius	double	positioning accuracy	Unit: meter
			loc_time	UNIX Timestamp	Terminal latest positioning time	The latest positioning time of the terminal (the time of the equipment at the time of positioning)
			direction	int	direction	The range is [0,359], 0 degrees is due north, clockwise
			speed	double	speed	Unit: km / h
			height	double	height	Unit: meter
			floor	string	floor	If it is in an area that supports indoor positioning, the floor information will be returned, which is null by default
			object_name	string	Object data name	If there is no value, this field is not returned

Service example

Parameter	Type	Meaning	Required	Default	Remarks
ak	your ak	string	Developer Key	Yes	Click to apply
service_id		int	service id	Yes
terminal_name		string	Terminal name.	No	Note: batch query is supported. Terminal names are separated by "," and up to 100 are passed in< Br / > if this parameter is not passed in or a null value is passed in, all terminals under the current service will be queried by default.
active_time		int	Query the terminal with location information uploaded after this time	No	Note: active_ Time and inactive_ Time cannot be entered at the same time; active_ Time and inactive_ Time is passed in in timestamp format. For example: 1620626415.
inactive_time		int	Query the terminal that has no location information uploaded after this time	No
coord_type_output		string	Returns the coordinate type of the result. wgs84: WGS84 coordinates. gcj02: GCJ02 coordinates	No	default:gcj02
page_index		int	Returns the number of page numbers. Value range: [1,5000].	No	default:1
page_size		int	Number of paper page. Value range: [1,1000].	No	default:100

Run