Pushpin Syntax and Icon Styles

Note

Bing Maps Get a Static Map API retirement

Bing Maps Get a Static Map API is deprecated and will be retired. Free (Basic) account customers can continue to use Bing Maps Get a Static Map API until June 30th, 2025. Enterprise account customers can continue to use Bing Maps Get a Static Map API until June 30th, 2028. To avoid service disruptions, all implementations using Bing Maps Get a Static Map API will need to be updated to use Azure Maps Get Map Static Image API by the retirement date that applies to your Bing Maps for Enterprise account type.

Azure Maps is Microsoft's next-generation maps and geospatial services for developers. Azure Maps has many of the same features as Bing Maps for Enterprise, and more. To get started with Azure Maps, create a free Azure subscription and an Azure Maps account. For more information about azure Maps, see Azure Maps Documentation. For migration guidance, see Bing Maps Migration Overview.

Pushpins identify locations on a map. You can specify an icon style and a label for a pushpin, in addition to its location.

Note

You can specify up to 18 pushpins within a Get a Static Map URL that uses HTTP GET protocol. However, if you use the HTTP POST method option, you can specify up to 100 pushpins by inserting them into the request body. See the HTTP POST Syntax section below for information about how to format the pushpins in a request body. The Get a Static Map topic provides more details and an example.

The following table shows the syntax to use to specify a pushpin location.

pushpin=latitude,longitude;iconStyle;label

You can use the alias pp if you do not want to spell out pushpin.

A latitude and a longitude are required. You can optionally specify an icon style and a label for the pushpin. A length of a label string is limited to three characters.

The following table shows the options for specifying a pushpin.

Description Syntax
Specify a pushpin location. latitude,longitude

Example: pushpin=47.620548,-122.34874
Specify a pushpin location and an icon style. latitude,longitude;iconStyle

Example: pushpin=47.620548,-122.34874;5
Specify a pushpin location and a label. latitude,longitude;;label

Note: The order of the syntax requires that if you specify a label without specifying an icon style, you must preserve the syntax and put two semi-colons between the coordinates and the label.

Example: pushpin=47.620548,-122.34874;;P10
Specify a pushpin location, an icon style, and a label. latitude,longitude;iconStyle;label

Note: A label can have up to three (3) characters.

Example: pushpin=47.620548,-122.34874;5;P10

HTTP POST Syntax

If you use the HTTP POST method for specifying pushpins on a static map, you must include the pushpins in the body of the request.

When specifying multiple pushpins in the request body, you must the ampersand character (&) or a carriage return (\r\n) as a delimiter. Pushpins that follow a carriage return (appear on a new line) do not have ampersands.

The following examples show how to specify pushpins in the body of an HTTP POST request. For more information about this type of request, see Get a Static Map.

Examples

Example 1

pp=38.889586530732335,-77.05010175704956;23;LMT\r\n  
pp=38.88772364638439,-77.0472639799118;7;KMT\r\n  
pp=38.890479451480054,-77.04744637012482;1;VMT\r\n  
pp=38.8896854931628,-77.03519403934479;45;WMT  

Example 2

pp=38.889586530732335,-77.05010175704956;23;LMT&pp=38.88772364638439,-77.0472639799118;7;KMT\r\n  
pp=38.890479451480054,-77.04744637012482;1;VMT&pp=38.8896854931628,-77.03519403934479;45;WMT  

Icon Styles

The following table shows the available pushpin icon styles.

