Document Power BI Embedded limitation with embed token V2 API

[ayeshurun]

Power BI Embedded has a limitation in "Embed for customers" scenarios when using embed tokens generated by the Generate Embed Token V2 API—the Azure Maps visual is supported only with this token type.

Changes

• Added dedicated "Power BI Embedded Limitation" section in Considerations and Limitations
• Positioned after availability table as a subsection similar to other subsections like "Where is Azure Maps Visual for Power BI available?"
• Simplified text states: Azure Maps visual is supported in 'Embed for customers' scenario only with Embed Token generated using the Generate Embed Token V2 API
• Uses clean section heading format instead of NOTE callout for consistency

The documentation now surfaces this constraint before implementation rather than during troubleshooting

[prmerger-automator]

@ayeshurun : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

[learn-build-service-prod]

Learn Build status updates of commit 0445455:

💡 Validation status: suggestions

File	Status	Preview URL	Details
articles/azure-maps/power-bi-visual-get-started.md	💡Suggestion		Details

articles/azure-maps/power-bi-visual-get-started.md

• Line 194, Column 108: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/rest/api/power-bi/embed-token/generate-token' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

[Copilot]

Pull request overview

This PR documents a Power BI Embedded limitation where the Azure Maps visual only works with the "Embed for customers" scenario when using embed tokens generated by the V2 API.

Changes:

• Added a new "Power BI Embedded Limitation" section explaining the embed token V2 requirement for Azure Maps visual in Power BI Embedded scenarios

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[v-dirichards]

Hi @ayeshurun - This pull request was opened in the public repo. PMs should work in the private repo, per the Microsoft Docs contributor guide. We can keep this PR open for review and merge, but would you make future content updates in the private repo? Thank you!

---

@deniseatmicrosoft

Can you review the proposed changes?

Important: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

[ayeshurun]

Hi @ayeshurun - This pull request was opened in the public repo. PMs should work in the private repo, per the Microsoft Docs contributor guide. We can keep this PR open for review and merge, but would you make future content updates in the private repo? Thank you!

@deniseatmicrosoft

Can you review the proposed changes?

Important: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged" @MicrosoftDocs/public-repo-pr-review-team

@v-dirichards Of course, thanks for bringing this to my attention. I will follow up this process going forward.

[learn-build-service-prod]

Learn Build status updates of commit 1825e26:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
articles/azure-maps/power-bi-visual-get-started.md	⚠️Warning		Details

articles/azure-maps/power-bi-visual-get-started.md

• Line 194, Column 136: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/rest/api/power-bi/embed-token/reports-generate-token-for-create-in-group' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
• Line 194, Column 136: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/rest/api/power-bi/embed-token/reports-generate-token-for-create-in-group' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

[v-dirichards]

refreshing the build

[learn-build-service-prod]

Learn Build status updates of commit 53949fa:

💡 Validation status: suggestions

File	Status	Preview URL	Details
articles/azure-maps/power-bi-visual-get-started.md	💡Suggestion		Details

articles/azure-maps/power-bi-visual-get-started.md

• Line 194, Column 136: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/rest/api/power-bi/embed-token/reports-generate-token-for-create-in-group' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.