PHPackages                             maptechnica/mtapi - 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. maptechnica/mtapi

ActiveLibrary

maptechnica/mtapi
=================

A Laravel package that allows you to access the MapTechnica API easily.

1.0.5(9y ago)128MITPHPPHP >=5.6.10

Since Oct 18Pushed 9y agoCompare

[ Source](https://github.com/maptechnica/mtapi)[ Packagist](https://packagist.org/packages/maptechnica/mtapi)[ Docs](https://www.maptechnica.com)[ RSS](/packages/maptechnica-mtapi/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (7)Used By (0)

MapTechnicaAPI
==============

[](#maptechnicaapi)

> #### Note:
>
> [](#note)

Please note the MapTechnica API system is now in Beta. If you would like to participate in the Beta program, you may sign up here:

If you wish to be notified when the API is formally launched, sign up to this list:

(We promise not to spam you.)

Overview
--------

[](#overview)

`mtapi` is a composer package that lets you easily access the MapTechnica API from your Laravel application. The MapTechnica API ("MT API") lets you retrieve GIS boundary, meta, and centroid data for the following geotypes:

- US Census Bureau Data:
    - ZIP Codes (ZCTA5s)
    - 3-Digit ZIP Code Prefixes (ZCTA3s)
    - Cities & Places
    - Counties
    - Congressional Districts for the current session
    - School Districts
- Canadian Boundary Data
    - FSAs (the three-character postal code prefix)
    - Provinces

You can see this data in action and learn more about the MapTechnica API on [MapTechnica.com](https://www.maptechnica.com).

> #### Note:
>
> [](#note-1)

Free use of this package is covered under the MIT license. However, to access the MT API, you will need to obtain a license key which is subject to its own use restrictions and fees. Visit the [Developers seciton of MapTechnica.com](https://dev.maptechnica.com) for more information.

Obtain a MapTechnica API Key (BETA)
-----------------------------------

[](#obtain-a-maptechnica-api-key-beta)

The API system is currently in Beta. If you would like to participate in the Beta program, please fill out the request form here:

While you're there, go ahead and register for an account:

If you are selected to participate in the Beta program, you will be contacted with API key information.

Package Installation
--------------------

[](#package-installation)

In a terminal, require the package from the root directory of your Laravel project:

```
composer require maptechnica\mtapi
```

### Laravel 5.x:

[](#laravel-5x)

After updating composer, add the ServiceProvider to the providers array in config/app.php:

```
MapTechnica\MTAPI\MTAPIServiceProvider::class,
```

Add an alias to config/app.php:

```
'MTAPI' => MapTechnica\MTAPI\MTAPIDataRetriever::class,
```

Next, move the config file into the `config` directory. From your project's root directory, type:

```
php artisan vendor:publish
```

Now you have a choice. You can either directly alter the values in your `config\mtapi.php` file as follows:

*From:*

```
'apiKey'         => env('MAPTECHNICA_API_KEY', NULL),
```

*To:*

```
'apiKey'         => env('MAPTECHNICA_API_KEY', '[YOUR_API_KEY]'),
```

Or, if you're in an environment that requires different keys based on your server location, leave `config\mtapi.php` as-is and open your `.env` file and add the following variable instead

```
MAPTECHNICA_API_KEY=[YOUR_API_KEY]
```

Post-Installation
-----------------

[](#post-installation)

Once Composer has done its thing, and assuming your Laravel app is up and running, open...

```
http://yourapp/__mtapi
```

...in your browser. You should see a links page.

### Check Your Installation

[](#check-your-installation)

Click the "Check Installation" button to insure your variables are set correctly and the API is responding to your requests.

### Learning the API

[](#learning-the-api)

Click the "API Documentation" button to view a Swagger playground and documentation for the API.

### Getting Help

[](#getting-help)

There are several resources available to you if you run into trouble:

- **Developer Forum** - Ask for help and share solutions with your fellow developers at
- **MapTechnica Support** - If you have found a bug or have encountered a problem not solved by the Forum, you can open a support ticket at . Note that debugging your application is outside the scope of support for the API, so please limit your issues to bugs encountered with the API itself.

Links
-----

[](#links)

**Project Home:**

**Git Repository:**

**API Documentation (Swagger):**

The MapTechnica API makes it possible to access MapTechnica's boundary data directly into your mapping application.

This package is designed to work with Laravel 5+ or as a standalone package in your own composer-based project.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity62

Established project with proven stability

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

Every ~2 days

Total

6

Last Release

3486d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2a1b0b7fea99fd8201e8fcf142b2c845059d786d9f109d5d49fb2fb1c7a296f7?d=identicon)[MapTechnica](/maintainers/MapTechnica)

---

Tags

zipstatezip codegiscityzipcodeprovinceboundariesboundarycountyfsamaptechnicazctazcta5congressional districtschool district

### Embed Badge

![Health badge](/badges/maptechnica-mtapi/health.svg)

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

###  Alternatives

[barbieswimcrew/zip-code-validator

Constraint class for international zipcode validation

772.3M](/packages/barbieswimcrew-zip-code-validator)[salibhdr/typhoon-iran-cities

A laravel package for importing all regions such as provinces, counties, cities, city districts, rural districts and villages of iran into database accurately

6121.0k](/packages/salibhdr-typhoon-iran-cities)[pragmarx/zipcode

A worldwide address-by-zipcode searcher.

10265.4k](/packages/pragmarx-zipcode)[dipeshsukhia/laravel-country-state-city-data

Country State City Data Provider

8230.8k](/packages/dipeshsukhia-laravel-country-state-city-data)[canducci/zipcode

ZipCode From Brazil

4555.1k](/packages/canducci-zipcode)[woenel/prpcmblmts

Philippines region, province, cities/municipalities and barangays Laravel migration and table seeder.

2818.3k](/packages/woenel-prpcmblmts)

PHPackages © 2026

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