LocationBox

Address Elements

LocationBox Address Elements offers the full city list, list of towns for a given city and list of districts of a given town.
An Address Elements request must look like this:

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=cmd_name&Typ=output_format&MajorCities=major_code

IlList

Request Parameters

Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (IlList)
Typ: Response format. (XML or JSON)
MajorCities: if value is 1 function lists Istanbul, Ankara and İzmir first then other cities alphabetically. Default value is 0.
CountryId:Id for Northern Cyprus Turkish Republic (99) for Turkey (90)
Keyword (optional): Add a keyword to narrow down Cmd results.

Response Parameters

XML Response

Address Elements response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (city list) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=IlList&Typ=XML

The response will be as following:


					  <response>

					   <transactionid>LBS_151</transactionid> 

					   <status>0</status>

					   <errno /> 

					   <errdesc /> 

					   <illist>

                                           <il>

					    <id>1</id> 

					    <name>ADANA</name> 

                                            <adreskodu>1</adreskodu> 

					    <latitude>37.00039</latitude> 

					    <longitude>35.31411</longitude> 

					    <extent>

                                            <minlatitude>36.53881902</minlatitude> 

                                            <minlongitude>34.76786904</minlongitude> 

                                            <maxlatitude>38.37851496</maxlatitude> 

                                            <maxlongitude>36.40534884</maxlongitude> 

                                            </extent> 

                                           </il>

					 
   ... 


					   <il>

					    <id>67</id> 

					    <name>Zonguldak</name> 

                                            <adreskodu>1</adreskodu> 

					    <latitude>41.45519</latitude> 

					    <longitude>31.7879</longitude> 

					    <extent>

                                            <minlatitude>40.98164697</minlatitude> 

                                            <minlongitude>31.28221692</minlongitude> 

                                            <maxlatitude>41.595102</maxlatitude> 

                                            <maxlongitude>32.29834608</maxlongitude> 

                                            </extent> 

                                           </il>

					   </illist>

					  </response>

JSON Response

Address Elements response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (city list) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=IlList&Typ=JSON

The response will be as following:

{ transactionid: LBS_186, status: 0, illist: [  "id": 1, "adreskodu": 1, "name": "Adana", "latitude": 37.00039, "longitude": 35.31411,
                                        "extent": {"minlatitude": 36.53881902, "minlongitude": 34.76786904, "maxlatitude": 38.37851496, "maxlongitude": 36.40534884 }, 
					
...

					"id": 67, "adreskodu": 67, "name": "Zonguldak", "latitude": 41.45519, "longitude": 31.7879,
                                        "extent": { "minlatitude": 40.98164697, "minlongitude": 31.28221692, "maxlatitude": 41.595102, "maxlongitude": 32.29834608 } ] }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

Error Codes
10001 Error processing your request. Please try again soon. Cmd parameter is misspelled/not found. 10011 Error processing your request. Please check the Cmd parameter. Cmd is not specified. 10012 Error processing your request. Please check the Key parameter. Key is not specified. 10013 Error processing your request. Please check the Key parameter. Key is invalid. 20022 City is not found. 20023 Town is not found. 20024 District is not found.

illist (city list)

id: City id.
latitude: Latitude value for middle point representing the area.
longitude: Longitude value for middle point representing the area.

ilList With Extent

Request Parameters

Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (IlList)
Typ: Response format. (XML or JSON)
MinLatitude: Minimum Latitude value of the extent.
MaxLatitude: Maximum Latitude value of the extent.
MinLongitude: Minimum Latitude value of the extent.
MaxLongitude: Maximum Latitude value of the extent
Keyword (optional): Add a keyword to narrow down Cmd results.

Response Parameters

XML Response

Address Elements response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (city list) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=IlListWİthExtent&Typ=XML&MinLatitude=40.357822&MinLongitude=28.521057&MaxLatitude=41.327673&MaxLongitude=30.034842

