The geolocation feature has been working on this site (GV Community) since we launched it, but has been notably missing from the rest of the GV family of sites. The reason is we wanted to test it out here and work out all the major technical issues first. Well that's all done and we're ready to get going! Starting today you can add a “geolocation” (coordinates) to any post in the GV network.

Adding a geolocation is easy

Location box in post editor.

• Open the post in the WordPress editor.
• Scroll down to the “Location” box (should be just above excerpt).
• Where it says “Find a new location” type in a city or address.
• Confirm that it guessed right (it's Google Maps so usually it's right) and save your post.

That's it! From now on adding a geolocation to your posts should be part of the normal workflow and almost all posts should be geolocated before publishing.

Guidelines for geolocation

Picking the best coordinates for a post won't always be obvious. Some posts don't really have a location and others involve vague areas or multiple countries. For the time being each posts needs a single specific pin location if they want to show on the map, so do your best to pick something useful.

• Be as specific and precise as possible, if there is a city or neighbourhood please use it rather than the country's capital.
• Avoid using the same spot over and over, the map works best when pins aren't directly on top of each other.
• If there are multiple countries/locations in the post pick the most appropriate one.
• Consider a user clicking the pin and try to find a place that makes sense for the story.
• If there is no clear location for a post don't geolocate it at all.

You can find these guidelines in their permanent location in the GV Posting Guide page on this site.

We're still deciding how to use the locations

Geolocated posts will be visible on a variety of maps throughout the site, but for the time being we won't be showing them to normal users by default. We need to build up a pool of posts with co-ordinates before we start promoting the maps or else they will look empty and give the impression that our coverage isn't as far-ranging as it really is.

In the future we'll promote a big map showing all posts from across the world, just like the one below (which shows posts from this site).  There will also be options to show maps for posts in a specific category or posts located nearby a story the visitor is currently reading.

Inserting a context map inside your posts

On the right you should see the initial option for making use of geolocations: the [gv_map] shortcode. If you use it inside a post it will be replaced with a map that you control with the shortcode's arguments. The shortcode on the right is specifically showing the “single” map, which has just one pin – for the current post – and serves to give context to the reader about where the story takes place.

Notably, the map also has a caption just like an image would have. This is vital for indicating to readers why the map is showing, and if you use this tool you should add some text about the location that contextualizes the story and explains the map.

Here's the code I used to display the map above:

[gv_map map_content='single' align='right']CAPTION TEXT[/gv_map]

• map_content='single': This tells the shortcode to use the “single” mode, which means show only the location of the current post.
• align='right': This tells it to float the map right just like an image. You can also float left or leave this out to show a full-width map.
• CAPTION TEXT: The caption text will be whatever is between the opening [gv_map] and closing [/gv_map] tags. If you don't need a caption you can skip the closing tag entirely.

Thanks for learning a new system and helping us test it!

What do you think? Will this be a useful feature for the main GV site? Will you be adding “single” context maps inside your posts?