Virtual Operator for Location Retrieval

The Virtual Operator provides predefined and deterministic API responses within the Network Registry Playground when using phone numbers associated with the unassigned country code +990. It can be used as a simulated operator for discovery, development and testing of Network Features in scenarios where access to a live operator is unavailable.

To use the Virtual Operator, simply select 'Playground' in your application configuration. All API calls directed to phone numbers with the +990 prefix will automatically be redirected to the Virtual Operator.

All API calls made using the Virtual Operator require to implement the same authentication flows as those made through a regular mobile operator.

The Virtual Operator is available by default to any application configured for Network Features in a Playground mode. No further configuration is necessary to use the Virtual Operator.

It is not necessary to add +990 numbers to your allowlist. Simply make an API call to any of the supported Network Features.

The responses are determined by the trailing digits of the phone number provided; all other fields can be set to any value. In all responses, the lastLocationTime field will show the current time:

Phone Number Response
Last two digits are "11", e.g. "+9902345611" Receive a circle response.
"latitude": "50.707815"
"longitude": "7.128740"
"radius": 200
Last two digits are "22", e.g. "+9902345622" Receive a circle response.
"latitude": "50.722112"
"longitude": "7.113625"
"radius": 200
Last two digits are "33", e.g. "+9902345633" Receive a circle response.
"latitude": "50.737057"
"longitude": "7.101254"
"radius": 200
Last two digits are "44", e.g. "+9902345644" Receive a circle response.
"latitude": "50.724535"
"longitude": "7.093150"
"radius": 200
Last two digits are "55", e.g. "+9902345655" Receive a circle response.
"latitude": "50.701605"
"longitude": "7.103051"
"radius": 200
Last two digits are "66", e.g. "+9902345666" Receive a polygon response.
{"latitude": 50.732896, "longitude": 7.102896},
{"latitude": 50.731849, "longitude": 7.104989 },
{"latitude": 50.732545, "longitude": 7.105906},
{"latitude": 50.733659, "longitude": 7.103809}
Last two digits are "77", e.g. "+9902345677" Receive a circle response.
"latitude": "28.425600"
"longitude": "-81.468880"
"radius": 200
Last two digits are "88", e.g. "+9902345688" Receive a circle response.
"latitude": "39.013607"
"longitude": "-94.537209"
"radius": 200
Last two digits are "99", e.g. "+9902345699" Operator Error:
"status": 400
"code": "INVALID_INPUT"
"message": "Virtual Operator predefined error for numbers ending with 99."