Updated documentation

specification/maps/data-plane/Common/preview/1.0/common.json

@@ -599,7 +599,7 @@
     "ClientId": {
       "name": "x-ms-client-id",
       "x-ms-client-name": "clientId",
-      "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model.  It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management  plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.",
+      "description": "Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be obtained from the [Azure Maps management plane Account API](/rest/api/maps-management/accounts). For more information on using Microsoft Entra ID security in Azure Maps, see [Manage authentication in Azure Maps](/azure/azure-maps/how-to-manage-authentication).",
       "type": "string",
       "in": "header",
       "x-ms-parameter-location": "client"

specification/maps/data-plane/Geolocation/preview/1.0/geolocation.json

@@ -64,8 +64,8 @@
   "paths": {
     "/geolocation/ip/{format}": {
       "get": {
-        "summary": "Use to get the ISO country code for a given IP address",
-        "description": "\n\nThe `Get IP To Location` API is an HTTP `GET` request that, given an IP address, returns the ISO country code from which that IP address is located. Developers can use this information to block or alter certain content based on geographical locations where the application is being viewed from.",
+        "summary": "Use to get the ISO country code for a given IP address.",
+        "description": "\n\nThe `Get IP To Location` API is an HTTP `GET` request that returns the ISO country code for a given IP address. Developers can use this information to block or modify content based on the geographical location from which the application is accessed.",
         "operationId": "Geolocation_GetIPToLocation",
         "x-ms-client-name": "GetLocation",
         "x-ms-examples": {
@@ -94,7 +94,7 @@
         ],
         "responses": {
           "200": {
-            "description": "OK",
+            "description": "The request succeeded. The resource has been fetched and included in the message body.",
             "schema": {
               "$ref": "#/definitions/IpAddressToLocationResult"
             }
@@ -128,7 +128,7 @@
       "readOnly": true,
       "properties": {
         "isoCode": {
-          "description": "The IP Address's 2-character code [(ISO 3166-1)](https://www.iso.org/iso-3166-country-codes.html) of the country or region. Please note, IP address in ranges reserved for special purpose will return Null for country/region.",
+          "description": "The IP address's 2-character country or region code ([ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html)). Note that IP addresses in ranges reserved for special purposes will return Null for country/region.",
           "type": "string",
           "readOnly": true
         }