34 | {$duration} min
35 | {/if}
36 |
28 |
32 |
33 |
34 |
42 | Codelabs > Build Google Maps Using Web Components & No Code!
60 | 61 |Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur quis dolor vel arcu blandit tristique. Proin vestibulum nec felis non fringilla. Pellentesque vulputate dui ut risus bibendum, sed egestas arcu ullamcorper. Quisque eget eros pellentesque, aliquet tortor placerat, vehicula lectus. Fusce sit amet mattis turpis, et tempus orci. Vestibulum mauris velit, vulputate a risus quis, imperdiet hendrerit ante. Nunc sollicitudin risus tortor, ac venenatis sem volutpat malesuada. Mauris neque metus, ornare eget porta id, tincidunt vitae magna. In scelerisque quam auctor maximus pellentesque. Sed laoreet ex mi, vel lacinia urna consectetur id. Sed est quam, finibus eget orci in, vulputate tempus diam
62 | 63 |
In this codelab, You'll create a fully working Google Maps app using elements in Polymer's Google Web Components collection. The app will be responsive, include driving directions, and transit a mode. Along the way, you'll also learn about Polymer's data-binding features and iron element set.
75 |What you'll learn
76 |-
77 |
- How to start a new Polymer-based project using Chrome Dev Editor 78 |
- How to use elements in Polymer's iron, paper, and Google Web Component sets. 79 |
- How to use Polymer's data binding features to reduce boilerplate code. 80 |
What you'll need
82 |-
83 |
- Basic understanding of HTML, CSS, and web development. 84 |
- Install Chrome Dev Editor or use your own editor of choice. 85 |
How would rate your experience with Polymer?
87 |Create a new project
94 | 95 | 97 |The first time you run Chrome Dev Editor it will ask you to setup your workspace environment.
Fire up Chrome Dev Editor and start a new project:
-
98 |
- Click
to start a new project.
99 | - Enter "PolymerMapsCodelab" as the Project name. 100 |
- In the Project type dropdown, select "JavaScript web app (using Polymer paper elements)". 101 |
- Click the Create button. 102 |
Chrome Dev Editor creates a basic scaffold for your Polymer app. In the background, it also uses Bower to download and install a list of dependencies (including the Polymer core library) into the bower_components/ folder. Fetching the components make take some time if your internet connection is slow. You'll learn more about using Bower in the next step.
bower.json
104 | 105 |PolymerMapsCodelab/
106 | bower_components/ <!-- installed dependencies from Bower -->
107 | bower.json <!-- Bower metadata files used for managing deps -->
108 | index.html <!-- your app -->
109 | main.js
110 | styles.cssPreview the app
113 |At any point, select the index.html file and hit the 
button in the top toolbar to run the app. Chrome Dev Editor fires up a web server and navigates to the index.html page. This is great way to preview changes as you make them.
Next up
115 |At this point the app doesn't do much. Let's add a map!
116 | 117 |The Google Web Components provide the <google-map> element for declaratively rendering a Google Map. To use it, you first need to install it using Bower.
Install the element
126 | Normally, you'd run bower install GoogleWebComponents/google-map --save on the command line to install <google-map> and save it as a dependency. However, Chrome Dev Editor does not have a command line for running Bower commands. Instead, you need to manually edit bower.json to include google-map, then run Chrome Dev Editor's Bower Update feature. Bower Update checks the dependencies in bower.json and installs any missing ones.
- Edit
bower.jsonand addgoogle-mapto thedependenciesobject:
"dependencies": {
128 | "iron-elements": "PolymerElements/iron-elements#^1.0.0",
129 | "paper-elements": "PolymerElements/paper-elements#^1.0.1",
130 | "google-map": "GoogleWebComponents/google-map#^1.0.3"
131 | }-
133 |
- Right-click the
bower.jsonfilename in the editor.
134 | - Select Bower Update from the context menu. 135 |
The download may take few seconds. You can verify that <google-map> (and any dependencies) were installed by checking that bower_components/google-map/ was created and populated.
Use the element
137 | To employ <google-map>, you need to:
-
138 |
- Use an HTML Import to load it in
index.html.
139 | - Declare an instance of the element on the page. 140 |
In index.html, remove all other HTML imports in the <head> and replace them with a single import that loads google-map.html:
index.html
142 | 143 |<head>
144 | ....
145 | <script src="bower_components/webcomponentsjs/webcomponents-lite.min.js"></script>
146 | <link rel="import" href="bower_components/google-map/google-map.html">
147 | </head>Next, replace the contents of <body> with an instance of <google-map>:
index.html
152 | 153 |<body unresolved>
154 | <google-map latitude="37.779" longitude="-122.3892" zoom="13"></google-map>
155 | </body>As you can see, using <google-map> is completely declarative! The map is centered using the latitude and longitude attributes and its zoom level is set by the zoom attribute.
Style the map
158 |If you run the app right now, nothing will display. In order for the map to properly display itself, you need to set its container (in this case, <body>) to have a fixed height.
Open styles.css and replace its contents with default styling:
styles.css
160 | 161 |body, html {
162 | font-family: 'Roboto', Arial, sans-serif;
163 | height: 100%;
164 | margin: 0;
165 | }Add a marker
168 |<google-map> supports adding map markers to the map by declaring <google-map-marker> elements as children. The marker locations are also set using latitude and longitude attributes.
Back in index.html, add a draggable <google-map-marker> to the map:
index.html
170 | 171 |<google-map latitude="37.779" longitude="-122.3892" zoom="13" disable-default-ui>
172 | <google-map-marker latitude="37.779" longitude="-122.3892"
173 | title="Go Giants!" draggable="true"></google-map-marker>
174 | </google-map>Notice that we've also disabled the map's controls by setting disableDefaultUi to true. Since it's a boolean property, its presence as an HTML attribute makes it truthy.
Run the app
177 |If you haven't already done so, hit the 
button. At this point, you should see a map that takes up the entire viewport and has a single marker pin.
Frequently Asked Questions
179 | 181 | 182 |Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur quis dolor vel arcu blandit tristique. Proin vestibulum nec felis non fringilla. Pellentesque vulputate dui ut risus bibendum, sed egestas arcu ullamcorper. Quisque eget eros pellentesque, aliquet tortor placerat, vehicula lectus. Fusce sit amet mattis turpis, et tempus orci. Vestibulum mauris velit, vulputate a risus quis, imperdiet hendrerit ante. Nunc sollicitudin risus tortor, ac venenatis sem volutpat malesuada. Mauris neque metus, ornare eget porta id, tincidunt vitae magna. In scelerisque quam auctor maximus pellentesque. Sed laoreet ex mi, vel lacinia urna consectetur id. Sed est quam, finibus eget orci in, vulputate tempus diam
187 | 188 |