path()

path(object[, arguments…])

Renders the given object, which may be any GeoJSON feature or geometry object:

• Point - a single position.
• MultiPoint - an array of positions.
• LineString - an array of positions forming a continuous line.
• MultiLineString - an array of arrays of positions forming several lines.
• Polygon - an array of arrays of positions forming a polygon (possibly with holes).
• MultiPolygon - a multidimensional array of positions forming multiple polygons.
• GeometryCollection - an array of geometry objects.
• Feature - a feature containing one of the above geometry objects.
• FeatureCollection - an array of feature objects.

The type Sphere is also supported, which is useful for rendering the outline of the globe; a sphere has no coordinates. Any additional arguments are passed along to the pointRadius accessor.

To display multiple features, combine them into a feature collection:

svg.append("path")
    .datum({type: "FeatureCollection", features: features})
    .attr("d", d3.geoPath());

Or use multiple path elements:

svg.selectAll("path")
  .data(features)
  .enter().append("path")
    .attr("d", d3.geoPath());

Separate path elements are typically slower than a single path element. However, distinct path elements are useful for styling and interation (e.g., click or mouseover). Canvas rendering (see path.context) is typically faster than SVG, but requires more effort to implement styling and interaction.