> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rebellapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# my.chooseLocation

> Choose a location from the map.

Open a map interface for the user to select a location.

## Parameters

| Property | Type     | Required | Description                     |
| -------- | -------- | -------- | ------------------------------- |
| success  | Function | No       | Callback with selected location |
| fail     | Function | No       | Callback on failure             |
| complete | Function | No       | Callback that always executes   |

## Success Callback

| Property     | Type   | Description                                                                                                           |
| ------------ | ------ | --------------------------------------------------------------------------------------------------------------------- |
| name         | String | Location name                                                                                                         |
| address      | String | Full address                                                                                                          |
| latitude     | Number | The latitude, expressed as a floating-point number ranging from -90 to +90. A negative number means south latitude    |
| longitude    | Number | The longitude, expressed as a floating-point number ranging from -180 to +180. A negative number means west longitude |
| provinceName | String | The province                                                                                                          |
| cityName     | String | The city                                                                                                              |

## Code Example

```javascript theme={null}
my.chooseLocation({
  success: (res) => {
    console.log('Selected:', res.name);
    console.log('Address:', res.address);
    console.log('Coordinates:', res.latitude, res.longitude);
    console.log('Province/City:', res.provinceName, res.cityName);
  }
});
```