Skip to main content

Address to Coordinates

Converts a textual address to geographic coordinates (latitude and longitude) using Google Maps API.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Address - The textual address to convert to coordinates (e.g., "1600 Amphitheatre Parkway, Mountain View, CA").

Options​

  • Credentials - Google Maps API key credential used to authenticate with the service.

Output​

  • Result - The geocoding result containing latitude and longitude coordinates along with additional address information.

How It Works​

The Address to Coordinates node converts a textual address into geographic coordinates using Google Maps Geocoding API. When executed, the node:

  1. Validates the provided address input
  2. Retrieves the Google Maps API key from credentials
  3. Creates a Geocoding request with the provided address
  4. Sends the request to Google Maps Geocoding API
  5. Returns the geocoding result which includes:
    • Latitude and longitude coordinates
    • Formatted address
    • Address components (street, city, state, etc.)
    • Place ID
    • Geometry information

Requirements​

  • A valid Google Maps API key with Geocoding API enabled
  • Valid address input

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid address input
  • Invalid or missing Google Maps API credentials
  • Google Maps API service errors
  • Network connectivity issues

Usage Notes​

  • The address should be as specific as possible for accurate results
  • The API key must have Geocoding API permissions enabled
  • The result contains multiple address components that can be parsed as needed
  • Multiple results may be returned for ambiguous addresses
  • The node returns structured data that can be used with other map-related nodes