Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Just a simple utility to convert GeoJSON objects to Google Maps vector objects (Marker, Polyline, Polygon)

branch: master
README.md

GeoJSON to Google Maps

**Read This! **

Google Maps now has proper support for GeoJSON, so you should probably use that instead.

version 1.0

Jason Sanford

Overview

GeoJSON is used to create Google Maps API v3 vectors (Marker, Polyline, Polygon) from GeoJSON objects (Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon, Feature, GeometryCollection, FeatureCollection). Specifically, I'm translating some GeoJSON types to arrays of Google Maps vectors as there aren't really Google Maps equivalents of MultiPoint, MultiLineString, etc.

Constructor Parameters

@param {Object} geojson A valid GeoJSON object. One of Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon, Feature, GeometryCollection, FeatureCollection. See the official GeoJSON spec for more details. GeoJSON examples below.

@param? {Object} options - Optional Options for the specific type of Google Maps vector (Marker, Polyline, Polygon). If none specified, boring black vectors and red markers will be created - Optional. Samples Below.

GeoJSON -> Google Maps equivalents

GeoJSON Type Output
Point google.maps.Point
LineString google.maps.Polyline
Polygon google.maps.Polygon
MultiPoint Array of google.maps.Point
MultiLineString Array of google.maps.Polyline
MultiPolygon Array of google.maps.Polygon
Feature google.maps.[Point,Polyline,Polygon] (depends on Feature geometry type)
FeatureCollection Array of google.maps.[Point,Polyline,Polygon] (depends on Feature geometry type)
GeometryCollection Array of google.maps.[Point,Polyline,Polygon] (depends on geometry type)

GeoJSON Examples

// GeoJSON Point
{
    "type": "Point",
    "coordinates": [
        -80.66252,
        35.04267
    ]
}

// GeoJSON LineString
{
    "type": "LineString",
    "coordinates": [
        [-80.661983228058659, 35.042968081213758],
        [-80.662076494242413, 35.042749414542243],
        [-80.662196794397431, 35.042626481357232],
        [-80.664238981504525, 35.041175532632963]
    ]
}

// GeoJSON Polygon
{
    "type": "Polygon",
    "coordinates": [
        [
            [-80.662120612605904, 35.042875219905184],
            [-80.662141716053014, 35.042832740965068],
            [-80.662171938563816, 35.042789546962993],
            [-80.662209174653029, 35.042750233165179],
            [-80.662250709107454, 35.042716920859959],
            [-80.662627586829899, 35.043072078075667],
            [-80.662595574310288, 35.043162322407341],
            [-80.662142312824884, 35.043015448098977],
            [-80.662145396323511, 35.042970839922489],
            [-80.662117972448982, 35.042908385949438],
            [-80.662120612605904, 35.042875219905184]
        ]
    ]
}

// GeoJSON Feature
{
    "type": "Feature",
    "id": 9876,
    "geometry": {
        "type": "Point",
        "coordinates": [
            -80.66252,
            35.04267
        ]
    },
    "properties": {
        "condition": "Satisfactory",
        "has_garage": false,
        "number_of_bedrooms": 3
    }
}

// GeoJSON FeatureCollection
{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "id": 9876,
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -80.66252,
                    35.04267
                ]
            },
            "properties": {
                "condition": "Satisfactory",
                "has_garage": false,
                "number_of_bedrooms": 3
            }
        },{
            "type": "Feature",
            "id": 9875,
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -80.66262,
                    35.04277
                ]
            },
            "properties": {
                "condition": "Excellent",
                "has_garage": true,
                "number_of_bedrooms": 4
            }
        }
    ]
}

Sample Google Maps Vector Options

// google.maps.Polyline
{
    "strokeColor": "#FFFF00",
    "strokeWeight": 7,
    "strokeOpacity": 0.75
}

// google.maps.Polygon
{
    "strokeColor": "#FF7800",
    "strokeOpacity": 1,
    "strokeWeight": 2,
    "fillColor": "#46461F",
    "fillOpacity": 0.25
}

// google.maps.Marker
{
    "icon": "img/marker-house.png"
}

Error Handling (Invalid GeoJSON)

I've made an attempt to check for properly formatted GeoJSON. If something doesn't look quite right I return a very simple error object.

{
    "error": true,
    "message": "Invalid GeoJSON object: Feature object missing \"properties\" or \"geometry\" member."
}

It would be in your best interest to first check the returned object to see if it's error free.

var myGoogleVector = new GeoJSON(myGeoJSON, options);

if (myGoogleVector.error){
    // Handle the error.
}else{
    myGoogleVector.setMap(myMap);
}
Something went wrong with that request. Please try again.