Download the PHP package arraypress/google-maps-static without Composer

Google Maps Static API for WordPress

A PHP library for integrating with the Google Maps Static API in WordPress, providing easy-to-use methods for generating static map images with various features including markers, paths, styled maps, and custom locations. Features WordPress integration and WP_Error support.

Features

• 🗺️ Multiple Map Types: Support for roadmap, satellite, terrain, and hybrid views
• 📍 Marker Integration: Add custom markers with various styles and positions
• 🛣️ Path Drawing: Create routes and shapes with customizable paths
• 🎨 Custom Styling: Comprehensive map styling options
• ⚡ WordPress Integration: Native WP_Error support and URL escaping
• 🛡️ Type Safety: Full type hinting and strict types
• 📐 Flexible Sizing: Custom dimensions and scale options
• 🌍 Global Support: Works with locations worldwide, with language and region settings
• 🎯 Multiple Formats: Support for PNG, JPG, and GIF outputs
• 📱 Responsive: Support for different scale factors
• ✨ Easy Implementation: Simple, chainable API methods
• 💾 Media Library Integration: Save maps directly to WordPress media library
• 🎥 Street View Support: Configure heading and pitch for street view perspectives
• 🔄 Method Chaining: Fluent interface for setting options
• ⚙️ Validation: Built-in parameter validation for all setters

Requirements

• PHP 7.4 or later
• WordPress 5.0 or later
• Google Maps Static API key

Installation

Install via Composer:

Basic Usage

Configuration Methods

Setting Options

Getting Options

Extended Examples

Saving Maps to Media Library

Working with Markers

Creating Paths

Styled Maps

Street View Configuration

API Methods

Main Methods

• location( $location, $options = [] ): Generate URL for a specific location
• markers( $markers, $options = [] ): Generate URL with custom markers
• path( $path_points, $options = [] ): Generate URL with a path
• styled( $styles, $options = [] ): Generate URL with custom styling
• save_to_media_library( $url, $args = [] ): Save static map to WordPress media library
• generate_image_tag( $url, $attrs = [] ): Generate complete img HTML tag
• validate_api_key(): Verify if the API key is valid

Setter Methods

• set_size( $width, $height): Set map dimensions
• set_zoom( $level): Set zoom level (0-21)
• set_map_type( $type): Set map type
• set_format( $format): Set image format
• set_scale( $scale): Set map scale
• set_language( $language): Set map labels language
• set_region( $region): Set map region bias
• set_heading( $degrees): Set street view heading (0-360)
• set_pitch( $degrees): Set street view pitch (-90 to 90)
• set_api_key( $api_key): Set new API key

Getter Methods

• get_size(): Get current dimensions
• get_zoom(): Get current zoom level
• get_map_type(): Get current map type
• get_format(): Get current image format
• get_scale(): Get current scale value
• get_language(): Get current language
• get_region(): Get current region
• get_heading(): Get current heading
• get_pitch(): Get current pitch
• get_api_key(): Get current API key
• get_options(): Get all current options

Options Parameters

Common Options

• size: Map dimensions (required)
• zoom: Zoom level (0-21)
• maptype: Map type (roadmap, satellite, terrain, hybrid)
• format: Image format (png, jpg, gif)
• scale: Image scale (1, 2, 4)
• language: Map labels language (e.g., 'en', 'es', 'fr')
• region: Region bias (e.g., 'US', 'GB')
• heading: Street view heading in degrees (0-360)
• pitch: Street view pitch in degrees (-90 to 90)

Marker Options

• color: Marker color
• size: Marker size (tiny, mid, small)
• label: Single character label
• icon: Custom icon URL
• scale: Marker scale

Path Options

• weight: Line weight
• color: Line color
• geodesic: Follow earth's curvature
• fillcolor: Fill color for closed paths

Use Cases

• Business Listings: Display store locations
• Real Estate: Show property locations
• Event Maps: Display venue locations
• Travel Routes: Visualize travel paths
• Location Markers: Highlight multiple points
• Custom Territory: Display service areas
• Geographic Data: Visualize data points
• Styled Maps: Brand-specific map designs
• Direction Overview: Show route overview
• Location Context: Add visual location context
• Street Level Views: Show building facades and street perspectives

Contributing

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

License

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

Support

• Documentation
• Issue Tracker