From ab82b1e242c005303a4afea55fca3b6c6d134c93 Mon Sep 17 00:00:00 2001
From: tomaytotomato <971697+tomaytotomato@users.noreply.github.com>
Date: Tue, 23 Jul 2024 21:52:30 +0100
Subject: [PATCH] Update README.md

---
 README.md | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index af20682..123b016 100644
--- a/README.md
+++ b/README.md
@@ -6,8 +6,18 @@
 ![GitHub License](https://img.shields.io/github/license/tomaytotomato/location4j)
 
 location4j is a library that provides location data and location searching within a simple API.
-There are no calls to 3rd party location services or LLMs. Just a simple location service for your
-Java applications!
+
+There are no calls to 3rd party Geolocation services e.g. (Google Maps) or LLMs like ChatGPT. 
+
+location4j can parse and retrieve countries, states and cities from simple text formatted or unformatted.
+
+e.g. 
+
+```
+"Santa Clara CA US" ===> {country:US}. {state:CA}, {city:Santa Clara} ===> 1 location found ===> Santa Clara, California, United States
+"Santa Clara, California, United States" ===> {country:United States}. {state:California}, {city:Santa Clara} ===> 1 location found ===> Santa Clara, California, United States
+"Gloucester" ===> {city:Gloucester} ===> 3 locations found ===> Gloucester, United Kingdom // Gloucester, Australia // Gloucester, United States
+```
 
 ## Motivation 🏗️