PHPackages                             saintsweeto/addressfinder - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. saintsweeto/addressfinder

ActiveLibrary[API Development](/categories/api)

saintsweeto/addressfinder
=========================

A PHP wrapper for NZ AddressFinder API

1.0.0(4y ago)13MITPHP

Since May 25Pushed 4y ago1 watchersCompare

[ Source](https://github.com/saintsweeto/addressfinder)[ Packagist](https://packagist.org/packages/saintsweeto/addressfinder)[ RSS](/packages/saintsweeto-addressfinder/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

AddressFinder
=============

[](#addressfinder)

A PHP wrapper for AddressFinder API

Initialization & Usage
--------------------------

[](#initialization--usage)

```
$finder = new AddressFinder(KEY, SECRET, FORMAT);
$response = $finder->endpoint(URI, OPTIONS);

// Example: Call Address Autocomplete endpoint
$response = $finder->endpoint('/address/autocomplete', [
    'q' => '35 Hobson Street',
]);

```

[API specifications for New Zealand addresses:](https://addressfinder.nz/api/nz/specs/)

### Address Autocomplete API

[](#address-autocomplete-api)

#### /address/autocomplete

[](#addressautocomplete)

Interactive search that returns closely matching addresses which are then selected by the user.

### Address Metadata API

[](#address-metadata-api)

#### /address/metadata

[](#addressmetadata)

Return the full metadata associated with an address selected from the Address Autocomplete API.

### Address Verification API

[](#address-verification-api)

#### /address/verification

[](#addressverification)

Takes an address (potentially containing spelling mistakes and/or other errors) and attempts to match it against a verified address record in the AddressFinder database.

### Address Reverse Geocode API

[](#address-reverse-geocode-api)

#### /address/reverse\_geocode

[](#addressreverse_geocode)

Takes the GPS coordinates (longitude and latitude) and returns the nearest addresses ordered by distance.

### Address Bounding Box API

[](#address-bounding-box-api)

#### /address/bounding\_box

[](#addressbounding_box)

Returns all address contained within the supplied bounding box or polygon.

### Location Autocomplete API

[](#location-autocomplete-api)

#### /location/autocomplete

[](#locationautocomplete)

Interactive search that returns closely matching streets, suburbs, cities and/or regions which are then selected by the user.

### Location Metadata API

[](#location-metadata-api)

#### /location/metadata

[](#locationmetadata)

Return the full metadata associated with a location (street, suburb, city or region selected from the Location Autocomplete API.

### Points of Interest Autocomplete API

[](#points-of-interest-autocomplete-api)

#### /points\_of\_interest/autocomplete

[](#points_of_interestautocomplete)

Interactive search that returns closely matching points of interest, and their associated addresses.

### Points of Interest Metadata API

[](#points-of-interest-metadata-api)

#### /points\_of\_interest/metadata

[](#points_of_interestmetadata)

Return the full metadata associated with a point of interest selected from the Points of Interest Autocomplete API.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1811d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/effdf8fe137ac8f8047e524abb7aab28c43c550b3cabf364ac0c3189280ec755?d=identicon)[saintsweeto](/maintainers/saintsweeto)

---

Top Contributors

[![saintsweeto](https://avatars.githubusercontent.com/u/23696052?v=4)](https://github.com/saintsweeto "saintsweeto (1 commits)")

---

Tags

address-finderapi-wrapperphp-wrapperaddress-finderaddress-finder apiaddress-finder php wrapper

### Embed Badge

![Health badge](/badges/saintsweeto-addressfinder/health.svg)

```
[![Health](https://phpackages.com/badges/saintsweeto-addressfinder/health.svg)](https://phpackages.com/packages/saintsweeto-addressfinder)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)