The response will be as following:


					  <response>

					   <transactionid>LBS_151</transactionid> 

					   <status>0</status>

					   <errno /> 

					   <errdesc /> 

					   <illist>

                                           <il>

					    <id>1</id> 

					    <name>ADANA</name> 

                                            <adreskodu>1</adreskodu> 

					    <latitude>37.00039</latitude> 

					    <longitude>35.31411</longitude> 

					    <extent>

                                            <minlatitude>36.53881902</minlatitude> 

                                            <minlongitude>34.76786904</minlongitude> 

                                            <maxlatitude>38.37851496</maxlatitude> 

                                            <maxlongitude>36.40534884</maxlongitude> 

                                            </extent> 

                                           </il>

					  
   ... 


					  
					    <id>67</id> 

					    <name>ZONGULDAK</name> 

                                            <adreskodu>67</adreskodu> 

					    <latitude>41.45519</latitude> 

					    <longitude>31.7879</longitude> 

                                            <extent>

                                            <minlatitude>40.98164697</minlatitude> 

                                            <minlongitude>31.28221692</minlongitude> 

                                            <maxlatitude>41.595102</maxlatitude> 

                                            <maxlongitude>32.29834608</maxlongitude> 

                                            </extent> 

                                           </il>

					   </illist>

					  </response>

JSON Response

Address Elements response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (city list) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=IlListWİthExtent&Typ=JSON&MinLatitude=40.357822&MinLongitude=28.521057&MaxLatitude=41.327673&MaxLongitude=30.034842

The response will be as following:

{ transactionid: LBS_186, status: 0, illist: [  "id": 1, "adreskodu": 1, "name": "Adana", "latitude": 37.00039, "longitude": 35.31411,
                                        "extent": { "minlatitude": 36.53881902, "minlongitude": 34.76786904, "maxlatitude": 38.37851496,  "maxlongitude": 36.40534884 }, 
					
...

					"id": 67, "adreskodu": 67, "name": "Zonguldak", "latitude": 41.45519, "longitude": 31.7879,
                                        "extent": { "minlatitude": 40.98164697, "minlongitude": 31.28221692, "maxlatitude": 41.595102, "maxlongitude": 32.29834608 } ] }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

IlceList

Request Parameters

Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (IlceList)
Typ: Response format. (XML or JSON)
IlId: City id.
Keyword (optional): Add a keyword to narrow down Cmd results.

XML Response

Address Elements response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (town list) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=IlceList&Typ=XML&IlId=6

The response will be as following:


					  <response>

					   <transactionid>LBS_179</transactionid> 

					   <status>0</status>

					   <errno /> 

					   <errdesc /> 

					   <ilcelist>

                                           <ilce>

					    <id>6000384000</id> 

					    <adreskodu>1872</adreskodu> 

					    <name>AKYURT</name> 

					    <latitude>40.13278</latitude> 

					    <longitude>33.08659</longitude> 

					    <extent>

                                            <minlatitude>40.02323796</minlatitude> 

                                            <minlongitude>32.95430388</minlongitude> 

                                            <maxlatitude>40.22708499</maxlatitude> 

                                            <maxlongitude>33.31662696</maxlongitude> 

                                            </extent> 

                                           </ilce>

					  
   ... 


						  
					    <id>6000991000</id> 

					    <adreskodu>1723</adreskodu> 

					    <name>YENİMAHALLE</name> 

					    <latitude>39.96236</latitude> 

					    <longitude>32.81005</longitude> 

                                            <extent>

                                            <minlatitude>39.91103199</minlatitude> 

                                            <minlongitude>32.56429788</minlongitude> 

                                            <maxlatitude>40.10497902</maxlatitude> 

                                            <maxlongitude>32.84697204</maxlongitude> 

                                            </extent> 

                                           </ilce>

					   </ilcelist>

					  </response>

JSON Response

