SIM900_GSM Location AT Command

Manual_V2.00

Document Title:

SIM900 GSM Location AT Command Manual

Version:

1.00

Date:

2012-07-18

Status:

New

Document Control ID:

SIM900_GSM Location AT Command Manual_V2.00

General Notes
SIMCom offers this information as a service to its customers, to support application and
engineering efforts that use the products designed by SIMCom. The information provided is based
upon requirements specifically provided to SIMCom by the customers. SIMCom has not
undertaken any independent search for additional relevant information, including any information
that may be in the customers possession. Furthermore, system validation of this product designed
by SIMCom within a larger electronic system remains the responsibility of the customer or the
customers system integrator. All specifications supplied herein are subject to change.
Copyright
This document contains proprietary technical information which is the property of SIMCom
Limited., copying of this document and giving it to others and the using or communication of the
contents thereof, are forbidden without express authority. Offenders are liable to the payment of
damages. All rights reserved in the event of grant of a patent or the registration of a utility model
or design. All specification supplied herein are subject to change without notice at any time.
Copyright Shanghai SIMCom Wireless Solutions Ltd. 2012

SIM900 GSM Location AT Command Manual

Version History
Version

Chapter

V1.00

Origin

V2.00

Enhancement

What is new
Can get the detailed location information includ latitudelongitude
countrycountry_coderegioncitystreetstreet_number

SIM900_GSM Location AT Command Manual_V1.00

8/3/2012
2

SIM900 GSM Location AT Command Manual

Introduction

This document presents the AT command of GSM location operation for SIM900. This document
can apply to the same series of the modules which contain GSM location function, like SIM900,
SIM900D, SIM900B and SIM900A.

1.1 Features
1.2 Reference
[1] SIM900 AT Commands Set

SIM900_GSM Location AT Command Manual_V1.00

8/3/2012
3

SIM900 GSM Location AT Command Manual

2 AT commands

2.1 AT+CIPGSMLOC
AT+CIPGSMLOC
Test Command

GSM Location and Time

Response

AT+CIPGSMLOC= +CIPGSMLOC: (1,2),(1-3),(0-3)

?
OK
Parameter
See Write Command
Write Command
AT+CIPGSMLOC=
<type>,<cid>,<cha
rset>,<AddressLan
guageTag>

Response
If <type>=1 and not set <charset>:
+CIPGSMLOC:<locationcode>,<longitude>,<latitude>,<date>,<tim
e>
OK
If <type>=2 and not set <charset>:
+CIPGSMLOC:<locationcode>,<date>,<time>
OK
If set value for <chatset> , the <type> will be ingored . The
parameter <charset> only be supported in china currently .
If <charset>=3
Return the following information in GBK format .
<date>,<time>,<latitude>,<longitude>,<country>,<country_code>,
<region>,<city>,<street>,<street_number>
OK
If<charset>=0
Return the same information as the string when <charset>=3 , but in
hex format and code in UNICODE BIG END
If<charset>=1
Return the same information as the string when <charset>=3 , but in
hex format and code in UNICODE LITTLE END

SIM900_GSM Location AT Command Manual_V1.00

8/3/2012
4

SIM900 GSM Location AT Command Manual

If<charset>=2
Return the same information as the string when <charset>=3 , but in
hex format and code in UTF-8
If <AddressLanguageTag> = en_GB
The address information will be displayed in English
If error is related to ME functionality:
+CME ERROR:<err>
Parameter
<type>

1 View the longitude, latitude and time

2 View time
<cid>
network parameters, refer to AT+SAPBR
<charset>
0 code in UNICODE BIG END
1 code in UNICODE LITTLE END
2 code in UTF-8
3 code in GBK
<AddressLanguageTag>
"zh_CN" chinese China
"zh_TW" chinese Taiwan
"da_DK" Danish Denmark
"DE_AT" Austria
"DE_CH" Switzerland
"DE_DE" Germany
"el_GR" Greece
"en_CA" English Canada
"en_GB" English United Kingdom
"en_IE" English Ireland
"en_US" English America
"es_ES" Spain language
"fi_FI" Finish Filand
"fr_BE" French Belgium
"fr_CA" French Canada
"fr_CH" French Switzerland
"fr_FR" French France
"it_CH" Italian Switzerland
"it_IT" Italian Italy
"ja_JP" Japanese Japan
"ko_KR" Korean Korea
"nl_BE" Nederlands Belgium
"nl_NL" Nederlands Nederlands
"no_NO" Norwegian Nynorsk
SIM900_GSM Location AT Command Manual_V1.00

8/3/2012
5

SIM900 GSM Location AT Command Manual

"no_NO_B" Norwegian Bokm?l

"pt_PT" Portuguese Portugal
"sv_SE" Swedish Seden
"tr_TR" turkey
<locationcode> 0 Success
If the operation failed, the location code is not 0, such as:
601 Network Error
602 No memory
603 DNS Error
604 Stack Busy
65535 Other Error
<longitude>
Current longitude in degrees
<latitude>
Current latitude in degrees
<date>
Format is YYYY/MM/DD, the time zone is GMT E.g.
2011/01/26
<time>
Format is hh/mm/ss,the time zone is GMT.E.g. 06:10:46
<country>
The name of the country .E.g. "country":""
<country_code> Country code .E.g. "country_code":"CN"
<region>
The name of provience . E.g. "region":""
<city>
The name of the city. E.g. "city":""
<street>
The name of the street E.g. "street":""
<street_number>The street number E.g. "street_number":"1025
"
Reference

