@dewib/parcel-stores-locator

Table of Contents

• Features
• Usage

Module to Expose and draw on the map the locations of parcel retrieval from most shippers such as UPS, DHL, La Poste, Mondial Relay ...

Requirements

Please use the version of node 13 if you want to support native i18n or include intl during node compilation

Features

• Api plugin (SSR, Client side) to return locations according to provider (Ups and more soon)
• Maps components to display location (Gmap and more soon)
• List component to display location

Usage

Set the parcelStoresLocator option in nuxt.config:

export default {
  parcelStoresLocator {
    providers: {
      ups: {
        // Ups configuration
      },
      mondialrelay: {
        // Mondial Relay configuration
      }
    }
  }
}

Note: If using nuxt 2.10...2.13, you will have to import components manually otherwise install and add @nuxt/components to buildModules inside nuxt.config.

parcelStoresLocator will automatically load provider according to configuration.

Components

Parcel Stores locator inject vue components with components:dirs nuxt hook to display the stores inside a map.

Gmap

Please add nuxt-gmaps and set your configuration:

export default {
  parcelStoresLocator {
    gmap: {
      location: {
        icon: 'data:image/png;base64,...' // Change default gps location icon
      },
       compass: {
        icon: 'data:image/png;base64,...' // Change default compass icon
      },
      pins: {
        selected: {
          icon: 'data:image/png;base64,...' // Please provide selected pin
        },
        unselected: {
          icon: 'data:image/png;base64,...' // Please provide unselected pin
        }
      },
      // TODO: Add more config
    }
  }
}

Then inside your page

<parcel-stores-locator-gmap
  v-model="selected" // selected store
  :position="position"  // position of user (ex: GPS position)
  :locations="stores" // All locations returned by $parcelStoresLocator.getGeolocation()
  @select="select" // Select event from map
/>

Methods

You can access to component methods by using the ref argument. For instance we would like to zoom map to locations after display: none removed

<parcel-stores-locator-gmap
  ref="map"
/>

Then in your component

methods: {
  openMap () {
    openMap () {
      this.opened = true
      this.$nextTick(this.$refs.map.zoomOnLocations)
    }
  }
}

Changelog

1.1.0 (2022-02-16)

Features

• provider: add mondial relay (e0f44e0)
• ups: handle i18n for opening hours (3a50b9d)
• add zoomOnLocations method and explain how to access from ref (30cdc19)
• auto zoom on locations after init (9a12b7a)
• convert opening hours to good format (1029401)
• components: add default icon location (28c3b71)
• components: add slot for custom map (b4ca105)
• plugin: add default timeout for geolocation (a9d996c)
• plugin: add getGeolocation method (2710606)
• providers: return postcode from request (c41c921)
• README: add gmap documentation (fea3321)
• add gmap component (7c03206)
• add plugin (700bf20)

Bug Fixes

• ups: remove accent to avoid error from ups (3a8cfa5)
• cast distance as float (76055d9)
• cast geocode values as string (0a8d075)
• change long to lng and parse to float (198a638)
• return response as [error, response] (b32a4f7)