Entity.ID Property

  • Article

Entity.ID Property

A unique identifier for a geographic entity.


Public ID As System.Integer


[C#]

public System.Int32 ID;

Remarks

  • The value of the ID property can be positive or negative. In a MapPoint Web Service data source, a positive value remains the same in different versions of the data source and can be considered a unique identifier that remains valid indefinitely. A negative value is a unique identifier for a given version of a data source but is not guaranteed to remain valid for future versions of the data source.

  • If an entity exists in multiple MapPoint Web Service data sources and has a positive value for the ID property, the ID is the same in all data sources. For example, the value of the ID property for the United States is 244 in the MapPoint.AP, MapPoint.BR, MapPoint.EU, MapPoint.NA, and MapPoint.World data sources.

    When you upload private data for use with MapPoint Web Service, we recommend that you follow these protocols for the entity IDs. For more information about requirements for private data sources, see the Help topic "Prepare location data for uploading" on the MapPoint Web Service Customer Services site (CSS). For information about how to access the site, see the information that you received when you enrolled in the service.

    For information about becoming a MapPoint Web Service customer, visit the MapPoint Web Service Web site.

  • For more information about MapPoint Web Service ID property values for countries and regions, see CountryRegion Entity IDs.

  • The ID property is contained within the FindResult.FoundLocation property returned by each method of the FindServiceSoap class.

Example

[Visual Basic]

'Output the EntityID of each found location
Dim findSpec As New FindSpecification()
findSpec.DataSourceName = "MapPoint.NA"
findSpec.InputPlace = "Seattle, WA"
findSpec.Options = New FindOptions()
findSpec.Options.ThresholdScore = 0

Dim foundResults As FindResults
foundResults = findService.Find(findSpec)
Console.WriteLine("Entity ID List")
Dim fr As FindResult
For Each fr In foundResults.Results
 Console.WriteLine(fr.FoundLocation.Entity.DisplayName + ":  " _
       + fr.FoundLocation.Entity.ID.ToString())
Next



[C#]

//Output the Entity ID of each found location
FindSpecification findSpec  = new FindSpecification();
findSpec.DataSourceName = "MapPoint.NA";
findSpec.InputPlace = "Seattle, WA";
findSpec.Options = new FindOptions();
findSpec.Options.ThresholdScore = 0;

FindResults foundResults;
foundResults = findService.Find(findSpec);
Console.WriteLine("Entity ID List");
foreach(FindResult fr in foundResults.Results)
{
 Console.WriteLine(fr.FoundLocation.Entity.DisplayName + ":  " 
  + fr.FoundLocation.Entity.ID.ToString());
}

See Also

  CountryRegion Entity IDs   |   Entity Class   |   FindServiceSoap