Skip to main content
This section documents the map entries data returned by the Microsoft Copilot endpoint. Map entries are part of the Copilot response — no separate API call is needed.

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:
FieldTypeDescription
namestringBusiness name
positionintegerPosition in results (1-indexed)
placeIdstringGoogle Place ID
locationobjectBusiness location with address, latitude, longitude
phoneNumberstringContact phone number
urlstringBusiness website URL
reviewsarrayReview aggregations from providers
photosarrayBusiness photos
openStatestringCurrent open/closed status (e.g. “Open · Closes 9 PM”)
categorystringBusiness category (e.g. “Amusement park”)
priceanyPrice level (if available)
layerLabelstringMap layer grouping label (e.g. “Theme Parks”)

Location object

FieldTypeDescription
addressstringFull street address
latitudenumberGPS latitude
longitudenumberGPS longitude

Review object

FieldTypeDescription
countintegerNumber of reviews
ratingnumberAverage rating
providerNamestringReview provider (e.g. “Google”)
providerIconUrlstringProvider icon URL
urlstringReviews page URL

Photo object

FieldTypeDescription
urlstringPhoto URL
altTextstringAlt text for the photo
providerNamestringPhoto provider name
providerUrlstringPhoto 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.