Build your own URL for Live Maps

Defines the version of the URL API (Application Programming Interface. The language used by an application program to communicate with a computer's operating system.) . When used, you should always assign the value of 2 to this parameter. If you omit this parameter, the latest version of the API is used by default.

Defines where the center of the map should be. Use the following format for the cp parameter:

Latitude~Longitude

Defines the zoom level of the map view in 2D view. Valid values are 1–19. This parameter is ignored if you don't include the cp parameter.

Defines the zoom level of the map view in 3D view. The value you apply to this parameter equals the number of meters above sea level that you want the zoom level to be at. For example, alt=1000 sets the zoom level at 1000 meters above sea level. Valid values are 0 to 20,000,000.

Defines the map view. Valid values for this parameter include:

• a: Used to display an aerial view of the map.
• r: Used to display a road view of the map.
• h: Used to display the hybrid view of the map.
• o: Used to display the bird's eye (oblique) view of the map.

Specifies the ID of the bird's eye (oblique) image tile to display; used to choose a specific view or angle.

Defines a location to center the map based on a specific address or a place name. The text is the same text that you type in the upper search box in Live Maps to search for a specific address or place name.

Defines the searches that you want to display. Use this parameter to display search results for a business, person or collection.

You can add a prefix to each search string that specifies whether the search is a yellow pages search (for business listings), a white pages search (for individuals), or a collection (for community generated data). Use the yp. prefix for yellow pages searches, the wp. prefix for white pages searches, and the Cl. prefix for collections. If you do not specify a prefix, a yellow pages search is performed by default.

You can add a prefix to each search string that specifies whether the search sort is displayed by relevance, distance, rating, or page number. Use the following values to define the type of sort you want:

• 0 = Relevance
• 1 = Distance
• 2 = Rating

Defines the start and end of a route to draw on the map, each separated by a tilde (~). Each of the waypoints (Coordinates that identify a point on the map.) are defined by either a pos (position) or adr (address) identifier, described below.

A complete route contains at least two waypoints. For example, a route with two waypoints is defined by the following:

rtp="A"~"B"

rtp="A"~

rtp=~"B"

Defines a waypoint as a specific position on the map. Use the following format:

rtp=pos.latitude_longitude_name

Defines a waypoint as an address. Use the following format:

rtp=adr.address

Defines options for the route. There are three possible options, each separated by ~. The default value of non-abbreviated route, quickest without traffic will be used if not specified.

• 0 = Quickest
• 1 = Shortest
• 0 = Don't use traffic
• 1 = Use traffic
• 0 = No abbreviation
• E = End only
• S = Start Only

This is an optional parameter that specifies the start view for a route. Use the following format:

rtv=1

• 0 = Show all (default)
• 1 = Start from the first direction
• 2 = Start from the second direction
• 3 = Start from the third direction
• 4 = Start from the fourth direction

Defines a specific entity, address, or pushpin (A marker containing information such as notes and links, which you can place at a specific point on a map.) to add to the collections editor.

Collections editor items are defined as a pairing: the category and the value, separated by a period. There are six valid categories: adr, an, point, polyline, polygon,and yp. These are described in the next table.

Separate multiple collections editor items with tildes (~). If the item you specify contains a tilde, make sure the tilde is encoded as %7E.

Specifies the collection that you want to display by using the ID assigned to that collection. For the collection ID parameter, use the following format:

cid=collection ID

Displays a collection of items by using the location specified in the URL. For the map URL parameter, use the following format:

mapurl=url

Displays the viewer's Favorites, if they are signed in to Live Maps. If the viewer isn't signed in to Live Maps, they will receive a notification to sign in. To enable the fave parameter, use the following format:

fave=1

Forces Live Maps to open in exploration task mode. There are three ways to sort results in explore mode:

• 1 = Distance
• 3 = Static rank
• 4 = Chronological

For the explore parameter, use the following format:

explore= sst.sorttype
~tag.tagstring

Displays a collection in 3D tour mode. There are two options for how to display the tour that is loaded:

• 0 = Loads the collection tour in a paused state
• 1 = Loads the collection tour in an automatic playing state

Specifies an address to add to the collections editor. For the address, the value can be the address string, the address string and title, or the address string, title, and description:

sp=adr.addressString

sp=adr.addressString_title

sp=adr.addressString_title_description

Make sure that the addresses you provide are as specific as possible.

Specifies a point to add to the collections editor by using latitude and longitude. For points, the value includes the latitude, longitude, title, notes, link URL, and photo URL to display, separated by underscores (_):

sp=point.position_
title string_notes,
string_link URL_photo URL

Specifies a point to add to the collections editor by using the vertex positions on the map. For polylines, the value includes the latitude, longitude, title, notes, link URL, photo URL, fill color, line color, line weight, and line style to display, separated by underscores (_):

sp=polyline.vertex positions_title string_notes string_link URL_photo URL_fill color_line color_line weight_line style_label position

Specifies a point to add to the collections editor by using the vertex positions on the map. For polygons, the value includes the latitude, longitude, title, notes, link URL, photo URL, fill color, line color, line weight, and line style to display, separated by underscores (_):

sp=polygon.vertex positions_title string_notes string_link URL_photo URL_fill color_line color_line weight_line style_label position

Specifies yellow page listings. For yellow page listings, the value is a valid yellow pages entity id:

sp=yp.listingID