From 2e6acb09d7829aa28f5e938f26b51b4baa66842d Mon Sep 17 00:00:00 2001 From: Diana Shkolnikov Date: Wed, 16 Sep 2015 18:18:24 -0400 Subject: [PATCH] Update 002-search.md --- getting-started/002-search.md | 27 ++++++++++++++++++--------- 1 file changed, 18 insertions(+), 9 deletions(-) diff --git a/getting-started/002-search.md b/getting-started/002-search.md index 46c05db..0b80871 100644 --- a/getting-started/002-search.md +++ b/getting-started/002-search.md @@ -1,25 +1,34 @@ -Search +`SEARCH` ======= -Turning place names we can say into geographic coordinates computers can use +Turning human recognizable place names into computer recognizable geographic coordinates _____________________________________________________________________________________ -Geocoding is the process of matching an address to its corresponding geographic coordinates. There's nothing inherent in the words "10 Downing Street, London, United Kingdom" that inherently conveys its location at the coordinates 51.503396, -0.12764. Instead this process [...]. +Geocoding is the process of matching an address to its corresponding geographic coordinates. There's nothing inherent in the words "10 Downing Street, London, United Kingdom" that conveys its location at the coordinates `[ 51.503396, -0.12764 ]`. Instead this process [...]. + +:school: :barber: :bank: :us: :house_with_garden: :hospital: ......... :computer: -# Using Search ## Looking For Places - Getting Started -{search text, global, no options} +_{search text, global, no options}_ + +##### The most basic scenario -So, let's say you wanted to find **Stinky Beach**, you'd just do this. +Let's say you wanted to find **Stinky Beach**, you would simply query the search API as follows: > > [/v1/search?___text=stinky beach___](https://search.mapzen.com/v1/search?api_key={YOUR_API_KEY}&text=stinky beach) > -_Go ahead, and click that link... we'll wait._ +_...go ahead, and click that link, we'll wait_ + +Now that you're back, you probably saw a `GeoJSON` formatted response on the other side of that click. +You'll always get back `GeoJSON` results, unless something goes terribly wrong, in which case you'll get a really helpful error. + +Now you know exactly where on the earth's sufrace **Strinky Beach** is located: `[ 139.86114, -37.33192 ]` +You've also probably learned from the results of that request that this intriguing beach is located in **Australia**, more specifically in the **South Australia** region. You also have yourself a handy text label to use when talking to other humans about this place: **Stinky Beach, Nora Creina, South Australia** + + -Now you know exactly where on the earth sufrace **Strinky Beach** is located: `[ 139.86114, -37.33192 ]` -You've also probably learned from the results of that request that this questionable beach is located in **Australia**, more specifically in the **South Australia** region. You also have yourself a handy text label to use when talking to other humans about this place: **Stinky Beach, Nora Creina, South Australia** - Response is GeoJSON FeatureCollection