zipcode

Código postal

Un buscador de códigos postales de Laravel WorldWide

Puedes usarlo en Laravel:

 ZipCode :: setCountry ( ' US ' );

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

O fuera de él:

 $ z = new PragmaRX  ZipCode  ZipCode ;

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

Automáticamente genera un JSON si intentas acceder a él como una cadena, pero aún puedes:

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

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

Selecciona tu servicio web preferido:

 ZipCode :: setPreferredWebService ( ' Zippopotamus ' );

Obtenga un servicio web por nombre, cambie cosas en él y busque una dirección/ciudad con él:

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

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

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

Cree un nuevo servicio web y agréguelo a la lista:

 $ webService = new PragmaRX  ZipCode  Support  WebService ;

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

ZipCode :: addWebService ( $ webService );

Cambie el agente de usuario que Guzzle utilizará para acceder al servicio web:

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

¿Cuánto tiempo tomó encontrar un zip?:

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

echo $ result -> getTimer ();

Obtenga una lista de todos los países disponibles:

 $ array = ZipCode :: getAvailableCountries ();

Cambie dinámicamente los parámetros de consulta, de modo que si tiene un inicio de sesión de Geonames, puede configurarlo haciendo:

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

Servicios web

Este paquete utiliza servicios web en todo el mundo para proporcionar direcciones e información de ciudades. Hay al menos 2 servicios web disponibles para todos los países (Brasil tiene actualmente 6), si ZipCode no puede acceder a uno o no encuentra un zip en él, automáticamente recurre a los demás. Si conoce otros servicios web disponibles que podrían ser mejores que esos, cree un problema o haga relaciones públicas con él.

Resultado

Este es un ejemplo de lo que obtienes cuando buscas un Zip con él:

 {
   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 devuelve un objeto PragmaRXZipCodeSupportResult y se puede acceder a todas las propiedades:

• como matriz
• Como cadena, lo que hará que devuelva un JSON
• Usando captadores con carcasa de camello:

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

Ejemplo de formulario de Laravel

Este es un enrutador Laravel pirateado de manera no convencional que genera un formulario para consultar archivos zip en un país seleccionado:

 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> ' ;
    }

});

Países disponibles

Hay servicios web probados para los siguientes países:

• Argentino (AR)
• Australia (UA)
• Brasil (BR)
• Canadá (CA)
• República Checa (CZ)
• Francia (FR)
• Alemania (DE)
• Gran Bretaña (GB)
• India (IN)
• Italia (IT)
• Japón (JP)
• Lituania (LT)
• México (MX)
• Pakistán (PK)
• Polonia (PL)
• Portugal (PT)
• Rusia (RU)
• Sudáfrica (ZA)
• España (ES)
• Suiza (CH)
• Turquía (TR)
• Estados Unidos (EE.UU.)

Si necesita uno diferente, solicítelo o simplemente envíe una solicitud de extracción con él.

Requisitos

• Laravel 4.1+ o 5+
• PHP 5.4+

Instalación

Instálalo usando Composer:

 composer require "pragmarx/zipcode"

Edite su app/config/app.php y agregue el proveedor de servicios

 'PragmaRXZipCodeVendorLaravelServiceProvider',

y la fachada

 'ZipCode' => 'PragmaRXZipCodeVendorLaravelFacade',

Usándolo

Crear una instancia directamente

 use PragmaRXZipCodeZipCode;

$zipcode = new ZipCode();

return $zipcode->generateSecretKey()

En Laravel puedes usar el IoC Container y el contrato

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

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

O Método de Inyección, en Laravel 5

 use PragmaRXZipCodeContractsZipCode;

class WelcomeController extends Controller {

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

}

Acerca de los geonombres

Este es un servicio realmente bueno y deberías usarlo como tu primera opción, pero para que sea gratuito (por 30.000 créditos/día) debes crear una cuenta de usuario y habilitar los servicios web gratuitos. Y configure ZipCode para usar su nombre de usuario:

 ZipCode::setCountry('GB');

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

ZipCode::find('L23YL');

Y también puedes usar config.php para configurarlo:

 return array(

	...

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

);

Autor

Antonio Carlos Ribeiro

Licencia

ZipCode tiene la licencia BSD de 3 cláusulas; consulte el archivo LICENSE para obtener más detalles.

Contribuyendo

Las solicitudes de extracción y los problemas son más que bienvenidos.