Welcome to Geo Street Talk!¶
Description¶
Geo Street Talk (GST) enables a slightly more intuitive way of communicating points on a street. We created GST to convert any location coordinate along any cities to a conversational string.
Imagine looking at any non-cartographical data visualization or UI component (tables, graphs, text, etc.) that aims to display, say, characteristics of the worst potholes in the city. To represent the location, we could display a coordinate (e.g. 40.7217267,-73.9870392), but without looking at a map, where is this?
One could imagine instead displaying an address (i.e. 263 E Houston St), but, again, without looking at a map, even to a native New Yorker like myself, I don’t know immediately know if this is on the east or west side of the city.
Building on a solid foundation, the deliverable of this project will programmatically output more immediately meaningful descriptions (i.e. “Houston Street between Avenue B and Avenue C”).
As folks who are in the data weeds day-to-day, it’s important to not lose sight of higher-level user experience.
Project lead: David Marulli (@dmarulli | david@argolabs.org)
Primary developer: @YukunVVan
Orgs: Streets Data Collaborative | ARGO
How to use¶
Use function streetTalk to return a translated address.
-
geo_street_talk.
street
(longitude, latitude, cityname, networkType='drive')¶ This function takes a lat/lng pair and a city name as inputs, and returns a conversational string stating nearest street as well as enclosing streets.
longitude: float
latitude: float
cityname: string
networkType: string
This is used to generate graph from
OSMnx
. You can also specify several different network types:drive
- get drivable public streets (but not service roads)drive_service
- get drivable streets, including service roadswalk
- get all streets and paths that pedestrians can use (this network type ignores one-way directionality)bike
- get all streets and paths that cyclists can useall
- download all non-private OSM streets and pathsall_private
- download all OSM streets and paths, including private-access ones