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

# Places Near Me

> Manage physical branch locations and automatically calculate and send the closest store to WhatsApp contacts in automated flows.

**Places Near Me** allows you to manage physical store branches, service centers, and points of interest. When integrated into your automated flows, the system uses the contact's live shared location to compute distances using the Haversine formula and automatically delivers the closest branch location pin directly inside WhatsApp.

> [card] Branch Management
>
> Store and categorize physical addresses, geographical coordinates (latitude and longitude), and branch names.

> [card] Smart Coordinate Paste
>
> Quickly paste combined coordinates copied directly from Google Maps into the latitude field for automatic coordinate splitting.

> [card] Category Priority Ranking
>
> Organize locations into functional categories with custom rank priorities to control which branch types get recommended.

> [card] Flow Automation on WhatsApp
>
> Pair with the Get User Data block to detect customer coordinates and send native interactive WhatsApp map pins instantly.

## Access Places Near Me

To access the Places Near Me tool:

**1. Open Tools**

Click **Tools** in the left navigation sidebar.

**2. Select Places Near Me**

Click the **Places Near Me** card to open the management page.

![Tools Places Near Me Navigation](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/tools_places_near_me_navigation.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=ae19c60ede5af5d47ff63413433880a1)

## Manage locations

The **Locations** tab displays all your business locations along with their assigned category and coordinates:

![Places Near Me Locations Tab](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/places_near_me_locations_tab.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=123779182f9f704909501f1047954975)

The table displays:

* **Name**: The name of the store or branch.
* **Coordinates**: The latitude and longitude of the location.
* **Category**: The assigned classification group.

Use the search bar at the top to filter locations by name. Click the three-dots (**...**) menu on any row to perform these actions:

* **Edit**: Update the location name, coordinates, or category.
* **Preview**: Open Google Maps in a new browser tab centered at the exact coordinates to verify the pin placement.
* **Delete**: Remove the location from your workspace.

### Add a new location

Click the **+ Add location** button at the top right of the Locations tab:

![Places Near Me Add Location Modal](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/places_near_me_add_location_modal.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=f13ce52a14dd072b54d514efd69e4800)

Complete the following fields:

* **Name**: Enter the branch or store name (for example, *Downtown Flagship Store* or *Westside Service Hub*).
* **Latitude and Longitude**: Specify the geographical coordinates in decimal format.
* **Category**: Choose a category from the dropdown menu to classify this location.

> [!TIP]
>
> **Smart Paste feature**: When you copy coordinates directly from Google Maps (for example, `10.776889, 106.700806`), paste the entire string directly into the **Latitude** field. ChatbotX automatically parses the string, sets the latitude, and fills the **Longitude** field for you.

Click **Save** to add the location.

## Manage location categories

The **Categories** tab allows you to group locations by business function, such as Retail Stores, Cafes, Pick-up Points, or Support Centers:

![Places Near Me Categories Tab](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/places_near_me_categories_tab.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=beb859676c4ca03776498f6e4508ab57)

The categories table displays:

* **Name**: The category name.
* **Rank**: The priority rank assigned to this category (lower numerical values represent higher priority).
* **Locations**: The count of active locations assigned to this category.

Click the three-dots (**...**) menu to edit the category name and rank, or delete the category.

### Add a new category

Click the **+ Add category** button:

![Places Near Me Add Category Modal](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/places_near_me_add_category_modal.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=3cf938de9e75bbb3c6961c29462530e8)

* **Name**: Enter the category title.
* **Rank**: Enter an integer value defining the priority rank (defaults to `10`). When sorting and filtering locations in actions, lower numbers take precedence.

Click **Save** to create the category.

## Configure Find Places Near Me in Flow Builder

You can use the **Find places near me** action inside Flow Builder to automatically route customers to their closest branch based on their live location.

![Places Near Me Flow Builder Action](https://mintcdn.com/chatbotx/GzuAgGIK3pIf0DeS/images/places_near_me_flow_builder_action.png?fit=max\&auto=format\&n=GzuAgGIK3pIf0DeS\&q=85\&s=d635eb40bb67119d448c49fefe17fa27)

### Flow prerequisites

Before calling the action, your flow must request and store the contact's geographical location:

1. Add a **Get User Data** block in your flow prior to the action step.
2. Set the **Reply Format** to **Location**.
3. Choose a **Contact Custom Field** to store the incoming coordinates.
4. When the user taps the location sharing button in chat, their latitude and longitude are recorded into the custom field.

> [!WARNING]
>
> If the flow does not collect the user's location beforehand, the action cannot compute distances. ChatbotX displays a yellow alert in the action editor: *"Make sure you collect the user's location using the Get User Data block before executing this action."*

### Set up the action step

1. In your flow, add a new **Perform Action** block.
2. Expand the **More options** section and select **Find places near me**.
3. Configure the following parameter:
   * **Location category**: Select a specific category from the dropdown (such as *Flagship Stores*) to recommend only locations within that group, or select **All locations** to search across all branches.
4. Connect the output to your subsequent flow messages or follow-up interactions.

### WhatsApp native location delivery

The **Find places near me** action is optimized specifically for **WhatsApp**:

* **Haversine distance calculation**: The system calculates the shortest geodesic distance between the customer's shared location and every registered location within the selected category.
* **Native WhatsApp map pin**: ChatbotX automatically transmits a native WhatsApp location card containing the branch name, address details, and an interactive map pin that opens Google Maps or Apple Maps with one tap for instant navigation.
* **Other messaging channels**: The built-in native pin transmission is designed for WhatsApp contacts. For other channels (such as Messenger or Telegram), you can provide store directory links or use AI Agents to share branch addresses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.