From 0a77d4cdcf32f3eef845c038100724687f949cff Mon Sep 17 00:00:00 2001
From: Gregor Wehrle <171450664+gwehrle@users.noreply.github.com>
Date: Thu, 21 Nov 2024 14:10:17 +0100
Subject: [PATCH] Clearify difference between turbo_url and query

#2
---
 README.md | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 523f13c..5138b51 100644
--- a/README.md
+++ b/README.md
@@ -24,11 +24,14 @@ pkg> add Overpass
 
 ### Query overpass
 
+Get requested elements from OpenStreetMap through Overpass API. The result is provided as _string_ and has to be parsed depending on the format you specified in your query.
+
 **💡 Tipp: Use [Overpass Turbo](https://overpass-turbo.eu/) to build your queries and use the *export* feature to save them as `.overpassql`**
 
 ```julia
 using Overpass
 Overpass.query("waterfountains.overpassql")
+# "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<osm…"
 ```
 `Overpass.query` can handle `.overpassql` and `.ql` files.
 For short queries it is also possible to inline it directly:
@@ -75,14 +78,17 @@ The returned OverpassStatus struct provides the following fields:
 
 ### Overpass turbo URL
 
-```julia
-Overpass.turbo_url("waterfountains.overpassql")
-```
+Get URL to open your query in Overpass Turbo.
 
-Transform Overpass Query to Overpass Turbo URL.
+Overpass Turbo is a web based graphical user interface for Overpass.
+Its very useful to build and debug your queries with Overpass Turbo.
 
 The query can be provided directly or as a path to a `.ql`/`.overpassql` file.
-Can be helpful to debug queries.
+
+```julia
+Overpass.turbo_url("waterfountains.overpassql")
+# "https://overpass-turbo.eu/?Q=%5Bout%3Ajson%5D%3Bnode%5Bamenity%3Ddrinking_water…"
+```
 
 ### Overpass Turbo shortcuts