Address Elements response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (town list) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=IlceList&Typ=JSON&IlId=6

The response will be as following:

{ transactionid: LBS_188, status: 0, ilcelist: [ "id": 6000384000, "adreskodu": 1872, "name": "Akyurt", "latitude": 40.13278, "longitude": 33.08659,
                                        "extent": { "minlatitude": 40.02323796, "minlongitude": 32.95430388, "maxlatitude": 40.22708499, "maxlongitude": 33.31662696 }, 
					
...

					"id": 6000991000, "adreskodu": 1723, "name": "Yenimahalle", "latitude": 39.96655, "longitude": 32.81083,
                                        "extent": { "minlatitude": 39.91103199, "minlongitude": 32.56429788, "maxlatitude": 40.10497902, "maxlongitude": 32.84697204 } ] }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

ilcelist (town list)

id: Town id.
latitude: Latitude value for middle point representing the area.
longitude: Longitude value for middle point representing the area.

ilceList With Extent

Request Parameters

Response Parameters

XML Response

Address Elements response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (city list) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=IlceListWithExtent&Typ=XML&MinLatitude=40.357822&MinLongitude=28.521057&MaxLatitude=41.327673&MaxLongitude=30.034842

The response will be as following:


					  <response>

					   <transactionid>LBS_179</transactionid> 

					   <status>0</status>

					   <errno /> 

					   <errdesc /> 

					   <ilcelist>

                                           <ilce>

					    <id>50000636000</id> 

					    <adreskodu>1749</adreskodu> 

					    <name>Acıgöl</name> 

					    <latitude>38.55032</latitude> 

					    <longitude>34.5102</longitude> 

					    <extent>

                                            <minlatitude>38.35265103</minlatitude> 

                                            <minlongitude>34.38000612</minlongitude> 

                                            <maxlatitude>38.68626798</maxlatitude> 

                                            <maxlongitude>34.61836212</maxlongitude> 

                                            </extent> 

                                           </ilce>

					  
   ... 


						  
                                           <ilce>

					    <id>20000261000</id> 

					    <adreskodu>2079</adreskodu> 

					    <name>Merkezefendi</name> 

					    <latitude>37.77333</latitude> 

					    <longitude>29.08712</longitude> 

					    <extent>

                                            <minlatitude>37.69063704</minlatitude> 

                                            <minlongitude>28.89521892</minlongitude> 

                                            <maxlatitude>37.94584302</maxlatitude> 

                                            <maxlongitude>29.13414804</maxlongitude> 

                                            </extent> 

                                           </ilce>

					   </ilcelist>

					  </response>

JSON Response

Address Elements response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (city list) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=IlceListWithExtent&Typ=JSON&MinLatitude=40.357822&MinLongitude=28.521057&MaxLatitude=41.327673&MaxLongitude=30.034842

The response will be as following:

