# QueryLocationException
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Summary:[Constants](https://developer.android.com/reference/android/telecom/QueryLocationException#constants)\|[Inherited Constants](https://developer.android.com/reference/android/telecom/QueryLocationException#inhconstants)\|[Fields](https://developer.android.com/reference/android/telecom/QueryLocationException#lfields)\|[Ctors](https://developer.android.com/reference/android/telecom/QueryLocationException#pubctors)\|[Methods](https://developer.android.com/reference/android/telecom/QueryLocationException#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/telecom/QueryLocationException#inhmethods)
# QueryLocationException
*** ** * ** ***
[Kotlin](https://developer.android.com/reference/kotlin/android/telecom/QueryLocationException "View this page in Kotlin")\|Java
`
public
final
class
QueryLocationException
`
`
``
``
``
extends `[RuntimeException](https://developer.android.com/reference/java/lang/RuntimeException)`
``
implements
`[Parcelable](https://developer.android.com/reference/android/os/Parcelable)`
`
|---|---|---|---|----------------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) |||||
| ↳ | [java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable) ||||
| | ↳ | [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception) |||
| | | ↳ | [java.lang.RuntimeException](https://developer.android.com/reference/java/lang/RuntimeException) ||
| | | | ↳ | android.telecom.QueryLocationException |
*** ** * ** ***
This class represents a set of exceptions that can occur when requesting a[Connection.queryLocationForEmergency(long, String, Executor, OutcomeReceiver)](https://developer.android.com/reference/android/telecom/Connection#queryLocationForEmergency(long,%20java.lang.String,%20java.util.concurrent.Executor,%20android.os.OutcomeReceiver))
## Summary
| ### Constants ||
|-------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `int` | [ERROR_NOT_ALLOWED_FOR_NON_EMERGENCY_CONNECTIONS](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_NOT_ALLOWED_FOR_NON_EMERGENCY_CONNECTIONS) The operation has failed due to a location query being requested for a non-emergency connection. |
| `int` | [ERROR_NOT_PERMITTED](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_NOT_PERMITTED) The operation has failed because it is not permitted. |
| `int` | [ERROR_PREVIOUS_REQUEST_EXISTS](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_PREVIOUS_REQUEST_EXISTS) The operation was rejected due to an existing request. |
| `int` | [ERROR_REQUEST_TIME_OUT](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_REQUEST_TIME_OUT) The operation was not completed on time. |
| `int` | [ERROR_SERVICE_UNAVAILABLE](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_SERVICE_UNAVAILABLE) The operation has failed due to the service is not available. |
| `int` | [ERROR_UNSPECIFIED](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_UNSPECIFIED) The operation has failed due to an unknown or unspecified error. |
| ### Inherited constants |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| From interface[android.os.Parcelable](https://developer.android.com/reference/android/os/Parcelable) |-------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `int` | [CONTENTS_FILE_DESCRIPTOR](https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR) Descriptor bit used with[describeContents()](https://developer.android.com/reference/android/os/Parcelable#describeContents()): indicates that the Parcelable object's flattened representation includes a file descriptor. | | `int` | [PARCELABLE_WRITE_RETURN_VALUE](https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE) Flag for use with[writeToParcel(Parcel, int)](https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)): the object being written is a return value, that is the result of a function such as "`Parcelable someFunction()`", "`void someFunction(out Parcelable)`", or "`void someFunction(inout Parcelable)`". | |
| ### Fields ||
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` public static final `[Creator](https://developer.android.com/reference/android/os/Parcelable.Creator)`<`[QueryLocationException](https://developer.android.com/reference/android/telecom/QueryLocationException)`>` | [CREATOR](https://developer.android.com/reference/android/telecom/QueryLocationException#CREATOR) Responsible for creating QueryLocationException objects for deserialized Parcels. |
| ### Public constructors ||
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[QueryLocationException](https://developer.android.com/reference/android/telecom/QueryLocationException#QueryLocationException(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` message) ` |
| ` `[QueryLocationException](https://developer.android.com/reference/android/telecom/QueryLocationException#QueryLocationException(java.lang.String,%20int))`(`[String](https://developer.android.com/reference/java/lang/String)` message, int code) ` |
| ` `[QueryLocationException](https://developer.android.com/reference/android/telecom/QueryLocationException#QueryLocationException(java.lang.String,%20int,%20java.lang.Throwable))`(`[String](https://developer.android.com/reference/java/lang/String)` message, int code, `[Throwable](https://developer.android.com/reference/java/lang/Throwable)` cause) ` |
| ### Public methods ||
|---------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` int` | ` `[describeContents](https://developer.android.com/reference/android/telecom/QueryLocationException#describeContents())`() ` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
| ` int` | ` `[getCode](https://developer.android.com/reference/android/telecom/QueryLocationException#getCode())`() ` |
| ` void` | ` `[writeToParcel](https://developer.android.com/reference/android/telecom/QueryLocationException#writeToParcel(android.os.Parcel,%20int))`(`[Parcel](https://developer.android.com/reference/android/os/Parcel)` dest, int flags) ` Flatten this object in to a Parcel. |
| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable)` ` |-----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` final void` | ` `[addSuppressed](https://developer.android.com/reference/java/lang/Throwable#addSuppressed(java.lang.Throwable))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable)` exception) ` Appends the specified exception to the exceptions that were suppressed in order to deliver this exception. | | ` `[Throwable](https://developer.android.com/reference/java/lang/Throwable) | ` `[fillInStackTrace](https://developer.android.com/reference/java/lang/Throwable#fillInStackTrace())`() ` Fills in the execution stack trace. | | ` `[Throwable](https://developer.android.com/reference/java/lang/Throwable) | ` `[getCause](https://developer.android.com/reference/java/lang/Throwable#getCause())`() ` Returns the cause of this throwable or`null`if the cause is nonexistent or unknown. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[getLocalizedMessage](https://developer.android.com/reference/java/lang/Throwable#getLocalizedMessage())`() ` Creates a localized description of this throwable. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[getMessage](https://developer.android.com/reference/java/lang/Throwable#getMessage())`() ` Returns the detail message string of this throwable. | | ` `[StackTraceElement[]](https://developer.android.com/reference/java/lang/StackTraceElement) | ` `[getStackTrace](https://developer.android.com/reference/java/lang/Throwable#getStackTrace())`() ` Provides programmatic access to the stack trace information printed by[printStackTrace()](https://developer.android.com/reference/java/lang/Throwable#printStackTrace()). | | ` final `[Throwable[]](https://developer.android.com/reference/java/lang/Throwable) | ` `[getSuppressed](https://developer.android.com/reference/java/lang/Throwable#getSuppressed())`() ` Returns an array containing all of the exceptions that were suppressed, typically by the`try`-with-resources statement, in order to deliver this exception. | | ` `[Throwable](https://developer.android.com/reference/java/lang/Throwable) | ` `[initCause](https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable)` cause) ` Initializes the*cause*of this throwable to the specified value. | | ` void` | ` `[printStackTrace](https://developer.android.com/reference/java/lang/Throwable#printStackTrace())`() ` Prints this throwable and its backtrace to the standard error stream. | | ` void` | ` `[printStackTrace](https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintWriter))`(`[PrintWriter](https://developer.android.com/reference/java/io/PrintWriter)` s) ` Prints this throwable and its backtrace to the specified print writer. | | ` void` | ` `[printStackTrace](https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintStream))`(`[PrintStream](https://developer.android.com/reference/java/io/PrintStream)` s) ` Prints this throwable and its backtrace to the specified print stream. | | ` void` | ` `[setStackTrace](https://developer.android.com/reference/java/lang/Throwable#setStackTrace(java.lang.StackTraceElement[]))`(`[StackTraceElement[]](https://developer.android.com/reference/java/lang/StackTraceElement)` stackTrace) ` Sets the stack trace elements that will be returned by[getStackTrace()](https://developer.android.com/reference/java/lang/Throwable#getStackTrace())and printed by[printStackTrace()](https://developer.android.com/reference/java/lang/Throwable#printStackTrace())and related methods. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Throwable#toString())`() ` Returns a short description of this throwable. | ||
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object) | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`. | | ` int` | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*. | ||
| From interface` `[android.os.Parcelable](https://developer.android.com/reference/android/os/Parcelable)` ` |------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract int` | ` `[describeContents](https://developer.android.com/reference/android/os/Parcelable#describeContents())`() ` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. | | ` abstract void` | ` `[writeToParcel](https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int))`(`[Parcel](https://developer.android.com/reference/android/os/Parcel)` dest, int flags) ` Flatten this object in to a Parcel. | ||
## Constants
### ERROR_NOT_ALLOWED_FOR_NON_EMERGENCY_CONNECTIONS
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_NOT_ALLOWED_FOR_NON_EMERGENCY_CONNECTIONS
```
The operation has failed due to a location query being requested for a non-emergency connection.
Constant Value: 4 (0x00000004)
### ERROR_NOT_PERMITTED
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_NOT_PERMITTED
```
The operation has failed because it is not permitted.
Constant Value: 3 (0x00000003)
### ERROR_PREVIOUS_REQUEST_EXISTS
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_PREVIOUS_REQUEST_EXISTS
```
The operation was rejected due to an existing request.
Constant Value: 2 (0x00000002)
### ERROR_REQUEST_TIME_OUT
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_REQUEST_TIME_OUT
```
The operation was not completed on time.
Constant Value: 1 (0x00000001)
### ERROR_SERVICE_UNAVAILABLE
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_SERVICE_UNAVAILABLE
```
The operation has failed due to the service is not available.
Constant Value: 5 (0x00000005)
### ERROR_UNSPECIFIED
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final int ERROR_UNSPECIFIED
```
The operation has failed due to an unknown or unspecified error.
Constant Value: 6 (0x00000006)
## Fields
### CREATOR
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final Creator CREATOR
```
Responsible for creating QueryLocationException objects for deserialized Parcels.
## Public constructors
### QueryLocationException
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public QueryLocationException (String message)
```
| Parameters ||
|-----------|-------------------------------------------|
| `message` | `String`: This value may be`null`.
|
### QueryLocationException
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public QueryLocationException (String message,
int code)
```
| Parameters ||
|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `message` | `String`: This value may be`null`.
|
| `code` | `int`: Value is[ERROR_REQUEST_TIME_OUT](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_REQUEST_TIME_OUT),[ERROR_PREVIOUS_REQUEST_EXISTS](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_PREVIOUS_REQUEST_EXISTS),[ERROR_NOT_PERMITTED](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_NOT_PERMITTED),[ERROR_NOT_ALLOWED_FOR_NON_EMERGENCY_CONNECTIONS](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_NOT_ALLOWED_FOR_NON_EMERGENCY_CONNECTIONS),[ERROR_SERVICE_UNAVAILABLE](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_SERVICE_UNAVAILABLE), or[ERROR_UNSPECIFIED](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_UNSPECIFIED)
|
### QueryLocationException
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public QueryLocationException (String message,
int code,
Throwable cause)
```
| Parameters ||
|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `message` | `String`: This value may be`null`.
|
| `code` | `int`: Value is[ERROR_REQUEST_TIME_OUT](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_REQUEST_TIME_OUT),[ERROR_PREVIOUS_REQUEST_EXISTS](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_PREVIOUS_REQUEST_EXISTS),[ERROR_NOT_PERMITTED](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_NOT_PERMITTED),[ERROR_NOT_ALLOWED_FOR_NON_EMERGENCY_CONNECTIONS](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_NOT_ALLOWED_FOR_NON_EMERGENCY_CONNECTIONS),[ERROR_SERVICE_UNAVAILABLE](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_SERVICE_UNAVAILABLE), or[ERROR_UNSPECIFIED](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_UNSPECIFIED)
|
| `cause` | `Throwable`: This value may be`null`.
|
## Public methods
### describeContents
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int describeContents ()
```
Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of[writeToParcel(android.os.Parcel, int)](https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)), the return value of this method must include the[CONTENTS_FILE_DESCRIPTOR](https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR)bit.
| Returns ||
|-------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `int` | a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either`0`or[CONTENTS_FILE_DESCRIPTOR](https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR)
|
### getCode
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int getCode ()
```
| Returns ||
|-------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `int` | Value is[ERROR_REQUEST_TIME_OUT](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_REQUEST_TIME_OUT),[ERROR_PREVIOUS_REQUEST_EXISTS](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_PREVIOUS_REQUEST_EXISTS),[ERROR_NOT_PERMITTED](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_NOT_PERMITTED),[ERROR_NOT_ALLOWED_FOR_NON_EMERGENCY_CONNECTIONS](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_NOT_ALLOWED_FOR_NON_EMERGENCY_CONNECTIONS),[ERROR_SERVICE_UNAVAILABLE](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_SERVICE_UNAVAILABLE), or[ERROR_UNSPECIFIED](https://developer.android.com/reference/android/telecom/QueryLocationException#ERROR_UNSPECIFIED)
|
### writeToParcel
Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void writeToParcel (Parcel dest,
int flags)
```
Flatten this object in to a Parcel.
| Parameters ||
|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `dest` | `Parcel`: The Parcel in which the object should be written. This value cannot be`null`.
|
| `flags` | `int`: Additional flags about how the object should be written. May be 0 or[Parcelable.PARCELABLE_WRITE_RETURN_VALUE](https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE). Value is either`0`or a combination of[Parcelable.PARCELABLE_WRITE_RETURN_VALUE](https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE), and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES
|