Pushpin Syntax and Icon Styles

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 5c74ad81-b8be-4674-a0a5-91bf2df38d55
1 [default] 748904ec-4ee4-439a-a692-601a3bf7a239
2 610e10d7-b486-4576-abaa-4a35b4adff48
3 1a999390-a22b-4c76-a6f0-2efb53ccf4c7
4 a7f9fc6f-1215-4b00-98ea-9b3ce24401c0
5 83275ca6-a731-4af5-b29c-42324bed6455
6 14d73593-1c35-4eef-a544-bedb9172092e
7 f0ad0035-d443-45f3-9ba0-2f014134fdc0
8 3714c528-3b4c-45f5-9536-77677f4d9c63
9 f8ea8238-819b-4ba3-8445-5cf667fcf7bc
10 0a4a9d6a-8c16-4401-994c-0ea86f6db8b2
11 c62f5134-da4a-4495-877e-a6aaa2badcec
12 22594e72-b742-47c1-8b16-16969593d73d
13 e6259b02-fff8-46ca-8a08-ef0003ec5a46
14 20ab02d8-0be0-4d74-a070-109cb548ed6d
15 2472e5ef-50e2-4c32-bbb8-4ced383ea673
16 f6f25ac9-b6cf-4554-91f0-dc68318e2aa1
17 c999f081-c6a2-4ba2-a522-42c44cecd57b
18 d9abfbdd-f4d4-4587-ba5c-92dc86642738
19 f313363e-8e84-4fec-b8da-b3ad1ddc7731
20 792d281f-7696-4574-befc-6abb33349438
21 517c88d7-17c8-4f74-89b3-95fd0b28061c
22 016673a3-0282-4dd2-95a9-59395a50f6e7
23 76fee352-3881-4f27-8957-9b1daf1b33b3
24 dc992382-ce01-4fa6-9444-2708c7089c31
25 29127350-aeee-45ae-86d8-ae1b1401bc1a
26 242afc4c-742f-4337-ad5c-890b043ab649
27 6cfcd96c-fa3a-41bc-95ae-a312887c15d7
28 71d658fe-bbe6-4d5b-a003-31168a4df81f
29 2c751486-1ded-421c-be12-cd235576e1ce
30 e1304c66-6e00-4b81-8534-847b9329cc34
31 90196075-92c2-4d1c-a8f4-eebfd681099b
32 5f14de64-bb5f-4410-8909-225d95885205
33 564bed6d-cb69-40f2-88c0-082bc2503f55
34 54d50e0c-5425-4cb1-bbdf-8c3da904b2ce
35 fcefc81e-0d88-4cc9-97ee-dccc26b7ac77
36 4e781e20-4767-4cb5-ae23-a25ae58cab88
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