MapView.ShowAddress
-------------------

Shows an address.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [MapView](component_MapView.md) | [9.0](newinversion90.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

MBS( "MapView.ShowAddress"; MapView; Address { ; addPin; Identifier; Color } ) 

**MBS**( **"MapView.ShowAddress";** /\* Shows an address. \*/  
**$MapView**; /\* The map view reference number.e.g. $$MapView \*/   
**$Address**; /\* The address to lookup."e.g. "New York" \*/   
**$addPin**; /\* Optional; Whether to add a pin.  
Pass 0 to just show the area or 1 to add pin and show the area.e.g. 1 \*/   
**$Identifier**; /\* Optional; The identifier for the pin to use with script trigger. \*/   
**$Color**) /\* Optional; The color to use.   
Can be a color name or hex notation like in HTML.e.g. "#FF0000" \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| MapView | The map view reference number. | $$MapView |  |
| Address | The address to lookup." | "New York" |  |
| addPin | Whether to add a pin.   Pass 0 to just show the area or 1 to add pin and show the area. | 1 | Optional |
| Identifier | The identifier for the pin to use with script trigger. |  | Optional      Added in version **9.3**. |
| Color | The color to use.    Can be a color name or hex notation like in HTML. | "#FF0000" | Optional      Added in version **9.3**. |

### Result

Returns OK, identifier or error.

### Description

Shows an address.  
Asynchronously queries coordinate for given address and shows it.  
### Examples

Show pin in New York in green:

 MBS ("MapView.ShowAddress"; $$MapView ; "New York"; 1; ""; "#00FF00")  
### Release notes

- **Version 9.5**
    - Fixed bug with [MapView.ShowAddress](http://www.mbsplugins.eu/MapViewShowAddress.shtml) zooming too close.
- **Version 9.4**
    - Changed [MapView.AddPin](http://www.mbsplugins.eu/MapViewAddPin.shtml), [MapView.AddPinWithAddress](http://www.mbsplugins.eu/MapViewAddPinWithAddress.shtml) or [MapView.ShowAddress](http://www.mbsplugins.eu/MapViewShowAddress.shtml) to return identifier for new pin.
- **Version 9.3**
    - Added identifier and color parameters for [MapView.AddPin](http://www.mbsplugins.eu/MapViewAddPin.shtml), [MapView.AddPinWithAddress](http://www.mbsplugins.eu/MapViewAddPinWithAddress.shtml), [MapView.PlanRoute](http://www.mbsplugins.eu/MapViewPlanRoute.shtml) and [MapView.ShowAddress](http://www.mbsplugins.eu/MapViewShowAddress.shtml) functions.
    - Fixed [MapView.ShowAddress](http://www.mbsplugins.eu/MapViewShowAddress.shtml) to correctly center on the found placemark instead of the region for that placemark.
- **Version 9.1**
    - Changed [MapView.ShowAddress](http://www.mbsplugins.eu/MapViewShowAddress.shtml) and [MapView.AddPinWithAddress](http://www.mbsplugins.eu/MapViewAddPinWithAddress.shtml) to return errors if address is not found.

### Example Databases

- [iOS/Examples/MapKit iOS](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/iOS/Examples/MapKit%20iOS.shtml#5ScriptAnchor_)
- [Mac and iOS/MapKit/MapView BeeExample](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/MapKit/MapView%20BeeExample.shtml#31ScriptAnchor_)
- [Mac and iOS/MapKit/MapView](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/MapKit/MapView.shtml#7ScriptAnchor_)

### Blog Entries

- [MBS FileMaker Advent calendar - Door 11 - Know Your Way](https://www.mbsplugins.de/archive/2024-12-11/MBS_FileMaker_Advent_calendar_/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 9.5pr4](https://www.mbsplugins.de/archive/2019-10-21/MBS_FileMaker_Plugin_version_9/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 9.4pr6](https://www.mbsplugins.de/archive/2019-09-09/MBS_FileMaker_Plugin_version_9/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 9.3pr2](https://www.mbsplugins.de/archive/2019-06-12/MBS_FileMaker_Plugin_version_9/monkeybreadsoftware_blog_filemaker)
- [More on MapViews in FileMaker](https://www.mbsplugins.de/archive/2019-06-07/More_on_MapViews_in_FileMaker/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 9.1pr2](https://www.mbsplugins.de/archive/2019-02-11/MBS_FileMaker_Plugin_version_9/monkeybreadsoftware_blog_filemaker)
- [Apple Maps in FileMaker on iOS](https://www.mbsplugins.de/archive/2019-01-23/Apple_Maps_in_FileMaker_on_iOS/monkeybreadsoftware_blog_filemaker)

### FileMaker Magazin

- [Ausgabe 2/2022, Seite 30 bis 31](https://filemaker-magazin.de/neuigkeit/4174-Appetithappen-FMM_202202)

This function is free to use.

Created 14th January 2019 , last changed 9th September 2019

  
[MapView.SetZoomLevel](MapViewSetZoomLevel.md) - [MapView.ShowAllAnnotations](MapViewShowAllAnnotations.md)

[HTML Version](MapViewShowAddress.shtml)