Response

In response to the request, Yandex Locator returns:

• JSON with the location of the mobile device.
• Error message.

Location responseLocation response

Response exampleResponse example

 {
   "position": {
     "latitude": 55.743675,
     "longitude": 37.5646301,
     "altitude": 0.0,
     "precision": 701.71643,
     "altitude_precision": 30.0,
     "type": "gsm"
   }
 }

KeysKeys

Error messageError message

If Yandex Locator can't process the request, you receive an error message:

 {
     "error": {
         "code": _code_,
         "message": "_message text_"
     }
 }

• 2: Internal service error.
• 6: Couldn't determine location.
• 7: Invalid JSON structure.
• 8: Invalid access key.

KeysKeys

Examples of error messagesExamples of error messages

1. Couldn't determine location.

   {
       "error": {
          "code": 6,
          "message": "Location not found"
       }
   }
   

   Information about the cells, Wi-Fi access points, and subnets that own the IP address is missing in the service. This error also occurs if the data format is invalid.

2. Couldn't process JSON.

   {
      "error": {
          "code": 7,
          "message": "JSON request is invalid"
      }
   }
   

   The passed JSON array has an invalid structure. For example, some required elements, brackets, or closing tags may be missing.

3. Invalid access key.

   {
      "error": {
          "code": 8,
          "message": "invalid api_key"
      }
   }
   

Make sure that the key specified in the request is valid.