Microsoft Copilot map entries schema

This section documents the map entries data returned by the Microsoft Copilot endpoint. Map entries are part of the Copilot response, so no separate API call is needed. For use cases, pricing context, and copy-paste examples, see the Copilot shopping API page on the product site — it documents map entries alongside shopping cards.

Example request

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

{
  "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.

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

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

Response with map entries:

{
  "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"
      }
    ]
  }
}

All fields are optionalExcept 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.

Overview

ChatGPT

Google

Perplexity

Copilot

AI Mode

Grok

Gemini

Google News

Utilities

Microsoft Copilot map entries schema

Example request

Overview

Map entry structure

Location object

Review object

Photo object

Example usage

​Example request

​Overview

​Map entry structure

​Location object

​Review object

​Photo object

​Example usage

Example request

Overview

Map entry structure

Location object

Review object

Photo object

Example usage