zipcode
v1.5.6: Merge pull request #18 from GlitterCakes
Vous pouvez l'utiliser dans Laravel :
ZipCode :: setCountry ( ' US ' );
return Response :: make (
ZipCode :: find ( ' 10006 ' )
);Ou à l'extérieur :
$ z = new PragmaRX ZipCode ZipCode ;
return $ z -> find ( ' 20250030 ' )-> toArray ();Il restitue automatiquement un JSON si vous essayez d'y accéder sous forme de chaîne, mais vous pouvez toujours :
$ result = ZipCode :: find ( ' 10006 ' );
$ json = $ result -> toJson ();
$ array = $ result -> toArray ();Sélectionnez votre service Web préféré :
ZipCode :: setPreferredWebService ( ' Zippopotamus ' );Obtenez un service Web par son nom, modifiez les éléments dessus et trouvez une adresse/ville avec :
$ webService = ZipCode :: getWebServiceByName ( ' Zippopotamus ' );
$ webSerivice -> setUrl ( ' http://api.zippopotam.ca ' );
return ZipCode :: find ( ' 20250030 ' , $ webService );Créez un nouveau service Web et ajoutez-le à la liste :
$ webService = new PragmaRX ZipCode Support WebService ;
$ webSerivice -> setUrl ( ' http://api.zippopotam.ca ' );
$ webSerivice -> setQuery ( ' /%country%/%zip_code% ' );
ZipCode :: addWebService ( $ webService );Modifiez l'agent utilisateur que Guzzle utilisera pour accéder au service Web :
ZipCode :: setUserAgent ( ' Googlebot/2.1 (+http://www.google.com/bot.html) ' );Combien de temps a-t-il fallu pour trouver un zip ? :
$ result = ZipCode :: find ( ' 0200 ' );
echo $ result -> getTimer ();Obtenez une liste de tous les pays disponibles :
$ array = ZipCode :: getAvailableCountries ();Modifiez dynamiquement les paramètres de requête, donc si vous disposez d'une connexion Geonames, vous pouvez la définir en faisant :
ZipCode :: setQueryParameter ( ' geonames_username ' , ' yourusername ' );Ce package utilise des services Web du monde entier pour fournir des adresses et des informations sur les villes. Il existe au moins 2 services Web disponibles dans tous les pays (le Brésil en a actuellement 6), si ZipCode ne peut pas accéder à l'un ou ne trouve pas de zip dessus, il revient automatiquement aux autres. Si vous connaissez d'autres services Web disponibles qui pourraient être meilleurs que ceux-là, veuillez créer un problème ou un PR avec celui-ci.
Voici un exemple de ce que vous obtenez lorsque vous recherchez un Zip avec celui-ci :
{
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 renvoie un objet PragmaRXZipCodeSupportResult et toutes les propriétés sont accessibles :
$ result -> getWebService ();
$ result -> getCountryName ();Il s'agit d'un routeur Laravel piraté de manière non conventionnelle qui affiche un formulaire pour interroger les zips sur un pays sélectionné :
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> ' ;
}
});Il existe des services Web testés pour les pays suivants :
Si vous en avez besoin d'un autre, veuillez le demander ou simplement envoyer une pull request avec.
Installez-le à l'aide de Composer :
composer require "pragmarx/zipcode"
Modifiez votre app/config/app.php et ajoutez le fournisseur de services
'PragmaRXZipCodeVendorLaravelServiceProvider',
Et la façade
'ZipCode' => 'PragmaRXZipCodeVendorLaravelFacade',
use PragmaRXZipCodeZipCode;
$zipcode = new ZipCode();
return $zipcode->generateSecretKey()
$zipcode = app()->make('PragmaRXZipCodeContractsZipCode');
return $zipcode->find('20250-030')
use PragmaRXZipCodeContractsZipCode;
class WelcomeController extends Controller {
public function generateKey(ZipCode $zipcode)
{
return $zipcode->find('20250-030');
}
}
C'est un service vraiment sympa et vous devriez l'utiliser comme première option, mais pour qu'il soit gratuit (pour 30 000 crédits/jour), vous devez créer un compte utilisateur et activer les services Web gratuits. Et configurez ZipCode pour utiliser votre nom d'utilisateur :
ZipCode::setCountry('GB');
ZipCode::setQueryParameter('geonames_username', 'yourusername');
ZipCode::find('L23YL');
Et vous pouvez également utiliser config.php pour le définir :
return array(
...
'query_parameters' => array(
'geonames_username' => 'demo',
)
);
Antonio Carlos Ribeiro
ZipCode est sous licence BSD à 3 clauses - voir le fichier LICENSE pour plus de détails
Les demandes de tirage et les problèmes sont plus que bienvenus.
