ggmap

4.0.2

Spatial Visualization with ggplot2

32packages depend

296.5Kdownloads / year

14.6%test coverage

13/13checks pass

Overview

About

Maintained by David KahleFirst published 2011-11-3022 releasesCRAN page ↗GitHub ↗

A collection of functions to visualize spatial data and models on top of static maps from various online sources (e.g Google Maps and Stamen Maps). It includes tools common to those tasks, including functions for geolocation and routing.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("ggmap", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("dkahle/ggmap")

Development version from dkahle/ggmap. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-ggmap

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-ggmap

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-ggmap

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 2.9 min · r-devel-linux-x86_64-fedora-clang

Code health

Yes

Tests · ratio 0.01

14.6%

Coverage · measured lines

98%

Documentation · exports

Dependencies · direct

Check history

OK2026-06-09
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-06-08
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-04-25
12 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
NOTE2026-03-10
13 OK · 1 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 987 wordsVignettesNopkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 37%
Documented parameters: 89%
Return-value docs: 65%
References docs: 7%

Downloads

296.5K

CRAN downloads in the past year

Rank #794 · ~812/day · ~24.7K/mo

Releases R versions

Daily download trend is not available in this view yet.

15.6K30 days

66.9K90 days

296.5K1 year

Compare downloads with other packages →

Also on1.5K r2u149 autocran4.6K conda_forge772 c2d4u

Repository

GitHub ↗ dkahle/ggmap

778Stars

235Forks

110Open issues

32Open PRs

2Releases

454Commits

16Contributors

454 commits · Last activity 2025-08-31 · 0% stars, 30d

Stars over time

2026-07-14 · 7782026-07-18 · 778

Repository practices

Upstream repositoryBeta

8 development-tooling and community-health practices detected across 5 families in the upstream repository

Checks run against github.com/dkahle/ggmap on 2026-07-19.

Continuous integration (2)

Travis CIAppVeyor

CRAN release process (2)

cran-comments.mdrevdep/

Docs source (1)

README.Rmd

Lint, format, editor (1)

RStudio project

Show all practices

Governance and community (2)

Issue templatesPR template

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

19 external dependencies (excludes base and recommended)

Depends (2)

R >= 3.1.0ggplot2

Imports (17)

png plyr jpeg digest scales dplyr bitopsgridglue httr stringr purrr magrittr tibble tidyr rlang cli

LinkingTo (0)

none

Suggests (3)

MASShexbin testthat

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

32direct

2indirect

Code & Tests

Code Composition

R 7,547 (68%)Rd 3,541 (32%)

Code characteristics

Object systems

S32

Cyclomatic complexity: 2.0 median / 91 max
Test cases: 6 / 0.01 per code line

Test coverage

Line coverage

15%

Expression

15.5%

Tests / Examples

14.6% / 10% ex

Functions

96 62 exported

Complexity

6.8 avg / 91 max

Call network

96 nodes / 156 edges

Call graph

Open call graph →

Loading call graph…

Lowest coverage

96 functions

Function	Cyclo	Coverage
OSM_scale_lookup exp	1	0%
XY2LonLat exp	1	0%
bb2bbox exp	1	0%
clear_geocode_cache exp	1	0%
distQueryCheck exp	2	0%
file_drawer exp	1	0%

Datasets

Bundled datasets · 3

Name	Class	Rows × Cols	Also ships in
crime	data.frame	86,314 × 17	–
wind	data.frame	51,529 × 8	–
zips	data.frame	23,906 × 10	–

People & History

People (4)

Maintainer (1)

David Kahle

Author, Maintainer

Authors (3)

David Kahle

Author, Maintainer

Scott Jackson

Author · added in 3.0.0

Hadley Wickham

Author

Contributors (1)

Mikko Korpela

Contributor · added in 3.0.0

Package Timeline

22 releases. Pick two to compare their code metrics. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
4.0.2Latest
2025-09-11 · current release · diff ↗
R
R 4.5.0 released · 2025-04-11
4.0.1
2025-04-07 · diff ↗
R
R 4.4.0 released · 2024-04-24
4.0.0
2023-11-19 · diff ↗
R
R 4.3.0 released · 2023-04-21
3.0.2
2023-03-14 · diff ↗
3.0.1
2022-11-03 · diff ↗
R
R 4.2.0 released · 2022-04-22
R
R 4.1.0 released · 2021-05-18
R
R 4.0.0 released · 2020-04-24
R
R 3.6.0 released · 2019-04-26
3.0.0
2019-02-05 · diff ↗
unarchivedReturned to CRAN
2019-02-04
2.6.2
2019-01-23 · diff ↗

Show 24 earlier events

orphanedOrphaned by its maintainer
2019-01-23
no response after 2 months to check errors despite reminders and deadline Usage of Google Maps API
R
R 3.5.0 released · 2018-04-23
R
R 3.4.0 released · 2017-04-21
R
R 3.3.0 released · 2016-05-03
2.6.1
2016-01-23 · diff ↗
2.6
2015-12-19 · diff ↗
2.5.2
2015-08-21 · diff ↗
R
R 3.2.0 released · 2015-04-16
2.4
2015-03-05 · diff ↗
R
R 3.1.0 released · 2014-04-10
2.3
2013-04-13 · diff ↗
R
R 3.0.0 released · 2013-04-03
2.15.2
2012-09-06 · diff ↗
2.2
2012-09-06 · diff ↗
2.1
2012-04-30 · diff ↗
2.15.1
2012-04-29 · diff ↗
2.0
2012-04-13 · diff ↗
R
R 2.15.0 released · 2012-03-30
1.3
2012-03-16 · diff ↗
2.15.0
2012-03-15 · diff ↗
1.2
2012-03-01 · diff ↗
0.7
2011-11-30 · diff ↗
2.14.1
2011-11-29
R
R 2.14.0 released · 2011-10-31

Package metadata

First published: 2011-11-30
Total releases: 22 / 15 yrs
License: GPL-2 OSI
Minimum R: ≥ 3.1.0
Bundled data: 3.8 MB / 4 files
Download size: 4.7 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Appears in task views

Analysis of Spatial Data

Report a problem with this page →