PHPackages                             arraypress/google-places - 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. arraypress/google-places

ActiveLibrary[API Development](/categories/api)

arraypress/google-places
========================

A PHP library for integrating with the Google Places API in WordPress, providing geocoding, place details, business information, and location data. Features comprehensive response handling and WordPress transient caching.

05PHP

Since Jan 6Pushed 1y ago1 watchersCompare

[ Source](https://github.com/arraypress/google-places)[ Packagist](https://packagist.org/packages/arraypress/google-places)[ RSS](/packages/arraypress-google-places/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Google Places API for WordPress
===============================

[](#google-places-api-for-wordpress)

A comprehensive PHP library for integrating with the Google Places API in WordPress, providing easy-to-use methods for geocoding, place details, search, and autocomplete functionality. Features WordPress integration, robust caching, and `WP_Error` support.

Features
--------

[](#features)

- 🔍 **Comprehensive Search**: Support for text, nearby, and autocomplete searches
- 📍 **Place Details**: Detailed place information including address, contact details, and reviews
- 🌍 **Geocoding**: Convert addresses to coordinates and vice versa
- 🕒 **Opening Hours**: Formatted business hours with current status
- ⭐ **Reviews & Ratings**: Access to user reviews and rating information
- 📸 **Photo Integration**: Easy access to place photos with customizable dimensions
- 💰 **Price Levels**: Support for price range information
- 🚗 **Distance Matrix**: Calculate distances between locations
- 🛡️ **Type Safety**: Full type hinting and strict types
- ⚡ **Built-in Caching**: Efficient caching system for API responses
- 🌐 **Multiple Languages**: Support for international queries and responses
- 🎯 **Parameter Management**: Comprehensive parameter handling through traits
- ✨ **Easy Implementation**: Simple, chainable API methods
- 🔄 **Method Chaining**: Fluent interface for setting options
- ⚙️ **Validation**: Built-in parameter validation for all setters

Requirements
------------

[](#requirements)

- PHP 7.4 or later
- WordPress 5.0 or later
- Google Places API key

Installation
------------

[](#installation)

Install via Composer:

```
composer require arraypress/google-places
```

Basic Usage
-----------

[](#basic-usage)

```
use ArrayPress\Google\Places\Client;

// Initialize client with your API key
$client = new Client( 'your-google-api-key', true, DAY_IN_SECONDS );

// Get place details
$place = $client->get_place_details( 'place-id' );
$address = $place->get_formatted_address();
$coordinates = $place->get_coordinates();

// Search for places
$results = $client
    ->set_search_type( 'restaurant')
    ->set_language( 'en')
    ->find_places( 'pizza in Seattle' );

// Nearby search
$nearby = $client
    ->set_open_now( true )
    ->nearby_search( 47.6062, -122.3321, 1000 );

// Autocomplete
$predictions = $client
    ->set_autocomplete_types( [ 'establishment' ] )
    ->get_autocomplete_predictions( 'Space Needle' );
```

Configuration Methods
---------------------

[](#configuration-methods)

### Setting Options

[](#setting-options)

```
// Search parameters
$client->set_search_type( 'restaurant' );    // Set place type
$client->set_search_keyword( 'pizza' );      // Set search keyword
$client->set_language( 'en' );               // Set language
$client->set_min_price( 1 );                 // Set minimum price level (0-4)
$client->set_max_price( 3 );                 // Set maximum price level (0-4)
$client->set_open_now( true );               // Filter for open places
$client->set_rank_by( 'distance' );          // Set ranking method

// Autocomplete parameters
$client->set_autocomplete_types( [ 'establishment' ] );
$client->set_autocomplete_location( 47.6062, -122.3321, 5000 );
$client->set_strict_bounds( true );

// Photo parameters
$client->set_photo_max_width( 800 );
$client->set_photo_max_height( 600 );

// Cache settings
$client->set_cache_enabled( true );
$client->set_cache_expiration( HOUR_IN_SECONDS );
```

### Getting Options

[](#getting-options)

```
// Search configuration
$type = $client->get_search_type();        // Current search type
$keyword = $client->get_search_keyword();   // Current search keyword
$language = $client->get_language();        // Current language
$min_price = $client->get_min_price();     // Current minimum price
$open_now = $client->get_open_now();       // Current open now filter

// Autocomplete settings
$types = $client->get_autocomplete_types();
$location = $client->get_autocomplete_location();
$bounds = $client->get_strict_bounds();

// Photo settings
$max_width = $client->get_photo_max_width();
$max_height = $client->get_photo_max_height();

// Cache settings
$cache_enabled = $client->is_cache_enabled();
$cache_expiration = $client->get_cache_expiration();
```

Extended Examples
-----------------

[](#extended-examples)

### Working with Place Details

[](#working-with-place-details)

```
$place = $client->get_place_details( 'place-id' );

// Get basic information
$name = $place->get_formatted_address();
$coordinates = $place->get_coordinates();
$phone = $place->get_formatted_phone_number();
$website = $place->get_website();

// Get structured address
$address = $place->get_structured_address();
echo $address['street_number'] . ' ' . $address['street_name'];
echo $address['city'] . ', ' . $address['state'];

// Check opening hours
$hours = $place->get_formatted_opening_hours();
$is_open = $place->is_open_now();
echo $place->get_opening_hours_html();

// Get reviews and ratings
$rating = $place->get_rating();
$reviews = $place->get_reviews();
$total_ratings = $place->get_user_ratings_total();

// Get photos
$photos = $place->get_photos();
foreach ( $photos as $photo ) {
    $photo_url = $client->get_place_photo_url( $photo['photo_reference'] );
}
```

### Search Operations

[](#search-operations)

```
// Text search with filters
$client
    ->set_search_type( 'restaurant')
    ->set_min_price( 2 )
    ->set_max_price( 4 )
    ->set_open_now( true );

$results = $client->text_search( 'fine dining Seattle' );

// Nearby search with ranking
$client
    ->set_search_type( 'cafe')
    ->set_rank_by( 'distance' );

$nearby = $client->nearby_search( 47.6062, -122.3321, 1000 );

// Autocomplete with location bias
$client
    ->set_autocomplete_types( [ 'establishment' ] )
    ->set_autocomplete_location( 47.6062, -122.3321, 5000 )
    ->set_strict_bounds( true );

$predictions = $client->get_autocomplete_predictions( 'Space' );
```

### Geocoding

[](#geocoding)

```
// Forward geocoding
$response = $client->geocode( '1600 Amphitheatre Parkway, Mountain View, CA' );
$location = $response->get_coordinates();

// Structured address geocoding
$address = [
    'street' => '1600 Amphitheatre Parkway',
    'city' => 'Mountain View',
    'state' => 'CA'
];
$response = $client->geocode( $address );
```

API Methods
-----------

[](#api-methods)

### Main Methods

[](#main-methods)

- `get_place_details( $place_id, $fields = [] )`: Get detailed place information
- `find_places( $query )`: Search for places by text query
- `nearby_search( $lat, $lng, $radius )`: Search for nearby places
- `text_search( $query )`: Perform a text search
- `geocode( $address )`: Geocode an address
- `get_autocomplete_predictions( $input )`: Get place predictions
- `get_place_photo_url( $photo_reference )`: Get photo URL
- `clear_cache( $identifier = null )`: Clear cached data

### Response Methods

[](#response-methods)

- `get_formatted_address()`: Get formatted address
- `get_coordinates()`: Get location coordinates
- `get_structured_address()`: Get detailed address components
- `get_opening_hours()`: Get opening hours
- `is_open_now()`: Check if place is currently open
- `get_rating()`: Get place rating
- `get_reviews()`: Get place reviews
- `get_photos()`: Get place photos
- `get_website()`: Get place website
- `get_phone_number()`: Get contact number
- `get_price_level()`: Get price level
- `get_business_status()`: Get business status

Use Cases
---------

[](#use-cases)

- **Business Directory**: Create comprehensive business listings
- **Store Locator**: Build store/location finder systems
- **Autocomplete Forms**: Enhance address input forms
- **Business Details**: Display rich business information
- **Location Validation**: Verify and standardize addresses
- **Review Display**: Show business reviews and ratings
- **Opening Hours**: Display business hours and status
- **Photo Galleries**: Show place photos
- **Price Information**: Display price level indicators
- **Business Search**: Implement location-based search
- **Address Verification**: Validate and format addresses
- **Geographic Data**: Work with location coordinates

Contributing
------------

[](#contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

License
-------

[](#license)

This project is licensed under the GPL-2.0-or-later License.

Support
-------

[](#support)

- [Documentation](https://github.com/arraypress/google-places)
- [Issue Tracker](https://github.com/arraypress/google-places/issues)

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance32

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity16

Early-stage or recently created project

 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.

### Community

Maintainers

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

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/arraypress-google-places/health.svg)

```
[![Health](https://phpackages.com/badges/arraypress-google-places/health.svg)](https://phpackages.com/packages/arraypress-google-places)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

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