Open APIs

I'm no expert in location management so I will refrain from answering, I was hoping the experts share their knowledge first.

I suggest you use the search box and search for the key terms or API numbers and hopefully the title will be enough or you have to read the comments.
use TM Forum's AIVA, it does an OK job at finding relevant posts in the community.

But your questions were definitely discussed in this community.

Hi Jiri,

It is good to understand the purpose and layering of the different Geographic Entities  (places).

TMF675 GeographicLocation describes places using coordinates and geometric figures (point, line, polygon, multi-point, multi-line, multi-polygon). The coordinates are often GPS based but GIS systems use many other coordinates systems from cartography. 

TMF673 GeographicAddress describe places using a hierarchical system originated from the postal services. It obviously has to cope with historic differences between countries. The GeographicAddress entity repressent the public domain part of the address and GeographicSubAddress is used for detailed addresses in the private domain. The GeographicAddress has a geographicLocation property to link it to a TMF672 entity. The GeographicSubAddress has two types indicated by the value of subAddressType

• subunit is used to describe a units e.g. appartment inside a building.
• privateStreet is used to describe building in a campus

This last type is there for your campus use case and has privateStreetName, privateStreetNumber and buildingName.

TMF675 and TMF673 both describe places with conventions that are outside the control of the CSP and provided by external sources. The CSP will however have to continuously update this information to cover changes in the outside world. This often involves a verification, enrichment and certification process to maintain data quality.

TMF674 GeographicSite is used to document places under control of the CSP: a tower site, a datacenter or a streetcabinet, ... They typically have a lifeCycle linked to processes at the CSP and has various features that can be documented: power supply, cooling, acces control, health & safety, rental, subsidies. GeographicSite are often linked to GeographicAddress, GeographicSubAddress and/or GeographicLocation.

Best practice is to use relationships only in one direction:

• GeographicLocation (coordinate based places) have no external relationships
• GeographicAddress and GeographicSubAddress can reference GeographicLocation
• GeographicSite can reference all of the above

Deviating from this best practise makes data maintenance more difficult. e.g. Postal services don't know about the CSP controlled sites.

I hope this information is useful.

Hi Jiri,

It is good to understand the purpose and layering of the different Geographic Entities  (places).

TMF675 GeographicLocation describes places using coordinates and geometric figures (point, line, polygon, multi-point, multi-line, multi-polygon). The coordinates are often GPS based but GIS systems use many other coordinates systems from cartography. 

TMF673 GeographicAddress describe places using a hierarchical system originated from the postal services. It obviously has to cope with historic differences between countries. The GeographicAddress entity repressent the public domain part of the address and GeographicSubAddress is used for detailed addresses in the private domain. The GeographicAddress has a geographicLocation property to link it to a TMF672 entity. The GeographicSubAddress has two types indicated by the value of subAddressType

• subunit is used to describe a units e.g. appartment inside a building.
• privateStreet is used to describe building in a campus

This last type is there for your campus use case and has privateStreetName, privateStreetNumber and buildingName.

TMF675 and TMF673 both describe places with conventions that are outside the control of the CSP and provided by external sources. The CSP will however have to continuously update this information to cover changes in the outside world. This often involves a verification, enrichment and certification process to maintain data quality.

TMF674 GeographicSite is used to document places under control of the CSP: a tower site, a datacenter or a streetcabinet, ... They typically have a lifeCycle linked to processes at the CSP and has various features that can be documented: power supply, cooling, acces control, health & safety, rental, subsidies. GeographicSite are often linked to GeographicAddress, GeographicSubAddress and/or GeographicLocation.

Best practice is to use relationships only in one direction:

• GeographicLocation (coordinate based places) have no external relationships
• GeographicAddress and GeographicSubAddress can reference GeographicLocation
• GeographicSite can reference all of the above

Deviating from this best practise makes data maintenance more difficult. e.g. Postal services don't know about the CSP controlled sites.

I hope this information is useful.

HI Koen,
Thanks for the great explanation. 674 can also be used to model the actual service locations with the lifecycle of the service location based on active asset or only passive assets linked to that service location. for e.g., an ONT installation address is Site 1 (type Service location). Splitter is Site 2 (Type = Street cabinet as per the terminology you used). OLT is site 3 (Type = Network Device).
While these sites are different, there should be a relationship between the 3. Status of Site 1 is driven by the customer orders. Site 2 and Site 3 are passive. 
relating them helps not only during Assurance but also during Service Qualification. 

@David Milham @Jonathan Goldberg TMF API 674 can be used to manage all of the above sites.So would be good to have a type or a corresponding field to distinguish the type of site. 

Hi Jiri,

It is good to understand the purpose and layering of the different Geographic Entities  (places).

TMF675 GeographicLocation describes places using coordinates and geometric figures (point, line, polygon, multi-point, multi-line, multi-polygon). The coordinates are often GPS based but GIS systems use many other coordinates systems from cartography. 

TMF673 GeographicAddress describe places using a hierarchical system originated from the postal services. It obviously has to cope with historic differences between countries. The GeographicAddress entity repressent the public domain part of the address and GeographicSubAddress is used for detailed addresses in the private domain. The GeographicAddress has a geographicLocation property to link it to a TMF672 entity. The GeographicSubAddress has two types indicated by the value of subAddressType

• subunit is used to describe a units e.g. appartment inside a building.
• privateStreet is used to describe building in a campus

This last type is there for your campus use case and has privateStreetName, privateStreetNumber and buildingName.

TMF675 and TMF673 both describe places with conventions that are outside the control of the CSP and provided by external sources. The CSP will however have to continuously update this information to cover changes in the outside world. This often involves a verification, enrichment and certification process to maintain data quality.

TMF674 GeographicSite is used to document places under control of the CSP: a tower site, a datacenter or a streetcabinet, ... They typically have a lifeCycle linked to processes at the CSP and has various features that can be documented: power supply, cooling, acces control, health & safety, rental, subsidies. GeographicSite are often linked to GeographicAddress, GeographicSubAddress and/or GeographicLocation.

Best practice is to use relationships only in one direction:

• GeographicLocation (coordinate based places) have no external relationships
• GeographicAddress and GeographicSubAddress can reference GeographicLocation
• GeographicSite can reference all of the above

Deviating from this best practise makes data maintenance more difficult. e.g. Postal services don't know about the CSP controlled sites.

I hope this information is useful.