Google Maps API Instellen voor Magento 2

Configureer je Google Maps API key voor de Verzendkosten op basis van afstand extensie. Deze handleiding leidt je door het maken van een Google Cloud project, het inschakelen van de vereiste APIs, en het instellen van je credentials.

Vereiste API

De extensie vereist de Distance Matrix API van Google Cloud Platform. Deze API berekent reisafstanden tussen je winkellocatie en klantadressen.

Stap 1: Maak een Google Cloud Project

1. Ga naar Google Cloud Console
2. Log in met je Google account
3. Klik op de project dropdown bovenaan de pagina
4. Klik New Project
5. Voer een projectnaam in (bijv. "Magento Verzending")
6. Klik Create
7. Wacht tot het project is aangemaakt en selecteer het dan

Stap 2: Schakel Facturering In

De Distance Matrix API vereist een factureringsaccount. Google geeft $200 gratis tegoed per maand.

1. Ga naar Billing in het linker menu
2. Klik Link a billing account
3. Volg de stappen om facturering in te stellen
4. Voeg een betaalmethode toe

Let op: Je wordt niet gefactureerd tenzij je de gratis limieten overschrijdt.

Stap 3: Schakel Distance Matrix API In

1. Ga naar APIs & Services → Library
2. Zoek naar "Distance Matrix API"
3. Klik op Distance Matrix API
4. Klik Enable

Stap 4: Maak API Key Aan

1. Ga naar APIs & Services → Credentials
2. Klik + Create Credentials
3. Selecteer API key
4. Je nieuwe API key wordt getoond
5. Klik Copy om de key te kopiëren
6. Klik Close

Stap 5: Beperk Je API Key (Aanbevolen)

Bescherm je API key tegen ongeautoriseerd gebruik:

1. Klik op de Credentials pagina op je API key naam
2. Onder Application restrictions:
   • Voor testen: Selecteer None
   • Voor productie: Selecteer IP addresses en voeg je server IP toe
3. Onder API restrictions:
   • Selecteer Restrict key
   • Vink Distance Matrix API aan
4. Klik Save

Stap 6: Configureer in Magento

1. Ga naar Magmodules → Shipping Costs Based on Distance
2. Onder General → API and Location Details:
   • Plak je API key in het API Key veld
   • Voer je Store Address in (volledig adres inclusief land)
3. Klik Test Credentials om de verbinding te verifiëren
4. Klik Save Config

API Prijzen

Google rekent per verzoek aan de Distance Matrix API:

Maandelijks gratis tegoed: $200 (dekt ~40.000 verzoeken)

Wanneer worden verzoeken gemaakt?

• Wanneer een klant hun verzendadres invoert/wijzigt bij checkout
• Bij gebruik van de productpagina verzendschatter
• Tijdens selftest/credential testen

Gebruik Monitoren

Volg je API gebruik om kosten te beheren:

1. Ga naar APIs & Services → Dashboard
2. Klik op Distance Matrix API
3. Bekijk de Traffic grafiek voor aantal verzoeken
4. Check Errors voor eventuele gefaalde verzoeken

Stel Budget Alerts In

Winkeladres Best Practices

Het winkeladres dat je invoert is het startpunt voor alle afstandsberekeningen.

Wel:

• Gebruik je magazijn of fulfillment center adres
• Voeg volledig adres toe: straat, stad, postcode, land
• Gebruik het adresformaat dat Google Maps herkent

Voorbeelden van Goede Adressen:

Magazijnstraat 123, Amsterdam, 1012 AB, Nederland
Distributieweg 456, Rotterdam, 3011 BC, NL

Niet:

• Gebruik geen postbusadressen
• Gebruik geen incomplete adressen
• Gebruik geen adressen die Google niet kan vinden

Je Setup Testen

Na configuratie, verifieer dat alles werkt:

1. Test Credentials Knop

   • Klik de knop in configuratie
   • Zou succesbericht moeten tonen

2. Selftest Commando

   • Voer uit: bin/magento distancebasedshipping:selftest
   • Controleert API connectiviteit en configuratie

3. Checkout Test

   • Voeg een product toe aan winkelwagen
   • Ga naar checkout
   • Voer een verzendadres in
   • Verifieer dat afstand-gebaseerde verzendoptie verschijnt

API Problemen Oplossen

"API key not valid"

"This API project is not authorized"

"You have exceeded your daily request quota"

"REQUEST_DENIED"

"ZERO_RESULTS"

Meer Hulp Nodig?

Documentatie:

• Alle Help Artikelen - Compleet documentatie overzicht

Support:

• Contact Opnemen - Hulp van ons team

Google Bronnen:

• Distance Matrix API Documentatie
• Google Cloud Console