Целевая геолокация с Geonames

  {"geonames": [{"countryName": "Великобритания",
               "AdminCode1": "ENG",
               "fclName": "город, деревня, ...",
               "COUNTRYCODE": "GB",
               "LNG": - +2,23743438720703,
               "fcodeName": "место административного деления второго порядка",
               «Расстояние»: «0,39678»,
               "ToponymName": "Манчестер",
               "FCL": "P",
               «Название»: «Манчестер»,
               "FCODE": "PPLA2",
               "GeonameId": 2643123,
               «Лат»: 53,4809464283615,
               "AdminName1": "Англия",
               "Население": 395515}]} 

Как видите, результатом является объект со свойством geonames который содержит массив из одного объекта с несколькими свойствами. Свойства lat и lng предоставляют географическое местоположение места, которое служба определила, distance показывает вам, как далеко это место от предоставленной вами позиции, и наиболее полезным является свойство name которое сообщает вам имя местоположения. свойство countryName сообщает вам страну, в данном случае Великобританию.

Данные также предоставляют информацию об административных делениях. Точный характер такого разделения варьируется от страны к стране; в этом случае adminCode1 (административное деление первого уровня) идентифицирует «Англию»; если бы вы нашли Хьюстон в Соединенных Штатах с помощью этого сервиса, вы бы обнаружили, что adminCode1 показывает «TX» для штата Техас.

Кроме того, geonameId содержит уникальный идентификатор, используемый в базе данных Geonames, который, как вы помните, можно загрузить. Вы можете использовать это в какой-то момент, если вы продолжите использовать данные для чего-то более существенного.

Targeted Prompting — практический пример

В качестве примера, давайте предположим, что на вашем веб-сайте есть функция, которая предлагает пользователю найти списки кинотеатров, и вы хотите персонализировать текст заголовка с названием ближайшего города пользователя — что-то вроде «Найти списки кинотеатров рядом с вами в Манчестере». , Сразу есть одно важное ограничение, о котором вы должны знать: в большинстве случаев геолокация выполняется на клиенте. Независимо от веб-браузера или самого устройства, эта информация должна быть отправлена ​​обратно на сервер, если вы хотите использовать ее там. JavaScript на стороне клиента будет получать координаты пользователя и отправлять их на серверный скрипт через Ajax, который затем взаимодействует с веб-службой и возвращает имя местоположения.

Код на стороне сервера

Давайте начнем с написания серверного PHP-кода. Веб-сайт Geonames предоставляет пакет PEAR , а также библиотеки для фреймворков, в том числе Zend Framework и Yii , для упрощения доступа к их сервисам — однако для целей этого урока я буду использовать простой PHP.

Этот простой класс инкапсулирует вызов службы findNearbyPlaceName:

 <?php class Geonames { protected $username; public function __construct($username) { $this->username = $username; } public function getPlaceName($lat, $lng) { $url = sprintf( "http://api.geonames.org/findNearbyPlaceNameJSON?lat=%f&lng=%f&username=%s", $lat, $lng, $this->username); $response = file_get_contents($url); if ($response === false) { throw new Exception("Failure to obtain data"); } $places = json_decode($response); if (!$places) { throw new Exception("Invalid JSON response"); } if (is_array($places->geonames) && count($places->geonames)) { return $places->geonames[0]->name; } else { return "Unknown"; } } } 

Класс называется Geonames , конструктор которого принимает в качестве аргумента один параметр — ранее зарегистрированное имя пользователя, которое затем сохраняется в защищенной переменной-члене.

Метод getPlaceName() вызывает сервис findNearbyPlaceName. Поскольку это простой запрос GET к REST-подобному сервису, вы можете просто включить параметры в URL-адрес, как вы делали это при тестировании веб-сервиса через браузер ранее. Я использовал sprintf() для создания URL-адреса, подход, который я считаю более чистым, чем конкатенация, а также позволяет мне указывать типы форматов для заполнителей; широта и долгота — это числа с плавающей точкой ( %f ), а имя пользователя — строка ( %s ). Затем URL передается в file_get_contents() который получает ответ службы JSON. Ответ декодируется с использованием json_decode() и первое имя места возвращается из метода.

Сценарий, вызванный Ajax, получит широтные и продольные координаты, использует их для запроса веб-службы Geonames через новый класс и возвращает имя ближайшего местоположения.

 <?php require "../include/Geonames.php"; $lat = floatval($_GET["lat"]); $lng = floatval($_GET["lng"]); $geo = new Geonames("username"); $prompt = "Find cinema listings near you"; try { $place = $geo->getPlaceName($lat, $lng); if ($place != "Unknown") { $prompt .= " in " . $place; } } catch (Exception $e) { error_log("Error with web service: " . $e->getMessage()); } header("Content-Type: text/plain"); echo $prompt; 

Код начинается с сообщения по умолчанию «Найти кинотеатр рядом с вами». Если вызов getPlaceName() не вызывает исключение и возвращаемое имя не «Неизвестно», сообщение дополнительно персонализируется.

Код на стороне клиента

Теперь давайте обратим наше внимание на страницу HTML и код JavaScript, который будет вызывать PHP.

 <!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>Hello!</title> <script src="jquery.js"></script> <script> (function ($) { $(document).ready(function() { if (navigator.geolocation) { navigator.geolocation.getCurrentPosition( function (position) { var lat = position.coords.latitude; var lng = position.coords.longitude; $("#banner").load("/prompt.php?lat="+lat+"&lng="+lng); }, function (error) { console.log("An error occurred obtaining position."); }); } else { $("#banner").html("Default content goes here"); } }); })(jQuery); </script> </head> <body> <div id="banner"></div> </body> </html> 

Если геолокация поддерживается браузером, затем navigator.geolocation вернет true, в противном случае некоторое содержимое по умолчанию будет вставлено в элемент с идентификатором banner . Когда поддерживается геолокация, делается попытка получить местоположение пользователя с помощью navigator.geolocation.getCurrentPosition() , которому передаются обратные вызовы success и error.

В этот момент браузер запросит у вас разрешения на передачу информации о вашем местонахождении на веб-страницу. Если вы дадите разрешение, то будет выполнен обратный вызов и, если приложению удастся получить имя местоположения, баннер будет содержать персональное приглашение для просмотра списков кинотеатров. Если вы отказываете в разрешении браузеру, вместо этого выполняется обратный вызов ошибки.

Резюме

В этой короткой статье я представил геолокацию и один способ, которым вы можете использовать ее прямо сейчас, чтобы персонализировать опыт посетителя на веб-сайте. Хотя пример, который я привел, несколько неуклюж в использовании AJAX для ретроспективной загрузки блока на страницу, он служит для иллюстрации одной из технических проблем геолокации — информация в основном получается на стороне клиента и, следовательно, существуют препятствия, которые вам нужны преодолеть, например, запросить разрешение на использование информации. Возможно, вы захотите попытаться сохранить информацию на стороне сервера в сеансе после ее получения, посмотреть на повышение производительности с помощью кэширования или поэкспериментировать с более сложным таргетингом. Следующим логическим шагом будет изучение того, как вы будете управлять отношениями между городами — что если в моей местной деревне нет кинотеатра, что делает ближайший город или город? Это в другой раз, но сейчас я рекомендую вам взглянуть на поддержку API для геолокации (вы могли бы даже взглянуть на спецификацию ), взглянуть на полностью серверное IP-решение или углубиться в математику геолокации. Больше всего я призываю вас повеселиться!

Изображение через Оливье Ле Моал / Shutterstock