Google Map Distance Matrix action is used to collect distance and time information between one or more starting points and one or more destination points in bulk. The user can obtain travel time and distance information via Google Maps by entering the origins and destinations parameters. It is frequently preferred in logistics, delivery planning, travel applications, and route optimization scenarios.

Technical Specifications

• Function: Returns distance and duration information for multiple point combinations.
• Parameters:
  
  • settings (Object – required): Connection settings required for Google Maps integration.
  • origins (String – Many, required): Starting points (address or coordinates).
  • destinations (String – Many, required): Destinations (address or coordinates).
  • mode (String – optional): Mode of transportation. Supported values:
    
    • “driving” → Vehicle
    • “walking” → Pedestrian
    • ‘bicycling’ → Bicycle
    • “transit” → Public transportation
• Result: Singular (One) → Returns distance and time for each origin and destination combination.
• Value Binding:
  
  • Parameters can be entered as fixed.
  • Can be dynamically bound via form inputs or user selection.
• Web & Mobile Support: Can be used in both web and mobile applications.

Google Map Distance Matrix Application Steps

1. Add Action

• Open the screen where distance/time will be calculated in the Kuika project.
• Add UI Design → + ADD ACTION → Google → Google Map Distance Matrix.

2. Configure Parameters

• origins: “Izmir, Turkey”, “38.4192,27.1287”.
• destinations: “Ankara, Turkey”, “39.9334,32.8597”.
• mode: “driving”.

Usage Scenario: “Delivery Time Calculation”

In a logistics application, delivery times from the warehouse address to different customer addresses need to be calculated.

Steps:

1. origins = “Warehouse: Izmir”.
2. destinations = [“Customer1: Ankara”, “Customer2: Istanbul”].
3. mode = driving is selected.
4. Google Map Distance Matrix runs → returns distance and time information for each customer.
5. Results are displayed in a table on the screen.

Google Map Distance Matrix Advanced Customizations

• Batch Calculation: Multiple start and destination points can be used simultaneously.
• Optimization: The shortest or fastest route can be selected using the returned results.
• Dynamic Use: The user's current location can be automatically linked to the origins parameter.

Technical Risks and Controls

• If origins or destinations are empty, the action returns an error.
• Incorrectly written addresses or incorrect coordinates will not return results.
• Too many combinations may exceed the API quota limit (e.g., 100+ points).