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 ที่ถูกแฮ็กอย่างไม่เป็นทางการซึ่งสร้างแบบฟอร์มเพื่อค้นหารหัสไปรษณีย์ในประเทศที่เลือก:

 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)
• ออสเตรเลีย (AU)
• บราซิล (BR)
• แคนาดา (แคลิฟอร์เนีย)
• สาธารณรัฐเช็ก (CZ)
• ฝรั่งเศส (FR)
• เยอรมนี (DE)
• สหราชอาณาจักร (GB)
• อินเดีย (IN)
• อิตาลี (ไอที)
• ญี่ปุ่น (JP)
• ลิทัวเนีย (LT)
• เม็กซิโก (MX)
• ปากีสถาน (PK)
• โปแลนด์ (PL)
• โปรตุเกส (PT)
• รัสเซีย (RU)
• แอฟริกาใต้ (ZA)
• สเปน (ES)
• สวิตเซอร์แลนด์ (CH)
• ตุรกี (TR)
• สหรัฐอเมริกา (US)

หากคุณต้องการอันอื่น โปรดสอบถามหรือส่งคำขอดึงไปด้วย

ความต้องการ

• Laravel 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 Container และสัญญาได้

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

}

เกี่ยวกับ Geonames

นี่เป็นบริการที่ดีจริงๆ และคุณควรใช้มันเป็นตัวเลือกแรก แต่เพื่อให้เป็นบริการฟรี (สำหรับ 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-Clause License - ดูรายละเอียดในไฟล์ LICENSE

มีส่วนร่วม

คำขอดึงและปัญหาต่างๆ เป็นเรื่องที่น่ายินดีเป็นอย่างยิ่ง