{ transactionid: LBS_188, status: 0, ilcelist: [ "id": 50000636000, "adreskodu": 1749, "name": "Acıgöl", "latitude": 38.55032, "longitude": 34.5102,
                                        "extent": { "minlatitude": 38.35265103, "minlongitude": 34.38000612, "maxlatitude": 38.68626798, "maxlongitude": 34.61836212 }, 
					
...

					{ "id": 20000261000, "adreskodu": 2079, "name": "Merkezefendi", "latitude": 37.77333, "longitude": 29.08712,
                                        "extent": { "minlatitude": 37.69063704, "minlongitude": 28.89521892, "maxlatitude": 37.94584302, "maxlongitude": 29.13414804 } ] }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

MahalleList

Request Parameters

Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (MahalleList)
Typ: Response format. (XML or JSON)
IlceId: County id.
Type(optional):0 = default , 1 = all villages, towns and districts, 2 = just villages and towns
Keyword (optional): Add a keyword to narrow down Cmd results.

XML Response

Address Elements response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (district list) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=MahalleList&Typ=XML&IlceId=6000986000

The response will be as following:


						<response>

						 <transactionid>LBS_185</transactionid> 

						 <status>0</status>

						 <errno /> 

						 <errdesc /> 

						 <mahallelist>

                                                 <mahalle>

						  <id>6000986133</id> 

                                                  <adreskodu>1619</adreskodu> 

                                                  <postakodu>06805</postakodu> 

						  <name>Ahlatlıbel</name> 

						  <latitude>39.83489</latitude> 

						  <longitude>32.74536</longitude> 

                                                  <extent>

                                                  <minlatitude>39.82784103</minlatitude> 

						  <minlongitude>32.72476788</minlongitude> 

                                                  <maxlatitude>39.855222</maxlatitude> 

						  <maxlongitude>32.80497912</maxlongitude> 

                                                  </extent> 

                                                 </mahalle>

                                                
						
   ... 



						 <mahalle>

						  <id>6000986054</id> 

                                                  <adreskodu>1615</adreskodu> 

                                                  <postakodu>06590</postakodu> 

						  <name>50. Yıl</name> 

						  <latitude>39.92266</latitude> 

						  <longitude>32.88251</longitude> 

                                                  <extent>

                                                  <minlatitude>39.92150601</minlatitude> 

						  <minlongitude>32.87369304</minlongitude> 

                                                  <maxlatitude>39.92652504</maxlatitude> 

						  <maxlongitude>32.88550608</maxlongitude> 

                                                  </extent> 

                                                 </mahalle>

                                         
						 </mahallelist>

						</response>

JSON Response

Address Elements response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (district list) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=MahalleList&Typ=JSON&IlceId=6000986000

The response will be as following:

{ transactionid: LBS_189, status: 0, mahallelist: [ { "id": 6000986133, "adreskodu": 1619, "postakodu": "06805", "name": "Ahlatlıbel", "latitude": 39.83489, "longitude": 32.74536,
                                         "extent": { "minlatitude": 39.82784103, "minlongitude": 32.72476788, "maxlatitude": 39.855222, "maxlongitude": 32.80497912 } }, 
					
...

					{ "id": 6000986054, "adreskodu": 1615, "postakodu": "06590", "name": "50. Yıl", "latitude": 39.92266, "longitude": 32.88251,  "extent": { "minlatitude": 39.92150601, "minlongitude": 32.87369304, "maxlatitude": 39.92652504, "maxlongitude": 32.88550608 } } ] }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

mahallelist (district list)

id: District id.
latitude: Latitude value for middle point representing the area.
longitude: Longitude value for middle point representing the area.

MahalleList With Extent

Request Parameters

Response Parameters

XML Response

Address Elements response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (city list) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=MahalleListWithExtent&Typ=XML&MinLatitude=40.357822&MinLongitude=28.521057&MaxLatitude=41.327673&MaxLongitude=30.034842

The response will be as following:


						<response>

						 <transactionid>LBS_185</transactionid> 

						 <status>0</status>

						 <errno /> 

						 <errdesc /> 

						 <mahallelist>

						 <mahalle>

						  <id>34000007022</id> 

                                                  <adreskodu>40219</adreskodu> 

                                                  <postakodu>34022</postakodu> 

						  <name>Abbasağa</name> 

						  <latitude>41.04965</latitude> 

						  <longitude>29.0056</longitude> 

                                                  <extent>

                                                  <minlatitude>39.82784103</minlatitude> 

						  <minlongitude>32.72476788</minlongitude> 

                                                  <maxlatitude>39.855222</maxlatitude> 

						  <maxlongitude>32.80497912</maxlongitude> 

                                                  </extent> 

                                                 </mahalle>

                                                
						
   ... 


						
					         <mahalle>

						  <id>34000038043</id> 

                                                  <adreskodu>181484</adreskodu> 

                                                  <postakodu>34522</postakodu> 

						  <name>Necip Fazıl Kısakürek</name> 

						  <latitude>41.03052</latitude> 

						  <longitude>28.65418</longitude> 

                                                  <extent>

                                                  <minlatitude>41.02770402</minlatitude> 

						  <minlongitude>28.64743092</minlongitude> 

                                                  <maxlatitude>41.03437599</maxlatitude> 

						  <maxlongitude>28.66046796</maxlongitude> 

                                                  </extent> 

                                                 </mahalle>

						 </mahallelist>

						</response>

JSON Response

Address Elements response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (city list) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=MahalleListWithExtent&Typ=JSON&MinLatitude=40.357822&MinLongitude=28.521057&MaxLatitude=41.327673&MaxLongitude=30.034842

The response will be as following:

{ transactionid: LBS_189, status: 0, mahallelist: [ {  "id": 34000007022, "adreskodu": 40219, "postakodu": "34022", "name": "Abbasağa", "latitude": 41.04965, "longitude": 29.0056,
                                        "extent": { "minlatitude": 41.04675, "minlongitude": 29.00318796, "maxlatitude": 41.05254303, "maxlongitude": 29.008008  } }, 
					{ ilceid: 6000986000, id: 6000986016, name: 'AKPINAR', latitude: 39.86082, longitude: 32.81394 }, 
					
...

					{ "id": 34000038043, "adreskodu": 181484, "postakodu": "34522", "name": "Necip Fazıl Kısakürek", "latitude": 41.03052, "longitude": 28.65418, 
                                        "extent": { "minlatitude": 41.02770402, "minlongitude": 28.64743092, "maxlatitude": 41.03437599, "maxlongitude": 28.66046796 } } ] }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

YolList

Request Parameters

Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (YolList)
Typ: Response format. (XML or JSON)
MahalleId: District id.
Keyword (optional): Add a keyword to narrow down Cmd results.

XML Response

Address Elements response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (district list) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=YolList&Typ=XML&MahalleId=6000986059

The response will be as following:


						<response>

						 <transactionid>LBS_37526731</transactionid> 

						 <status>0</status>

						 <errno /> 

						 <errdesc /> 

						 <yollist>

						 <yol>

						  <id>16063243</id> 

						  <name>284. SOKAK</name> 

						  <latitude>39.89917</latitude> 

						  <longitude>32.8459</longitude> 

						  <zoomlevel>11</zoomlevel> 

						 </yol>

						 <yol>

						  <id>15846246</id> 

						  <name>ALİ DEDE SOKAK</name> 

						  <latitude>39.90218</latitude> 

						  <longitude>32.85283</longitude> 

						  <zoomlevel>10</zoomlevel> 

						 <yol>

						
   ... 


						
						 <yol>

						  <id>15997463</id> 

						  <name>YEŞİLYURT SOKAK</name> 

						  <latitude>39.89776</latitude> 

						  <longitude>32.85336</longitude> 

						  <zoomlevel>11</zoomlevel> 

						 </yol>

						 </yollist>

						</response>

JSON Response

Address Elements response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (district list) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=YolList&Typ=JSON&MahalleId=6000986059

The response will be as following:

{
  "transactionid": "LBS_37526747",
  "status": 0,
  "yollist": [
    {
      "id": 16063243, "name": "284. SOKAK", "latitude": 39.89917, "longitude": 32.8459, "zoomlevel": 11
    },
    {
      "id": 15846246, "name": "ALİ DEDE SOKAK", "latitude": 39.90218, "longitude": 32.85283, "zoomlevel": 10
    }, 
					
...

					    {
      "id": 15997463, "name": "YEŞİLYURT SOKAK", "latitude": 39.89776, "longitude": 32.85336, "zoomlevel": 11
    }
  ]
}

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

YOLLIST (district list)

id: District id.
latitude: Latitude value for middle point representing the area.
longitude: Longitude value for middle point representing the area.

YolList With Extent

Request Parameters

Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (YolListWithExtent)
Typ: Response format. (XML or JSON)
MinLatitude: Minimum Latitude value of the extent.
MinLongitude: Minimum Longitude value of the extent.
MaxLatitude: Maximum Latitude value of the extent.
MaxLongitude: Maximum Longitude value of the extent.
Keyword (optional): Add a keyword to narrow down Cmd results.

XML Response

Address Elements response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (district list) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=YolListWithExtent&Typ=XML
&MinLatitude=39.88856601&MinLongitude=32.84312112&MaxLatitude=39.90537603&MaxLongitude=32.85343692

The response will be as following:


						<response>

						 <transactionid>LBS_37526731</transactionid> 

						 <status>0</status>

						 <errno /> 

						 <errdesc /> 

						 <yollist>

						 <yol>

						  <id>16063243</id> 

						  <name>284. SOKAK</name> 

						  <latitude>39.89917</latitude> 

						  <longitude>32.8459</longitude> 

						  <zoomlevel>11</zoomlevel> 

						 </yol>

						 <yol>

						  <id>15846246</id> 

						  <name>ALİ DEDE SOKAK</name> 

						  <latitude>39.90218</latitude> 

						  <longitude>32.85283</longitude> 

						  <zoomlevel>10</zoomlevel> 

						 <yol>

						
   ... 


						
						 <yol>

						  <id>15997463</id> 

						  <name>YEŞİLYURT SOKAK</name> 

						  <latitude>39.89776</latitude> 

						  <longitude>32.85336</longitude> 

						  <zoomlevel>11</zoomlevel> 

						 </yol>

						 </yollist>

						</response>

JSON Response

Address Elements response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (district list) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=YolListWithExtent&Typ=JSON&
MinLatitude=39.88856601&MinLongitude=32.84312112&MaxLatitude=39.90537603&MaxLongitude=32.85343692

The response will be as following:

{
  "transactionid": "LBS_37526747",
  "status": 0,
  "yollist": [
    {
      "id": 16063243, "name": "284. SOKAK", "latitude": 39.89917, "longitude": 32.8459, "zoomlevel": 11
    },
    {
      "id": 15846246, "name": "ALİ DEDE SOKAK", "latitude": 39.90218, "longitude": 32.85283, "zoomlevel": 10
    }, 
					
...

    {
      "id": 15997463, "name": "YEŞİLYURT SOKAK", "latitude": 39.89776, "longitude": 32.85336, "zoomlevel": 11
    }
  ]
}

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

YolList With Extent (district list)

id: District id.
latitude: Latitude value for middle point representing the area.
longitude: Longitude value for middle point representing the area.

KapiList

Request Parameters

Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (KapiList)
Typ: Response format. (XML or JSON)
YolId: Road id.

XML Response

Address Elements response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (kapi list) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=KapiList&Typ=XML&YolId=10277726

The response will be as following:


						<response>

						 <transactionid>LBS_37526731</transactionid> 

						 <status>0</status>

						 <errno /> 

						 <errdesc /> 

						 <kapilist>

						 <kapi>

						  <id>200132845</id> 

                                                  <adreskodu>552566</adreskodu> 

                                                  <postakodu>06680</postakodu> 

						  </name> 

						  <no>41</no> 

						 </kapi>

						
   ... 


						
						 <kapi>

						  <id>11563824</id> 

                                                  <adreskodu>552573</adreskodu> 

                                                  <postakodu>06680</postakodu> 

						  </name> 

						  <no>8</no> 

						 </kapi>

						 </kapilist>

						</response>

JSON Response

Address Elements response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (kapi list) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=KapiList&Typ=JSON&YolId=10277726

The response will be as following:

{
  "transactionid": "LBS_37526747",
  "status": 0,
  "kapilist": [
    {
      "id": 11532388, "adreskodu": 552566, "postakodu": "06680", "name": "", "no": "1"
    },
					
...

   {
      "id": 11563824, "adreskodu": 552573, "postakodu": "06680", "name": "", "no": "8"
    }
  ]
}

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

KAPILIST (district list)

id: id.
name: name.
no: no.

KapiList With Extent

Request Parameters

Response Parameters

XML Response

Address Elements response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (city list) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=KapiListWithExtent&Typ=XML&MinLatitude=40.357822&MinLongitude=28.521057&MaxLatitude=41.327673&MaxLongitude=30.034842

The response will be as following:


						<response>

						 <transactionid>LBS_37526731</transactionid> 

						 <status>0</status>

						 <errno /> 

						 <errdesc /> 

						 <kapilist>

						 <kapi>

						  <id>257784568</id> 

                                                  <adreskodu>43159205</adreskodu> 

                                                  <postakodu>63700</postakodu> 

						  <name>Ortaokul</name> 

						  <no>41</no> 

						 </kapi>

						
   ... 


						
						 <kapi>

						  <id>257778365</id> 

                                                  <adreskodu>9688008</adreskodu> 

                                                  <postakodu>63700</postakodu> 

						  </name> 

						  <no>98</no> 

						 </kapi>

						 </kapilist>

						</response>

JSON Response

Address Elements response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (city list) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=MahalleListWithExtent&Typ=JSON&MinLatitude=40.357822&MinLongitude=28.521057&MaxLatitude=41.327673&MaxLongitude=30.034842

The response will be as following:

{
  "transactionid": "LBS_37526747",
  "status": 0,
  "kapilist": [
    {
      "id": 257784568, "adreskodu": 43159205, "postakodu": "63700", "name": "Ortaokul", "no": "1"
    },
					
...

   {
     "id": 257778365, "adreskodu": 9688008, "postakodu": "63700", "name": "", "no": "98"
    }
  ]
}

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

GetCoordinate

Request Parameters

Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (GetCoordinate)
Typ: Response format. (XML or JSON)
Id: You can use address and POI elements. (IlId, IlceId, MahalleId, YolId, PoiId)

XML Response

GetCoordinate response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (kapi list) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=GetCoordinate&Typ=XML&IlceId=6000986000

The response will be as following:


						 <transactionid>LBS_49937060</transactionid> 

						 <status>0</status>

						  <latitude>39.91931</latitude> 

						  <longitude>32.85112</longitude>

JSON Response

GetCoordinate response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (GetCoordinate) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=GetCoordinate&Typ=JSON&IlceId=6000986000

The response will be as following:

{
           "transactionid": "LBS_49937064",
           "status": 0,
           "latitude": 39.91931,
           "longitude": 32.85112
          }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

GetBagimsizBirim

Request Parameters

Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (GetBagimsizBirim)
Typ: Response format. (XML or JSON)
AdresKodu: Door id.

XML Response

Address Elements response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (bagimsiz birim) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=GetBagimsizBirim&Typ=XML&AdresKodu=3749201855

The response will be as following:


						<response>

						 <transactionid>LBS_503041004</transactionid> 

						 <status>0</status>

						 <adrcleanver>v5.24</adrcleanver>

                                                 <dataversion>19Q4</dataversion>

                                                 <errno /> 

						 <errdesc /> 

						 <geocode>

						
   ... 


						 <geocode/>

						</response>

JSON Response

Address Elements response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (bagimsiz birim) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=GetBagimsizBirim&Typ=JSON&AdresKodu=3749201855

The response will be as following:

{
  "transactionid": "LBS_503082914",
  "status": 0,
  "adrcleanver": "v5.24",
  "dataversion": "19Q4",
  "geocode": {
    
...

  }
}

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

Error Codes
10001 Error processing your request. Please try again soon. Cmd parameter is misspelled/not found. 10011 Error processing your request. Please check the Cmd parameter. Cmd is not specified. 10012 Error processing your request. Please check the Key parameter. Key is not specified. 10013 Error processing your request. Please check the Key parameter. Key is invalid. 30011 UAVT_CODE package support is missing. 20022 Data is not found.

GetBagimsizBirimList

Request Parameters

Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (GetBagimsizBirimList)
Typ: Response format. (XML or JSON)
KapiId: Door id.

XML Response

Address Elements response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (bagimsiz birim list) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=GetBagimsizBirimList&Typ=XML&KapiId=153061019

The response will be as following:


						<response>

						 <transactionid>LBS_502999082</transactionid> 

						 <status>0</status>

						 <errno /> 

						 <errdesc /> 

						 <ickapilist>

						 <icKapi>

						  <uavtKapiId>26109302</uavtKapiId> 

                                                  <uavtIcKapiId>1822365597</uavtIcKapiId> 

						  <mahalleId>34000016017</mahalleId> 

						  <icKapiNo>1</icKapiNo> 

                                                  <icKapiTuru>Bilinmeyen</icKapiTuru> 

						 </icKapi>

						
   ... 


						
						 <icKapi>

						  <uavtKapiId>26109302</uavtKapiId> 

                                                  <uavtIcKapiId>1819965672</uavtIcKapiId> 

						  <mahalleId>34000016017</mahalleId> 

                                                  <icKapiNo>9</icKapiNo> 

						  <icKapiTuru>Bilinmeyen</icKapiTuru> 

						 </icKapi>

						 </ickapilist>

						</response>

JSON Response

Address Elements response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (Bagimsiz birim list) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=GetBagimsizBirimList&Typ=JSON&KapiId=153061019

The response will be as following:

{
  "transactionid": "LBS_503004652",
  "status": 0,
  "ickapilist": [
    {
      "uavtKapiId": 26109302, "uavtIcKapiId": 1822365597, "mahalleId": 34000016017, "icKapiNo": "1","icKapiTuru": "Bilinmeyen"
    },
					
...

   {
     "uavtKapiId": 26109302,   "uavtIcKapiId": 1819965672, "mahalleId": 34000016017, "icKapiNo": "9","icKapiTuru": "Bilinmeyen"
    }
  ]
}

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

Error Codes
10001 Error processing your request. Please try again soon. Cmd parameter is misspelled/not found. 10011 Error processing your request. Please check the Cmd parameter. Cmd is not specified. 10012 Error processing your request. Please check the Key parameter. Key is not specified. 10013 Error processing your request. Please check the Key parameter. Key is invalid. 30011 UAVT_CODE package support is missing. 20022 Data is not found.

API

Service API

Address

POI

Route

Map

Indoor

Dynamic Information

Campaign

Demography

Traffic

User Data

Risk

Analysis

TMC

Key

Tools

Feedback

JavaScriptV2 API

JavaScript API

JavaScript3D API

Address Elements

IlList

Request Parameters

Response Parameters

XML Response

JSON Response

illist (city list)

ilList With Extent

Request Parameters

Response Parameters

XML Response

JSON Response

IlceList

Request Parameters

XML Response

JSON Response

ilcelist (town list)

ilceList With Extent

Request Parameters

Response Parameters

XML Response

JSON Response

MahalleList

Request Parameters

XML Response

JSON Response

mahallelist (district list)

MahalleList With Extent

Request Parameters

Response Parameters

XML Response

JSON Response

YolList

Request Parameters

XML Response

JSON Response

YOLLIST (district list)

YolList With Extent

Request Parameters

XML Response

JSON Response

YolList With Extent (district list)

KapiList

Request Parameters

XML Response

JSON Response

KAPILIST (district list)

KapiList With Extent

Request Parameters

Response Parameters

XML Response

JSON Response

GetCoordinate

Request Parameters

XML Response

JSON Response

GetBagimsizBirim

Request Parameters

XML Response