GoogleMaps

Details

ID	`GoogleMaps`
Provider	Google
Category	Utilities
From Version	6.0.0
Docker Image	`demisto/python3:3.12.13.10116658`
Supported Modules	Agentix XSIAM EDR Cortex Cloud Attack Surface Management Cloud Runtime Security Cloud Posture Security Exposure Management

README

Use the Google Maps API. This integration was integrated and tested with version 3.43 of the Google Maps API. This integration always uses the latest API version.

Configure GoogleMaps in Cortex

Note

In order to use the embedded Google Maps view, make sure a Google Maps Geocoding API key is set in Cortex XSOAR.

Parameter	Description	Required
Google Maps API Key	The API key to use for the connection.	True
Raise error an empty result	Whether to consider empty results as an error.	False
Base URL		True
Trust any certificate (not secure)		False
Use system proxy settings		False

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

google-maps-geocode

Returns the coordinates of the given physical address. Only the first result is returned (the most relevant, according to Google Maps).

Base Command

google-maps-geocode

Input

Argument Name	Description	Required
search_address	The physical address to be geocoded.	Required

Context Output

Path	Type	Description
GoogleMaps.SearchAddress	String	The address provided as input. For example, a postal address, a business name, or an area.
GoogleMaps.Address	String	Address of the geocoded location.
GoogleMaps.lat	Number	Latitude of the geocoded location.
GoogleMaps.lng	Number	Longitude of the geocoded location.
GoogleMaps.Country	String	Country of the geocoded location.

Command Example

google-maps-geocode address=45 rothschild tel aviv

Human Readable Output

Results

Address	Search Address	Lat	Lng
Rothschild Blvd 45, Tel Aviv-Yafo, Israel	45 rothschild tel aviv	32.0642807	34.774554

Configuration parameters

api_key — Google Maps API Key (required)
error_on_no_results — Raise error an empty result
insecure — Trust any certificate (not secure)
base_url — Base URL (required)
proxy — Use system proxy settings

Commands (1)

google-maps-geocode
Returns the coordinates of the given physical address. Only the first result is returned (the most relevant, according to Google Maps).

Source

GoogleMaps.py GoogleMaps_test.py GoogleMaps.yml GoogleMaps_description.md command_examples.txt

Download History Raw

category: Utilities
provider: Google
commonfields:
  id: GoogleMaps
  version: -1
configuration:
- display: Google Maps API Key
  additionalinfo: The API key to use for the connection.
  hiddenusername: true
  displaypassword: API Key
  name: api_key
  required: true
  type: 9
- display: Raise error an empty result
  name: error_on_no_results
  type: 8
  required: false
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
- display: Base URL
  name: base_url
  required: true
  defaultvalue: https://maps.googleapis.com/maps/api/
  type: 0
- display: Use system proxy settings
  name: proxy
  type: 8
  required: false
description: Use the Google Maps API.
display: Google Maps
name: GoogleMaps
script:
  commands:
  - arguments:
    - default: true
      description: The physical address to be geocoded.
      name: search_address
      required: true
    description: Returns the coordinates of the given physical address. Only the first result is returned (the most relevant, according to Google Maps).
    name: google-maps-geocode
    outputs:
    - contextPath: GoogleMaps.lat
      description: Latitude of the provided location.
      type: Number
    - contextPath: GoogleMaps.lng
      description: Longitude of the provided location.
      type: Number
    - contextPath: GoogleMaps.SearchAddress
      description: The address provided as input.
      type: String
    - contextPath: GoogleMaps.Address
      description: The address provided by Google Maps for the provided location.
      type: String
    - contextPath: GoogleMaps.Country
      description: The country or region where the provided location is, according to Google Maps.
      type: String
  dockerimage: demisto/python3:3.12.13.10116658
  runonce: false
  script: '-'
  subtype: python3
  type: python
tests:
- GoogleMapsTest
fromversion: 6.0.0