Skip to content

Commit d5fc9cd

Browse files
committed
Improve formatting of links and enhance clarity in README content
1 parent 947bd3d commit d5fc9cd

File tree

1 file changed

+14
-3
lines changed

1 file changed

+14
-3
lines changed

README.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Geocoding 101: An Introduction for Research Data Preparation
2-
Slides: https://slides.com/staceymaples/geocoding-101
2+
3+
Slides: [https://slides.com/staceymaples/geocoding-101](https://slides.com/staceymaples/geocoding-101)
4+
This Guide is published on Github Pages at: [https://stanfordgeospatialcenter.github.io/geocoding101/](https://stanfordgeospatialcenter.github.io/geocoding101/)
35

46
## Code Examples
57

@@ -43,12 +45,14 @@ Different research questions require different types of geocoding. Understanding
4345
Address geocoding converts street addresses into coordinates, typically with high precision (rooftop or street-level accuracy). This is one of the most common geocoding tasks in research.
4446

4547
**Use Cases:**
48+
4649
- Mapping patient addresses for health studies (with appropriate privacy protections)
4750
- Analyzing customer or business locations
4851
- Studying residential patterns and neighborhood characteristics
4952
- Historical address research
5053

5154
**Considerations:**
55+
5256
- Address formats vary by country and region
5357
- Accuracy depends on the completeness and currency of reference street data
5458
- Address standardization and cleaning often necessary before geocoding
@@ -59,12 +63,14 @@ Address geocoding converts street addresses into coordinates, typically with hig
5963
Place name (or toponym) geocoding converts named locations—such as cities, landmarks, neighborhoods, or natural features—into coordinates. This typically returns a representative point for the named feature.
6064

6165
**Use Cases:**
66+
6267
- Geocoding historical place names from archives or texts
6368
- Mapping event locations from news reports or social media
6469
- Analyzing place mentions in literature or documents
6570
- Studying geographic distributions of cultural or historical phenomena
6671

6772
**Considerations:**
73+
6874
- Place names can be ambiguous (e.g., "Springfield" exists in many states)
6975
- Historical place names may have changed or no longer exist
7076
- Returned coordinates are usually centroids, not precise locations
@@ -75,12 +81,14 @@ Place name (or toponym) geocoding converts named locations—such as cities, lan
7581
Administrative geocoding converts administrative unit names (countries, states, counties, postal codes, etc.) into representative coordinates, typically the centroid of the area.
7682

7783
**Use Cases:**
84+
7885
- Mapping aggregated data reported by administrative units
7986
- Joining datasets based on administrative geography
8087
- Analyzing regional patterns and comparisons
8188
- Creating choropleth maps
8289

8390
**Considerations:**
91+
8492
- Returns centroid points, not boundaries (separate boundary data needed for polygon mapping)
8593
- Administrative boundaries change over time
8694
- Hierarchical specificity matters (city vs. county vs. state)
@@ -91,12 +99,14 @@ Administrative geocoding converts administrative unit names (countries, states,
9199
Reverse geocoding works in the opposite direction: it takes coordinates and returns information about the nearest feature, such as an address, place name, or administrative unit.
92100

93101
**Use Cases:**
102+
94103
- Converting GPS coordinates to readable addresses
95104
- Identifying locations from coordinate data
96105
- Enriching coordinate-only datasets with contextual information
97106
- Quality checking geocoding results
98107

99108
**Considerations:**
109+
100110
- Returns nearest match, which may not be the exact location
101111
- Useful for validating forward geocoding results
102112
- Can help identify what type of feature a coordinate represents
@@ -106,12 +116,14 @@ Reverse geocoding works in the opposite direction: it takes coordinates and retu
106116
POI geocoding locates specific types of places such as businesses, landmarks, facilities, or services by name or category.
107117

108118
**Use Cases:**
119+
109120
- Mapping hospital, school, or park locations
110121
- Analyzing access to services and amenities
111122
- Studying commercial or institutional distributions
112123
- Creating proximity measures to specific facility types
113124

114125
**Considerations:**
126+
115127
- POI databases vary in coverage and currency
116128
- Business locations change frequently
117129
- May require category codes or filters for searches
@@ -136,6 +148,7 @@ Geocoding quality varies based on:
136148
- **Match type**: Whether the match was to an address, street segment, postal code, city, etc.
137149

138150
High-quality research requires attention to these metrics and often involves:
151+
139152
- Cleaning and standardizing input data
140153
- Reviewing and manually correcting low-confidence matches
141154
- Documenting geocoding methods and match rates
@@ -167,8 +180,6 @@ This guide provides a conceptual foundation for geocoding in research contexts.
167180

168181
Please refer to the additional documentation and tutorials provided by the Stanford Geospatial Center.
169182

170-
171-
172183
## Additional Resources
173184

174185
- [Esri's Introduction to Geocoding](https://pro.arcgis.com/en/pro-app/latest/help/data/geocoding/what-is-geocoding.htm)

0 commit comments

Comments
 (0)