API Reference › Copilot › Map entries

Map entries

Local business and place records that cloro extracts from Microsoft Copilot responses, complete with location, contact, review, and photo details.

Overview

Map entries are not fetched through a dedicated request. Whenever Copilot surfaces local place data for a prompt, cloro parses those results and delivers them inline as a map array on the standard Copilot extraction response. Because the data ships alongside the rest of the answer, you never need to enable a flag or issue a follow-up call — simply inspect the map field when it is present.

The source material originates from Copilot's underlying local-entity provider (largely Google Maps data), and cloro normalizes it into a stable, predictable shape so you can rely on the same field names across queries.

Map entry structure

Each element of the map array describes a single business or place.

Field	Type	Description
name	string	Display name of the business or place.
position	integer	Rank of the entry in the local results, starting at 1.
placeId	string	Google Place identifier for the location.
location	object	Geographic detail for the entry (see Location object).
phoneNumber	string	Publicly listed contact number.
url	string	Official website associated with the business.
reviews	array	Aggregated review summaries by provider (see Review object).
photos	array	Images attributed to the place (see Photo object).
openState	string	Human-readable availability string, for example "Open · Closes 9 PM".
category	string	Classification of the venue, for example "Amusement park".
price	any	Relative price tier when Copilot reports one.
layerLabel	string	Grouping label used to cluster related entries, for example "Theme Parks".

Location object

Field	Type	Description
address	string	Complete street address of the venue.
latitude	number	Latitude coordinate in decimal degrees.
longitude	number	Longitude coordinate in decimal degrees.

Review object

Field	Type	Description
count	integer	Total number of ratings behind the aggregate.
rating	number	Mean score reported by the provider.
providerName	string	Source of the review aggregate, for example "Google".
providerIconUrl	string	Icon representing the review provider, when supplied.
url	string	Link to the full reviews page.

Photo object

Field	Type	Description
url	string	Direct link to the image asset.
altText	string	Descriptive alternate text, when available.
providerName	string	Attribution for the image source.
providerUrl	string	Link back to the provider that hosts the photo.

Response example

{
  "success": true,
  "result": {
    "text": "The Smoky Mountains area has several family-friendly theme parks worth a visit...",
    "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"
      }
    ]
  }
}

Notes

Only name and position are guaranteed on every entry; all other fields are optional and depend on what Copilot exposes for a given business. Guard field access with optional chaining or an existence check before reading nested values. If Copilot returns no local results for a prompt, the map array may be empty or omitted entirely.

Need help interpreting a specific response? Reach out at [email protected].