Integrate map-agent telemetry support

[areibman]

📥 Pull Request

📘 Description
Adds comprehensive integration support for map-agent, enabling automatic telemetry and observability via AgentOps. This includes:

• An MapAgentInstrumentor to hook into map-agent's telemetry.py module.
• Instrumentation for core map-agent classes and methods (e.g., MapAgent, RouteCalculator) to capture navigation, location, and telemetry attributes as OpenTelemetry spans.
• Configuration for automatic activation when map-agent is detected.
• A dedicated README for the integration and an example demonstrating usage with mock map-agent components.

🧪 Testing

• Unit tests (tests/unit/instrumentation/agentic/map_agent/test_map_agent_instrumentor.py) were implemented to validate the instrumentor's core functionality, including telemetry function wrapping, class method instrumentation, attribute extraction, and error handling.
• An example script (examples/map_agent/map_agent_example.py) was created to demonstrate the integration's intended behavior and the structure of captured telemetry using mock map-agent components.
• As the map-agent package was not publicly available, testing was conducted against these mock implementations to ensure the integration framework is robust and ready for a real map-agent dependency.

---

[cursor]

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}