Gatemi Distance Shipping FAQ and Troubleshooting

Distance rate does not show at checkout

  1. Use Test a lookup on WooCommerce → Distance Shipping with the same address. If it fails, the screen names the likely reason.
  2. Check the method is added to the zone that address falls into, and is enabled.
  3. Check the address has a country and at least a postcode, street or city. Until then nothing is looked up.
  4. Check a band covers the distance. A journey beyond your last band gets no rate; end the list with a * band if you deliver any distance.
  5. Check the band above is not a time band (free edition) or a refusal band.

The test lookup says "No distance came back"

The usual causes, in order:

  • the Routes API is not enabled in the Google Cloud project the key belongs to;
  • the key is restricted by HTTP referrer — restrict it by your server's IP address instead;
  • billing is not set up, or the quota is spent;
  • the address cannot be found.

Full edition: tick Write failed lookups to WooCommerce → Status → Logs and the next failure is written there with Google's own words.

Does the shopper's browser talk to Google?

No. Every lookup is made from your server. The key is never printed in a page.

How much will Google charge?

That depends on your Google account and its pricing. The plugin keeps it low: one lookup per address pair, remembered for Remember a distance for days (30 by default), and no lookup at all until an address is specific enough to be worth one.

I changed my shop address — are old distances still used?

No. The origin is part of the remembered key, so a new origin means new lookups. Old entries simply expire.

The distance is different from Google Maps

The plugin asks for a route, not a straight line: a driving route in the free edition, your chosen travel mode in the full edition. Google Maps may show a different route or traffic conditions. The figure is what the Routes API returned at the time it was looked up and remembered.

A band with a comma did not work

A single comma is read as a decimal point (2,5 is 2.5, 0,80 is 0.80), except when exactly three digits follow it: 1,250 is read as 1250, a thousands separator. If you meant 1.25, write 1.25. A point always works.

In the full edition, a line with an extra after a semicolon (; item 0.50, ; 2%, ; min 5, ; max 20, ; free 80) is dropped whole if that extra cannot be read — check its spelling and that the amount is a number.

Does it work with the Checkout block?

Yes. Distance rate is an ordinary WooCommerce shipping method, so the Checkout block, the classic checkout and the cart's shipping calculator all offer it the same way.

Does it work with page-cache plugins?

Yes. Shipping is calculated in the cart and checkout, which caches do not serve to shoppers. The plugin has no storefront script or stylesheet.

Does it work with HPOS?

Yes. Both editions declare HPOS compatibility; the plugin writes nothing to orders. The rate lands on the order as an ordinary shipping line.

Will my zones survive moving to the full edition?

Yes. Both editions register the method under the same id, gmdrs_distance_rate, so the zone keeps its Distance rate and its bands. The settings (gmdrs_settings) and the remembered distances are shared too.

What does uninstalling remove?

  • Free edition: the remembered distances (every gmdrs_d_ transient, both halves), and gmdrs_settings only if the full edition has never been licensed on the site.
  • Full edition: gmdrs_settings, gmdrs_license, the cached update data, the licence-check schedule and the remembered distances.
  • Neither touches your shipping zones or the bands typed into them — those are WooCommerce's data, so a reinstalled plugin finds them where it left them.
Shopping Cart
Scroll to Top