Skip to content

boldenamsterdam/googlemapsapi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚠️ This plugin is no longer maintained — Google Maps API plugin for Craft CMS 3.x

Bolden Google Maps API plugin for Craft CMS 3.x

A simple wrapper for Google Maps server-side web services to access through AJAX calls.

Requirements

This plugin requires Craft CMS 3 or later and a valid/active Google Maps API key.

Overview

Use this wrapper to access Google Maps web services that are only accessible with a server-side connection. At the moment the following endpoints are supported with this plugin:

  • Geocode
  • Timezone
  • Places
  • Autocomplete
  • Input
  • Details
  • Elevation
  • Distance

Configuration

Enter a valid/active Google Maps API key in the plugin settings, easy does it.

Usage

Use HTTP GET request to access the endpoints

  • api/googleMaps/geocode/<latitude>,<longitude>
    Return the places given the latitude and longitude
    See more info at Google Geocoding API
  • api/googleMaps/timezone/<latitude>,<longitude>,<timestamp>
    Return the timezone of a place given the latitude, longitude and timestamp
    See more info at Google Timezone API
  • api/googleMaps/place/autocomplete/<input>
    Return place autocomplete suggestions given the text input (it can be an address, a place name etc)
    See more info at Places Autocomplete API
  • api/googleMaps/place/text/<input>/<fields>
    Return places given the text input (it can be an address, a place name etc). You can also define a comma sereparted list of the fields to return See more info at Places Search API
  • api/googleMaps/place/details/<placeId>
    Return place details given the place id . See more info at Places Details API
  • api/googleMaps/elevation/<lat>,<lon>
    Return elevation information given the latitude and longitude of a location
    See more info at Elevation API
  • api/googleMaps/distance/<originLat>,<originLon>,<destinationLat>,<destinationLon>,<mode>
    Return elevation information given the latitude and longitude of origin and destination. You can optionaly specify the mode (choose between driving, bicycling, walking, transit)
    See more info at Distance Matrix API

Example

Request
GET https://www.example.com/api/googleMaps/geocode/52.3679843,4.903561399999944

Response

[
  {
    "address_components": [
      {
        "long_name": "662",
        "short_name": "662",
        "types": [
          "street_number"
        ]
      },
      {
        "long_name": "Waterlooplein",
        "short_name": "Waterlooplein",
        "types": [
          "route"
        ]
      },
      {
        "long_name": "Amsterdam-Centrum",
        "short_name": "Amsterdam-Centrum",
        "types": [
          "political",
          "sublocality",
          "sublocality_level_1"
        ]
      },
      {
        "long_name": "Amsterdam",
        "short_name": "Amsterdam",
        "types": [
          "locality",
          "political"
        ]
      },
      {
        "long_name": "Amsterdam",
        "short_name": "Amsterdam",
        "types": [
          "administrative_area_level_2",
          "political"
        ]
      },
      {
        "long_name": "Noord-Holland",
        "short_name": "NH",
        "types": [
          "administrative_area_level_1",
          "political"
        ]
      },
      {
        "long_name": "Netherlands",
        "short_name": "NL",
        "types": [
          "country",
          "political"
        ]
      },
      {
        "long_name": "1011 PG",
        "short_name": "1011 PG",
        "types": [
          "postal_code"
        ]
      }
    ],
    "formatted_address": "Waterlooplein 662, 1011 PG Amsterdam, Netherlands",
    "geometry": {
      "location": {
        "lat": 52.3680461000000008198185241781175136566162109375,
        "lng": 4.90357839999999978175537762581370770931243896484375
      },
      "location_type": "ROOFTOP",
      "viewport": {
        "northeast": {
          "lat": 52.369395080291496924473904073238372802734375,
          "lng": 4.9049273802915021036596954218111932277679443359375
        },
        "southwest": {
          "lat": 52.36669711970849760973578668199479579925537109375,
          "lng": 4.90222941970849834802947952994145452976226806640625
        }
      }
    },
    "place_id": "ChIJ5zzsu70JxkcRQR-0VFl8Bl0",
    "plus_code": {
      "compound_code": "9W93+6C Amsterdam, Netherlands",
      "global_code": "9F469W93+6C"
    },
    "types": [
      "street_address"
    ]
  }
]

Credits

Made with ❤️ by Bolden and free to use.

About

Bolden's free plugin for Google Maps server-side web services on Craft CMS 3

Resources

License

Stars

Watchers

Forks

Packages

No packages published