zipcode

Почтовый индекс

Поисковик по почтовому индексу Laravel WorldWide.

Вы можете использовать его в Laravel:

 ZipCode :: setCountry ( ' US ' );

return Response :: make (
    ZipCode :: find ( ' 10006 ' )
);

Или вне его:

 $ z = new PragmaRX  ZipCode  ZipCode ;

return $ z -> find ( ' 20250030 ' )-> toArray ();

Он автоматически отображает JSON, если вы пытаетесь получить к нему доступ как к строке, но вы все равно можете:

 $ result = ZipCode :: find ( ' 10006 ' );

$ json = $ result -> toJson ();
$ array = $ result -> toArray ();

Выберите предпочитаемый веб-сервис:

 ZipCode :: setPreferredWebService ( ' Zippopotamus ' );

Получите веб-сервис по имени, измените в нем что-то и найдите с его помощью адрес/город:

 $ webService = ZipCode :: getWebServiceByName ( ' Zippopotamus ' );

$ webSerivice -> setUrl ( ' http://api.zippopotam.ca ' );

return ZipCode :: find ( ' 20250030 ' , $ webService );

Создайте новый веб-сервис и добавьте его в список:

 $ webService = new PragmaRX  ZipCode  Support  WebService ;

$ webSerivice -> setUrl ( ' http://api.zippopotam.ca ' );
$ webSerivice -> setQuery ( ' /%country%/%zip_code% ' );

ZipCode :: addWebService ( $ webService );

Измените пользовательский агент, который Guzzle будет использовать для доступа к веб-сервису:

 ZipCode :: setUserAgent ( ' Googlebot/2.1 (+http://www.google.com/bot.html) ' );

Сколько времени ушло на поиск почтового индекса?:

 $ result = ZipCode :: find ( ' 0200 ' );

echo $ result -> getTimer ();

Получить список всех доступных стран:

 $ array = ZipCode :: getAvailableCountries ();

Динамическое изменение параметров запроса, поэтому, если у вас есть логин Geonames, вы можете установить его, выполнив следующие действия:

 ZipCode :: setQueryParameter ( ' geonames_username ' , ' yourusername ' );

Веб-сервисы

Этот пакет использует веб-сервисы по всему миру для предоставления информации об адресах и городах. Существует как минимум 2 веб-сервиса, доступных для всех стран (в Бразилии в настоящее время их 6), если ZipCode не может получить доступ к одному из них или не находит на нем почтовый индекс, он автоматически переключается на другие. Если вам известны какие-либо другие доступные веб-сервисы, которые могут быть лучше этих, создайте проблему или поделитесь с ними информацией.

Результат

Это пример того, что вы получаете при поиске по Zip-файлу:

 {
   country_id : "CH" ,
   country_name : "Switzerland" ,
   zip_code : "1005" ,
   web_service : "Geonames" ,
   timer : "0.7808" ,
   service_query_url : "http://api.geonames.org/postalCodeSearch?country=CH&postalcode=1005&username=demo" ,
   addresses : [
      {
         postal_code : "1005" ,
         state_name : "Canton de Vaud" ,
         state_id : "VD" ,
         city : "Lausanne" ,
         latitude : "46.51985" ,
         longitude : "6.64252" ,
         department : "District de Lausanne" ,
         department_id : "2225" ,
         district : "Lausanne"
      }
   ] ,
   result_raw : {
      totalResultsCount : "1" ,
      code : {
         postalcode : "1005" ,
         name : "Lausanne" ,
         countryCode : "CH" ,
         lat : "46.51985" ,
         lng : "6.64252" ,
         adminCode1 : "VD" ,
         adminName1 : "Canton de Vaud" ,
         adminCode2 : "2225" ,
         adminName2 : "District de Lausanne" ,
         adminCode3 : "5586" ,
         adminName3 : "Lausanne"
      }
   } ,
   success : true
}

ZipCode возвращает объект PragmaRXZipCodeSupportResult , и все свойства доступны:

• Как массив
• В виде строки, которая вернет JSON.
• Использование геттеров в верблюжьем корпусе:

 $ result -> getWebService ();
$ result -> getCountryName ();

Пример формы Laravel

Это нестандартно взломанный маршрутизатор Laravel, который отображает форму для запроса zip-файлов в выбранной стране:

 Route :: any ( ' zipcode ' , function () {

    echo
        Form :: open ( array ( ' url ' => ' zipcode ' )) .
        Form :: select ( ' country ' , ZipCode :: getAvailableCountries (), Input :: get ( ' country ' )) .
        Form :: text ( ' zipcode ' , Input :: get ( ' zipcode ' )) .
        Form :: submit ( ' go! ' ) .
        Form :: close ();

    if ( Input :: get ( ' country ' ))
    {
        ZipCode :: setCountry ( Input :: get ( ' country ' ));

        ZipCode :: setQueryParameter ( ' geonames_username ' , ' demo ' );

        echo ' <pre> ' ;
        var_dump ( ZipCode :: find ( Input :: get ( ' zipcode ' ))-> toArray ());
        echo ' </pre> ' ;
    }

});

Доступные страны

Веб-сервисы протестированы для следующих стран:

• Аргентина (AR)
• Австралия (Австралия)
• Бразилия (БР)
• Канада (Калифорния)
• Чехия (CZ)
• Франция (FR)
• Германия (DE)
• Великобритания (Великобритания)
• Индия (Индия)
• Италия (ИТ)
• Япония (Япония)
• Литва (LT)
• Мексика (MX)
• Пакистан (ПК)
• Польша (PL)
• Португалия (ПТ)
• Россия (RU)
• Южная Африка (ZA)
• Испания (ES)
• Швейцария (CH)
• Турция (ТР)
• Соединенные Штаты (США)

Если вам нужен другой, спросите или просто отправьте вместе с ним запрос на включение.

Требования

• Ларавел 4.1+ или 5+
• PHP 5.4+

Установка

Установите его с помощью Composer:

 composer require "pragmarx/zipcode"

Отредактируйте файл app/config/app.php и добавьте поставщика услуг.

 'PragmaRXZipCodeVendorLaravelServiceProvider',

И фасад

 'ZipCode' => 'PragmaRXZipCodeVendorLaravelFacade',

Использование этого

Создайте его экземпляр напрямую

 use PragmaRXZipCodeZipCode;

$zipcode = new ZipCode();

return $zipcode->generateSecretKey()

В Laravel вы можете использовать контейнер IoC и контракт.

 $zipcode = app()->make('PragmaRXZipCodeContractsZipCode');

return $zipcode->find('20250-030')

Или внедрение метода в Laravel 5

 use PragmaRXZipCodeContractsZipCode;

class WelcomeController extends Controller {

	public function generateKey(ZipCode $zipcode)
	{
		return $zipcode->find('20250-030');
	}

}

О геоназваниях

Это действительно хороший сервис, и вам следует использовать его в качестве первого варианта, но чтобы он был бесплатным (за 30 000 кредитов в день), вам необходимо создать учетную запись пользователя и включить бесплатные веб-сервисы. И настройте ZipCode на использование вашего имени пользователя:

 ZipCode::setCountry('GB');

ZipCode::setQueryParameter('geonames_username', 'yourusername');

ZipCode::find('L23YL');

И вы также можете использовать config.php для его установки:

 return array(

	...

	'query_parameters' => array(
		'geonames_username' => 'demo',
	)

);

Автор

Антонио Карлос Рибейро

Лицензия

ZipCode лицензируется по лицензии BSD из 3 пунктов — подробности см. в файле LICENSE

Содействие

Запросы на включение и проблемы более чем приветствуются.