Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
In this quickstart, you use a domain model to identify landmarks or, optionally, celebrities in a remotely stored image by using Computer Vision's REST API. With the Recognize Domain Specific Content method, you can apply a domain-specific model to recognize content within an image.
If you don't have an Azure subscription, create a Trial before you begin.
- You must have PHP installed.
- You must have Pear installed.
- You must have a subscription key for Computer Vision. You can follow the instructions in Create a Cognitive Services account to subscribe to Computer Vision and get your key.
To create and run the sample, do the following steps:
Install the PHP5
HTTP_Request2
package.Open a command prompt window as an administrator.
Run the following command:
pear install HTTP_Request2
After the package is successfully installed, close the command prompt window.
Copy the following code into a text editor.
Make the following changes in code where needed:
- Replace the value of
subscriptionKey
with your subscription key. - Replace the value of
uriBase
with the endpoint URL for the Recognize Domain Specific Content method from the Azure region where you obtained your subscription keys, if necessary. - Optionally, replace the value of
imageUrl
with the URL of a different image that you want to analyze. - Optionally, replace the value of the
domain
request parameter withcelebrites
if you want to use thecelebrities
domain model instead of thelandmarks
domain model.
- Replace the value of
Save the code as a file with a
.php
extension. For example,use-domain-model.php
.Open a browser window with PHP support.
Drag and drop the file into the browser window.
<html>
<head>
<title>Analyze Domain Model Sample</title>
</head>
<body>
<?php
// Replace <Subscription Key> with a valid subscription key.
$ocpApimSubscriptionKey = '<Subscription Key>';
$uriBase = 'https://api.cognitive.azure.cn/vision/v2.0/';
// Change 'landmarks' to 'celebrities' to use the Celebrities model.
$domain = 'landmarks';
$imageUrl =
'https://upload.wikimedia.org/wikipedia/commons/2/23/Space_Needle_2011-07-04.jpg';
require_once 'HTTP/Request2.php';
$request = new Http_Request2($uriBase . 'models/' . $domain . '/analyze');
$url = $request->getUrl();
$headers = array(
// Request headers
'Content-Type' => 'application/json',
'Ocp-Apim-Subscription-Key' => $ocpApimSubscriptionKey
);
$request->setHeader($headers);
$parameters = array(
// Request parameters
'model' => $domain
);
$url->setQueryVariables($parameters);
$request->setMethod(HTTP_Request2::METHOD_POST);
// Request body parameters
$body = json_encode(array('url' => $imageUrl));
// Request body
$request->setBody($body);
try
{
$response = $request->send();
echo "<pre>" .
json_encode(json_decode($response->getBody()), JSON_PRETTY_PRINT) . "</pre>";
}
catch (HttpException $ex)
{
echo "<pre>" . $ex . "</pre>";
}
?>
</body>
</html>
A successful response is returned in JSON. The sample website parses and displays a successful response in the browser window, similar to the following example:
{
"result": {
"landmarks": [
{
"name": "Space Needle",
"confidence": 0.9998177886009216
}
]
},
"requestId": "4d26587b-b2b9-408d-a70c-1f8121d84b0d",
"metadata": {
"height": 4132,
"width": 2096,
"format": "Jpeg"
}
}
When no longer needed, delete the file, and then uninstall the PHP5 HTTP_Request2
package. To uninstall the package, do the following steps:
Open a command prompt window as an administrator.
Run the following command:
pear uninstall HTTP_Request2
After the package is successfully uninstalled, close the command prompt window.
Explore the Computer Vision API used to analyze an image, detect celebrities and landmarks, create a thumbnail, and extract printed and handwritten text. To rapidly experiment with the Computer Vision API, try the Open API testing console.