Maps¶

EspoCRM supports Google Maps out of the box.

Google Maps¶

Api Key¶

To use Google Maps, you need to specify the API Key (at Administration > Integration > Google Maps). Geocoding API, Maps JavaScript API, Maps Static API must be enabled in Google Maps Platform.

Showing map for address field¶

As a field in detail view¶

Every Address field has a corresponding Map field. You need to add it to the Detail layout. Administration > Entity Manager > {Entity Type} > Layouts > Detail > Drag & Drop Map field. You can make the cell wide using the minus sign.

You can also configure the height of your field. Administration > Entity Manager > {Entity Type} > Fields > find the map field and click on it > edit the height and save.

Administration > Entity Manager > {Entity Type} > {needed address field} (e.g. Billing Address) > Check View Map Button and save.

View Map button should appear under the address field on the detail view. Note, that the address should contain either a city or postal code.

Printing in PDF¶

googleMapsImage helper is available for printing Google Maps in PDF.

Usage (in PDF Template):

{{googleMapsImage}}

Printing a specific address field:

{{googleMapsImage field='shippingAddress'}}

Printing a specific address:

{{googleMapsImage city='New York' country='United States'}}

Available options:

field
size - 300x300
zoom - integer value
language
street
city
state
postalCode
country

Example:

{{googleMapsImage size='400x400'}}