candrews/zipcode

There is no license information available for the latest version (v1.0) of this package.

Zipcode library connecting to zipcode api.

v1.0 2015-06-26 19:47 UTC

This package is not auto-updated.

Last update: 2025-09-27 23:15:46 UTC


README

#Zipcode Library for zzipcode.com

Install & Set Up

composer require candrews/zipcode

Sign up on zzipcode.com. It's free.

Once you've signed up, you'll be given an access key.

Plug that key into /vendor/candrews/Zipcode/src/config.php

Usage

Get Zipcode

$zipcode = new Zipcode\Zipcode(33024);
$zipcode->get();

if($zipcode->hasError()){
    echo $zipcode->getError();
}

var_dump($zipcode); // Valid $zipcode

Get Zipcode w/ Nearby Zipcodes

$zipcode = new Zipcode\Zipcode(33024);
$zipcode->get(15);

if($zipcode->hasError()){
    echo $zipcode->getError();
}

var_dump($zipcode->near); // Array of Zipcode Objects within 15 mi of 33024

Get Nearby Zipcodes w/ Details

$zipcode = new Zipcode\Zipcode(33024);
$zipcodes = $zipcode->near(15);

if($zipcodes->hasError()){
    echo $zipcodes->getError();
}

var_dump($zipcodes); // Array of Zipcode Objects within 15 mi of 33024

Get Nearby Zipcodes

$zipcode = new Zipcode\Zipcode(33024);
$zipcodes = $zipcode->near(15, false);

if($zipcode->hasError()){
    echo $zipcode->getError();
}

var_dump($zipcodes); // Array of Zipcodes within 15 mi of 33024, [33328, 33023, etc..]

Search for Zipcodes by Location Name

$zipcode = new Zipcode\Zipcode();
$zipcodes = $zipcode->search("Hollywood, FL");

if($zipcode->hasError()){
    echo $zipcode->getError();
}

var_dump($zipcodes); // Array of Zipcodes related to Hollywood, FL

Get Distance Between Two Zipcodes

$zipcode = new Zipcode\Zipcode(33024);
$distance = $zipcode->distance(33328);

if($zipcode->hasError()){
    echo $zipcode->getError();
}

var_dump($distance); // Distance between 33024 and 33328

For more details regarding usage, see: zzipcode.com PHP Library