Static Map Data

Bing
 

When you use the Get a Static Map API to request static map image metadata, the response returns a Static Map Metadata resource that contains metadata about the static map including the absolute (latitude and longitude) and relative (with respect to the map) coordinates and size of pushpins, as well as the map area, size and center point. When you request static map metadata, the response does not return the map image. This topic contains descriptions of the static map metadata, followed by JSON and XML examples.

For more information about the common response syntax for the Bing Maps REST Services, see Common Response Description.

The following fields are returned when you request image metadata for a static map.

JSON

XML

Type

Description

bbox

BoundingBox

BoundingBox. For more information about the BoundingBox type, see Location and Area Types.

A geographic area that contains the location. A bounding box contains SouthLatitude, WestLongitude, NorthLatitude, and EastLongitude values in units of degrees.

imageWidth

ImageWidth

integer

The width of static map.

imageHeight

ImageHeight

integer

The height of the static map.

mapCenter

MapCenter

Point. For more information about the Point type, see Location and Area Types.

The centerpoint of the static map.

zoom

Zoom

integer

The zoom level of the static map.

pushpinMetadata

PushpinMetadata

collection

A collection of metadata for each pushpin on the static map. See the Pushpin Metadata section below for more information.

If a static map contains pushpins, a request for static map metadata returns following information for each pushpin.

JSON

XML

Type

Description

point

Point

Point. For more information about the Point type, see Location and Area Types.

The latitude and longitude coordinates of the pushpin.

anchor

Anchor

An x (horizontal) and y (vertical) offset in pixels.

The placement of the pushpin on the static map that is defined by an offset in pixels from the upper left hand corner of the map.

topLeftOffset

TopLeftOffset

An x (horizontal) and y (vertical) offset in pixels.

The offset of the top left corner of the pushpin icon with respect to the anchor point.

bottomRightOffset

BottomRightOffset

An x (horizontal) and y (vertical) offset in pixels.

The offset of the bottom right corner of the pushpin icon with respect to the anchor point.

The following examples show the metadata that is returned for a static map. The static map is also shown for reference. When you request metadata for a static map, the map image is not returned.

The following URL gets static map metadata for the map image. The map image is not returned with static map metadata. XML and JSON static metadata responses are shown below.

http://dev.virtualearth.net/REST/v1/Imagery/Map/Road/47.619048,-122.35384/15?mapSize=500,500&pp=47.620495,-122.34931;21;AA&pp=47.619385,-122.351485;;AB&pp=47.616295,-122.3556;22&mapMetadata=1&o=xml&key=BingMapsKey
CenterPoint and ZoomLevel Static Map Example



This example returns the following response.

XML Response

<Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/search/local/ws/rest/v1">
  <Copyright>
    Copyright © 2011 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.
  </Copyright>
  <BrandLogoUri>
    http://dev.virtualearth.net/Branding/logo_powered_by.png
  </BrandLogoUri>
  <StatusCode>200</StatusCode>
  <StatusDescription>OK</StatusDescription>
  <AuthenticationResultCode>ValidCredentials</AuthenticationResultCode>
  <TraceId>
    d7718f0fa2344b23ad73ac2dd8788eec
  </TraceId>
  <ResourceSets>
    <ResourceSet>
      <EstimatedTotal>1</EstimatedTotal>
      <Resources>
        <StaticMapMetadata>
          <BoundingBox>
            <SouthLatitude>47.611833900404896</SouthLatitude>
            <WestLongitude>-122.36456394195557</WestLongitude>
            <NorthLatitude>47.626268662877358</NorthLatitude>
            <EastLongitude>-122.34314918518068</EastLongitude>
          </BoundingBox>
          <MapCenter>
            <Latitude>47.619048</Latitude>
            <Longitude>-122.35384</Longitude>
          </MapCenter>
          <ImageWidth>500</ImageWidth>
          <ImageHeight>500</ImageHeight>
          <Zoom>15</Zoom>
          <Pushpins>
            <PushpinMetadata>
              <Point>
                <Latitude>47.620495</Latitude>
                <Longitude>-122.34931</Longitude>
              </Point>
              <Anchor>
                <X>355</X>
                <Y>200</Y>
              </Anchor>
              <TopLeftOffset>
                <X>12</X>
                <Y>25</Y>
              </TopLeftOffset>
              <BottomRightOffset>
                <X>13</X>
                <Y>2</Y>
              </BottomRightOffset>
            </PushpinMetadata>
            <PushpinMetadata>
              <Point>
                <Latitude>47.619385</Latitude>
                <Longitude>-122.351485</Longitude>
              </Point>
              <Anchor>
                <X>305</X>
                <Y>238</Y>
              </Anchor>
              <TopLeftOffset>
                <X>12</X>
                <Y>28</Y>
              </TopLeftOffset>
              <BottomRightOffset>
                <X>13</X>
                <Y>0</Y>
              </BottomRightOffset>
            </PushpinMetadata>
            <PushpinMetadata>
              <Point>
                <Latitude>47.616295</Latitude>
                <Longitude>-122.3556</Longitude>
              </Point>
              <Anchor>
                <X>209</X>
                <Y>345</Y>
              </Anchor>
              <TopLeftOffset>
                <X>8</X>
                <Y>8</Y>
              </TopLeftOffset>
              <BottomRightOffset>
                <X>8</X>
                <Y>8</Y>
              </BottomRightOffset>
            </PushpinMetadata>
          </Pushpins>
        </StaticMapMetadata>
      </Resources>
    </ResourceSet>
  </ResourceSets>
</Response>

JSON Response

The following response is returned if the output parameter (o=xml) is not specified in the URL or is set to json (o=json).

{
   "authenticationResultCode":"ValidCredentials",
   "brandLogoUri":"http:\/\/dev.virtualearth.net\/Branding\/logo_powered_by.png",
   "copyright":"Copyright © 2011 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",
   "resourceSets":[
      {
         "estimatedTotal":1,
         "resources":[
            {
               "__type":"StaticMapMetadata:http:\/\/schemas.microsoft.com\/search\/local\/ws\/rest\/v1",
               "bbox":[
                  47.611833900404896,
                  -122.36456394195557,
                  47.626268662877358,
                  -122.34314918518068
               ],
               "imageHeight":"500",
               "imageWidth":"500",
               "mapCenter":{
                  "type":"Point",
                  "coordinates":[
                     "47.619048",
                     "-122.35384"
                  ]
               },
               "pushpins":[
                  {
                     "anchor":{
                        "x":"355",
                        "y":"200"
                     },
                     "bottomRightOffset":{
                        "x":"13",
                        "y":"2"
                     },
                     "point":{
                        "type":"Point",
                        "coordinates":[
                           "47.620495",
                           "-122.34931"
                        ]
                     },
                     "topLeftOffset":{
                        "x":"12",
                        "y":"25"
                     }
                  },
                  {
                     "anchor":{
                        "x":"305",
                        "y":"238"
                     },
                     "bottomRightOffset":{
                        "x":"13",
                        "y":"0"
                     },
                     "point":{
                        "type":"Point",
                        "coordinates":[
                           "47.619385",
                           "-122.351485"
                        ]
                     },
                     "topLeftOffset":{
                        "x":"12",
                        "y":"28"
                     }
                  },
                  {
                     "anchor":{
                        "x":"209",
                        "y":"345"
                     },
                     "bottomRightOffset":{
                        "x":"8",
                        "y":"8"
                     },
                     "point":{
                        "type":"Point",
                        "coordinates":[
                           "47.616295",
                           "-122.3556"
                        ]
                     },
                     "topLeftOffset":{
                        "x":"8",
                        "y":"8"
                     }
                  }
               ],
               "zoom":"15"
            }
         ]
      }
   ],
   "statusCode":200,
   "statusDescription":"OK",
   "traceId":"bfc64b786a054288a4b160743ddfec65"
}
Show: