Generated by API Evangelist
Written by API Evangelist tooling for Microsoft Azure's API. It is a proposal applied on top of the contract, not a document Microsoft Azure publishes.
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for Microsoft Azure Azure Maps Render Service Map API
version: 1.0.0
extends: openapi/microsoft-azure-map-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-09-26'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 3
- target: $.paths['/map/tile'].get
update:
x-apievangelist-phrasing:
intent: Fetch a map tile
effect: read
questions:
- How do I request a road map tile for a given zoom level and x/y coordinates?
- Can I get map tiles in a specific language or geopolitical view?
- Which tile sizes can I ask for when loading tiles into a map control?
instructions:
- text: Get tile {x},{y} at zoom {zoom} from tileset {tilesetId}.
slots:
x: query.x
y: query.y
zoom: query.zoom
tilesetId: query.tilesetId
- text: Fetch a {tileSize} pixel {tilesetId} tile at zoom {zoom}, x {x}, y {y} in language {language}.
slots:
tileSize: query.tileSize
tilesetId: query.tilesetId
zoom: query.zoom
x: query.x
y: query.y
language: query.language
method: generated
generated: '2026-09-26'
- target: $.paths['/map/tileset'].get
update:
x-apievangelist-phrasing:
intent: Get metadata for a map tileset
effect: read
questions:
- What zoom range and bounds does a map tileset support?
- Can I read a tileset's metadata before requesting tiles from it?
instructions:
- text: Get metadata for tileset {tilesetId}.
slots:
tilesetId: query.tilesetId
- text: Describe the map tileset {tilesetId}.
slots:
tilesetId: query.tilesetId
method: generated
generated: '2026-09-26'
- target: $.paths['/map/attribution'].get
update:
x-apievangelist-phrasing:
intent: Get copyright attribution for a map area
effect: read
questions:
- What copyright attribution do I need to show for a section of the map?
- Can I get attribution text for a bounding box at a given zoom?
instructions:
- text: Get map attribution for tileset {tilesetId} at zoom {zoom} within bounds {bounds}.
slots:
tilesetId: query.tilesetId
zoom: query.zoom
bounds: query.bounds
- text: Show copyright credits for {tilesetId} covering {bounds} at zoom level {zoom}.
slots:
tilesetId: query.tilesetId
bounds: query.bounds
zoom: query.zoom
method: generated
generated: '2026-09-26'
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.