Note

SIM900_GSM Location AT Command Manual_V1.00

8/3/2012
6

SIM900 GSM Location AT Command Manual

Examples

SIM900 GSM location module provides GSM location solution. The following is the
examples for application.
3.1 Activate bearer profile
AT+SAPBR=3,1,"Contype","GPRS"

//Set bearer parameter

OK
AT+SAPBR=3,1,"APN","CMNET"
OK
AT+SAPBR =1,1

// Activate bearer context

OK
AT+SAPBR=2,1
+SAPBR: 1,1,"10.89.193.1"
OK
3.2 Get location
AT+CIPGSMLOC=1,1
+CIPGSMLOC: 0,121.354326,31.222113,2012/07/20,05:43:34
OK
AT+CIPGSMLOC=2,1
+CIPGSMLOC: 0,2012/07/20,05:43:39
OK
AT+CIPGSMLOC=1,1,0
+CIPGSMLOC:
"GMT:2012/07/20,05:43:53",0022006C00610074006900740075006400650022003A0033003100
2E0032003200320031003100330037002C0022006C006F006E006700690074007500640065002
2003A003100320031002E0033003500340033003200360036002C00220063006F0075006E0074
007200790022003A0022004300680069006E00610022002C00220063006F0075006E007400720
079005F0063006F006400650022003A00220043004E0022002C00220072006500670069006F00
6E0022003A0022005300680061006E00670068006100690022002C00220063006900740079002
SIM900_GSM Location AT Command Manual_V1.00

8/3/2012
7

SIM900 GSM Location AT Command Manual

2003A0022005300680061006E00670068006100690022002C00220073007400720065006500740
022003A0022005800690065006800650020005200640022002C002200730074007200650065007
4005F006E0075006D0062006500720022003A0022003100300032003553F70022
OK
AT+CIPGSMLOC=1,1,1
+CIPGSMLOC:
"GMT:2012/07/20,05:44:01",22006C00610074006900740075006400650022003A00330031002E
0032003200320031003100330037002C0022006C006F006E006700690074007500640065002200
3A003100320031002E0033003500340033003200360036002C00220063006F0075006E0074007
200790022003A0022004300680069006E00610022002C00220063006F0075006E007400720079
005F0063006F006400650022003A00220043004E0022002C00220072006500670069006F006E0
022003A0022005300680061006E00670068006100690022002C002200630069007400790022003
A0022005300680061006E00670068006100690022002C002200730074007200650065007400220
03A0022005800690065006800650020005200640022002C0022007300740072006500650074005
F006E0075006D0062006500720022003A0022003100300032003500F7532200
OK
AT+CIPGSMLOC=1,1,2
+CIPGSMLOC:
"GMT:2012/07/20,05:44:09",226C61746974756465223A33312E323232313133372C226C6F6E6
76974756465223A3132312E333534333236362C22636F756E747279223A224368696E61222C2
2636F756E7472795F636F6465223A22434E222C22726567696F6E223A225368616E676861692
22C2263697479223A225368616E67686169222C22737472656574223A22586965686520526422
2C227374726565745F6E756D626572223A2231303235E58FB722
OK
AT+CIPGSMLOC=1,1,3
+CIPGSMLOC:
"GMT:2012/07/20,05:44:20","latitude":31.2221137,"longitude":121.3543266,"country":"China","
country_code":"CN","region":"Shanghai","city":"Shanghai","street":"Xiehe
Rd","street_number":"1025 "
OK
AT+CIPGSMLOC=1,1,3,"zh_CN"
+CIPGSMLOC:
"GMT:2012/07/20,05:44:40","latitude":31.2221137,"longitude":121.3543266,"country":"
","country_code":"CN","region":" ","city":" ","street":"
","street_number":"1025 "
SIM900_GSM Location AT Command Manual_V1.00

8/3/2012
8

SIM900 GSM Location AT Command Manual

OK
AT+CIPGSMLOC=1,1,3,"ja_JP"
+CIPGSMLOC:
"GMT:2012/07/20,05:45:24","latitude":31.2221137,"longitude":121.3543266,"country":"
","country_code":"CN","region":" ","city":" ","street":"
","street_number":"1025 "
OK
AT+CIPGSMLOC=1,1,3,"fi_FI"
+CIPGSMLOC:
"GMT:2012/07/20,05:45:45","latitude":31.2221137,"longitude":121.3543266,"country":"Kiina","
country_code":"CN","region":"Shanghai","city":" ","street":"
","street_number":"1025 "
OK
3.3 Deactivate bearer profile
AT+SAPBR=0,1

// Deactivate bearer context

OK

SIM900_GSM Location AT Command Manual_V1.00

8/3/2012
9

SIM900 GSM Location AT Command Manual

Contact us:
Shanghai SIMCom Wireless Solutions Ltd
Addr: Building A, SIM Technology Building, No.633, Jinzhong Road, Changning
Disdrict, Shanghai P.R. China 200355
Tel: +86 21 3252 3300
Fax: +86 21 3252 3301
URL: www.sim.com/wm

SIM900_GSM Location AT Command Manual_V1.00

8/3/2012
10