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

# Map entries

> Schema for business and place entries returned by the Microsoft Copilot endpoint, including names, ratings, reviews, photos, contact details, and addresses.

This section documents the **map entries** data returned by the [Microsoft Copilot endpoint](/api-reference/endpoint/monitor-copilot). Map entries are part of the Copilot response, so no separate API call is needed.

## Example request

Map entries are returned by default when Copilot surfaces local business data. No flag is required.

```json theme={null}
{
  "prompt": "theme parks with craft activities near Smoky Mountains",
  "country": "US"
}
```

This produces a response containing the `map` array documented below.

## Overview

Map entries are auto-extracted from Copilot's local entity data (primarily Google). No additional parameters are required. Map entries are included by default when available in the response.

<Frame caption="Map entries in Copilot">
  <img src="https://mintcdn.com/cloro/Qv2xgJAgMecwTTRq/images/copilot/map-entries.webp?fit=max&auto=format&n=Qv2xgJAgMecwTTRq&q=85&s=2ceeb3f05a00eb83a077cc79fd450d8a" alt="Map entries in Copilot" width="737" height="688" data-path="images/copilot/map-entries.webp" />
</Frame>

## Map entry structure

Each map entry contains business information using Copilot's native structure:

| Field         | Type    | Description                                               |
| ------------- | ------- | --------------------------------------------------------- |
| `name`        | string  | Business name                                             |
| `position`    | integer | Position in results (1-indexed)                           |
| `placeId`     | string  | Google Place ID                                           |
| `location`    | object  | Business location with `address`, `latitude`, `longitude` |
| `phoneNumber` | string  | Contact phone number                                      |
| `url`         | string  | Business website URL                                      |
| `reviews`     | array   | Review aggregations from providers                        |
| `photos`      | array   | Business photos                                           |
| `openState`   | string  | Current open/closed status (e.g. "Open · Closes 9 PM")    |
| `category`    | string  | Business category (e.g. "Amusement park")                 |
| `price`       | any     | Price level (if available)                                |
| `layerLabel`  | string  | Map layer grouping label (e.g. "Theme Parks")             |

### Location object

| Field       | Type   | Description         |
| ----------- | ------ | ------------------- |
| `address`   | string | Full street address |
| `latitude`  | number | GPS latitude        |
| `longitude` | number | GPS longitude       |

### Review object

| Field             | Type    | Description                     |
| ----------------- | ------- | ------------------------------- |
| `count`           | integer | Number of reviews               |
| `rating`          | number  | Average rating                  |
| `providerName`    | string  | Review provider (e.g. "Google") |
| `providerIconUrl` | string  | Provider icon URL               |
| `url`             | string  | Reviews page URL                |

### Photo object

| Field          | Type   | Description            |
| -------------- | ------ | ---------------------- |
| `url`          | string | Photo URL              |
| `altText`      | string | Alt text for the photo |
| `providerName` | string | Photo provider name    |
| `providerUrl`  | string | Photo provider URL     |

## Example usage

```json theme={null}
{
  "prompt": "theme parks with craft activities near Smoky Mountains",
  "country": "US"
}
```

**Response with map entries:**

```json theme={null}
{
  "success": true,
  "result": {
    "text": "Yes, the Smoky Mountains have several family-friendly theme parks...",
    "sources": [
      {
        "position": 1,
        "label": "WonderWorks Pigeon Forge",
        "url": "http://www.wonderworksonline.com/pigeon-forge/",
        "description": null
      }
    ],
    "shoppingCards": [],
    "map": [
      {
        "name": "WonderWorks Pigeon Forge",
        "position": 1,
        "placeId": "ChIJEYpTsk__W4gR2sQLGzOjE3o",
        "location": {
          "address": "100 Music Rd, Pigeon Forge, TN 37863",
          "latitude": 35.823257,
          "longitude": -83.5787498
        },
        "phoneNumber": "(865) 868-1800",
        "url": "http://www.wonderworksonline.com/pigeon-forge/",
        "reviews": [
          {
            "count": 10625,
            "rating": 4.3,
            "providerName": "Google",
            "providerIconUrl": null,
            "url": "https://maps.google.com/?cid=8796553937077126362"
          }
        ],
        "photos": [
          {
            "url": "https://lh3.googleusercontent.com/gps-cs-s/example",
            "altText": null,
            "providerName": null,
            "providerUrl": "https://maps.google.com"
          }
        ],
        "openState": "Open · Closes 9 PM",
        "category": "Amusement park",
        "price": null,
        "layerLabel": "Theme Parks"
      },
      {
        "name": "Anakeesta",
        "position": 2,
        "placeId": "ChIJ0_BT8DxWWYgR4JxBzZpLjH4",
        "location": {
          "address": "576 Parkway, Gatlinburg, TN 37738",
          "latitude": 35.713083,
          "longitude": -83.5117751
        },
        "phoneNumber": "(865) 325-2400",
        "url": "https://www.anakeesta.com/",
        "reviews": [
          {
            "count": 15738,
            "rating": 4.2,
            "providerName": "Google",
            "providerIconUrl": null,
            "url": "https://maps.google.com/?cid=9118746473759087840"
          }
        ],
        "photos": [
          {
            "url": "https://lh3.googleusercontent.com/gps-cs-s/example",
            "altText": null,
            "providerName": null,
            "providerUrl": "https://maps.google.com"
          }
        ],
        "openState": "Open · Closes 8 PM",
        "category": "Theme park",
        "price": null,
        "layerLabel": "Theme Parks"
      }
    ]
  }
}
```

<Warning>
  **All fields are optional**

  Except for `name` and `position`, all fields in map entries are optional. Use optional chaining (`?.`) or check for field existence before accessing. Field availability depends on what data is available for each business.
</Warning>