IconStyle Icon
0 Image that shows a red star as the pushpin icon style
1 [default] Image that shows a large dark blue box as the pushpin icon style
2 Image that shows a medium-sized dark blue box as the pushpin icon style
3 Image that shows a small dark blue box as the pushpin icon style
4 Image that shows a large two-tone dark blue and light blue box as the pushpin icon style
5 Image that shows a medium-sized two-tone dark blue and light blue box as the pushpin icon style
6 Image that shows a small two-tone dark blue and light blue box as the pushpin icon style
7 Image that shows a large red box as the pushpin icon style
8 Image that shows a medium-sized red box as the pushpin icon style
9 Image that shows a small red box as the pushpin icon style
10 Image that shows a large two-tone dark red and light red box as the pushpin icon style
11 Image that shows a medium-sized two-tone dark red and light red box as the pushpin icon style
12 Image that shows a small two-tone dark red and light red box as the pushpin icon style
13 Image that shows a mid-sized dark blue and purple box as the pushpin icon style
14 Image that shows a dark blue sphere as the pushpin icon style
15 Image that shows a dark blue circle as the pushpin icon style
16 Image that shows a green circle as the pushpin icon style
17 Image that shows a yellow exclamation point road sign as the pushpin icon style
18 Image that shows an orange exclamation point road sign as the pushpin icon style
19 Image that shows a red exclamation point road sign as the pushpin icon style
20 Image that shows a two-tone light blue box as the pushpin icon style
21 Image that shows a small orange box with an upside down arrow as the pushpin icon style
22 Image that shows a red circle as the pushpin icon style
23 Image that shows a large two-tone orange box as the pushpin icon style
24 Image that shows a mid-sized orange box with an upside down arrow as the pushpin icon style
25 Image that shows a medium-sized orange box with an upside down arrow as the pushpin icon style
26 Image that shows a two-tone green box as the pushpin icon style
27 Image that shows a two-tone purple box as the pushpin icon style
28 Image that shows a two-tone red box as the pushpin icon style
29 Image that shows a circle with a green bus within it as the pushpin icon style
30 Image that shows a circle with a front-facing blue bus within it as the pushpin icon style
31 Image that shows a circle with two arrows within it as the pushpin icon style
32 Image that shows a dark blue and light blue box as the pushpin icon style
33 Image that shows a white circle with a green circle within it as the pushpin icon style
34 Image that shows a large white circle with an orange circle within it as the pushpin icon style
35 Image that shows a large green box projecting from a small black circle as the pushpin icon style
36 Image that shows a large white circle with a green circle within it as the pushpin icon style
37 Pushpin Icon Style 37
38 Pushpin Icon Style 38
39 Pushpin Icon Style 39
40 Pushpin Icon Style 40
41 Pushpin Icon Style 41
42 Pushpin Icon Style 42
43 Pushpin Icon Style 43
44 Pushpin Icon Style 44
45 Pushpin Icon Style 45
46 Pushpin Icon Style 46
47 Pushpin Icon Style 47
48 Pushpin Icon Style 48
49 Pushpin Icon Style 49
50 Pushpin Icon Style 50
51 Pushpin Icon Style 51
52 Pushpin Icon Style 52
53 Pushpin Icon Style 53
54 Pushpin Icon Style 54
55 Pushpin Icon Style 55
56 Pushpin Icon Style 56
57 Pushpin Icon Style 57
58 Pushpin Icon Style 58
59 Pushpin Icon Style 59
60 Pushpin Icon Style 60
61 Pushpin Icon Style 61
62 Pushpin Icon Style 62
63 Pushpin Icon Style 63
64 Pushpin Icon Style 64
65 Pushpin Icon Style 65
66 Pushpin Icon Style 66
67 Pushpin Icon Style 67
68 Pushpin Icon Style 68
69 Pushpin Icon Style 69
70 Pushpin Icon Style 70
71 Pushpin Icon Style 71
72 Pushpin Icon Style 72
73 Pushpin Icon Style 73
74 Pushpin Icon Style 74
75 Pushpin Icon Style 75
76 Pushpin Icon Style 76
77 Pushpin Icon Style 77
78 Pushpin Icon Style 78
79 Pushpin Icon Style 79
80 Pushpin Icon Style 80
81 Pushpin Icon Style 81
82 Pushpin Icon Style 82
83 Pushpin Icon Style 83
84 Pushpin Icon Style 84
85 Pushpin Icon Style 85
86 Pushpin Icon Style 86
87 Pushpin Icon Style 87
88 Pushpin Icon Style 88
89 Pushpin Icon Style 89
90 Pushpin Icon Style 90
91 Pushpin Icon Style 91
92 Pushpin Icon Style 92
93 Pushpin Icon Style 93
94 Pushpin Icon Style 94
95 Pushpin Icon Style 95
96 Pushpin Icon Style 96
97 Pushpin Icon Style 97
98 Pushpin Icon Style 98
99 Pushpin Icon 99
100 Pushpin Icon 100
101 Pushpin Icon 101
102 Pushpin Icon 102
103 Pushpin Icon 103
104 Pushpin Icon 104
105 Pushpin Icon 105
106 Pushpin Icon 106
107 Pushpin Icon 107
108 Pushpin Icon 108
109 Pushpin Icon 109
110 Pushpin Icon 110
111 Pushpin Icon 111
112 Pushpin Icon 112
113 Pushpin Icon 113
114 Pushpin Icon 14
115 Pushpin Icon 115
116 Pushpin Icon 116
117 Pushpin Icon 117
118 Pushpin Icon 118
119 Pushpin Icon 119
120 Pushpin Icon 20
121 Pushpin Icon 121
122 Pushpin Icon 122
123 Pushpin Icon 123
124 Pushpin Icon 124
125 Pushpin Icon 125
126 Pushpin Icon 126
127 Pushpin Icon 127
128 Pushpin Icon 128
129 Pushpin Icon 129
130 Pushpin Icon 130
131 Pushpin Icon 131
132 Pushpin Icon 132
133 Pushpin Icon 133
134 Pushpin Icon 134
135 Pushpin Icon 135
136 Pushpin Icon 136