{"id":2268,"date":"2023-12-22T20:34:26","date_gmt":"2023-12-22T20:34:26","guid":{"rendered":"https:\/\/developers.maplink.global\/gestionar-sus-establecimientos\/"},"modified":"2024-09-23T14:39:43","modified_gmt":"2024-09-23T14:39:43","slug":"gestionar-sus-establecimientos","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/es\/gestionar-sus-establecimientos\/","title":{"rendered":"Gestionar sus establecimientos"},"content":{"rendered":"\n<p>La POIs API le permite <strong>alimentar y gestionar su propia base de datos de establecimientos<\/strong>, haciendo que las b\u00fasquedas sean personalizables seg\u00fan sus necesidades. Todos los datos creados estar\u00e1n vinculados al <em>client_ID<\/em> del usuario que realiz\u00f3 la adici\u00f3n\/edici\u00f3n y s\u00f3lo podr\u00e1n ser consultados por dicho usuario.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong><a href=\"#cadastro\" data-type=\"internal\" data-id=\"#cadastro\">C\u00f3mo registrar y editar un nuevo establecimiento<\/a><\/strong><\/li>\n\n\n\n<li><strong><a href=\"#consulta\">C\u00f3mo consultar un establecimiento registrado<\/a><\/strong><\/li>\n\n\n\n<li><strong><a href=\"#consulta-base\">C\u00f3mo consultar la base de datos de establecimientos<\/a><\/strong><\/li>\n\n\n\n<li><strong><a href=\"#categoria\" data-type=\"internal\" data-id=\"#categoria\">C\u00f3mo consultar las categor\u00edas y subcategor\u00edas disponibles<\/a><\/strong><\/li>\n\n\n\n<li><strong><a href=\"#cidade\">C\u00f3mo comprobar los estados, ciudades y barrios de los establecimientos registrados<\/a><\/strong><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"cadastro\"><strong>C\u00f3mo registrar y editar un nuevo establecimiento<\/strong><\/h2>\n\n\n\n<p>La adici\u00f3n y actualizaci\u00f3n de establecimientos se realiza a trav\u00e9s del siguiente endpoint <strong>(<\/strong>m\u00e9todo <strong>POST<\/strong>):<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/api.maplink.global\/place\/v1\/places\">https:\/\/api.maplink.global\/place\/v1\/places<\/a> &#8211; <strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-luminous-vivid-amber-color\">POST<\/mark><\/strong><\/li>\n<\/ul>\n\n\n\n<p>Los siguientes par\u00e1metros son necesarios para la inclusi\u00f3n o actualizaci\u00f3n:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>id<\/code> &#8211; String con el identificador \u00fanico del establecimiento. Si el ID ya est\u00e1 registrado, el punto de inter\u00e9s se actualizar\u00e1 con la informaci\u00f3n enviada;<\/li>\n\n\n\n<li><code>name<\/code> &#8211; String para introducir el nombre del establecimiento;<\/li>\n\n\n\n<li><code>category<\/code>  &#8211; Categor\u00eda a la que pertenece el establecimiento;<\/li>\n\n\n\n<li><code>subCategory<\/code>  &#8211; Subcategor\u00eda en la que se encuadra el establecimiento;<\/li>\n\n\n\n<li><code>active<\/code>  &#8211; Valor booleano para indicar si el registro est\u00e1 activo o no (los registros inactivos no ser\u00e1n<br>devueltos en las b\u00fasquedas);<\/li>\n\n\n\n<li><code>address<\/code>  &#8211; Objeto con datos de direcci\u00f3n:\n<ul class=\"wp-block-list\">\n<li><code>street<\/code> &#8211; String para introducir la direcci\u00f3n;<\/li>\n\n\n\n<li><code>number<\/code> &#8211; String para el n\u00famero de establecimiento;<\/li>\n\n\n\n<li><code>district<\/code> &#8211; (Opcional) String para el barrio;<\/li>\n\n\n\n<li><code>city<\/code> &#8211; String para la ciudad;<\/li>\n\n\n\n<li><code>state<\/code> &#8211; String para el estado;<\/li>\n\n\n\n<li><code>zipcode<\/code> &#8211; String para el c\u00f3digo postal;<\/li>\n\n\n\n<li><code>point<\/code>  &#8211; Array con las coordenadas del establecimiento:\n<ul class=\"wp-block-list\">\n<li><code>latitude<\/code>  &#8211; Coordenada de latitud en grados decimales;<\/li>\n\n\n\n<li><code>longitude<\/code>  &#8211; Coordenada de longitud en grados decimales;<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>tags<\/code> &#8211; (Opcional) Array de strings con \u00abtags\u00bb, o etiquetas, para identificar el tipo de establecimiento con categor\u00edas personalizadas;<\/li>\n\n\n\n<li><code>phones<\/code> &#8211; (Opcional) Array de strings para los n\u00fameros de tel\u00e9fono de contacto;<\/li>\n\n\n\n<li><code>additionalInfo<\/code>&nbsp;\u2013 (Opcional) Objeto con informaci\u00f3n adicional sobre el punto. Las propiedades deben estar en formato de string en el patr\u00f3n&nbsp;<code>\"key\":\"value\"<\/code>.<\/li>\n<\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><\/p>\n<cite><strong>Nota<\/strong>: Para ver las categor\u00edas y subcategor\u00edas disponibles para consulta y registro, simplemente realice una solicitud a los siguientes endpoints (m\u00e9todo <strong>GET<\/strong>) <a href=\"https:\/\/api.maplink.global\/place\/v1\/places\/category\">https:\/\/api.maplink.global\/place\/v1\/places\/category<\/a> y <a href=\"https:\/\/api.maplink.global\/place\/v1\/places\/subcategory\">https:\/\/api.maplink.global\/place\/v1\/places\/subcategory<\/a><\/cite><\/blockquote>\n\n\n\n<p><\/p>\n\n\n\n<p>Si necesita actualizar un registro existente, s\u00f3lo tiene que volver a enviar la solicitud indicando el identificador \u00fanico con todos los par\u00e1metros requeridos y los datos actualizados.  <\/p>\n\n\n\n<p>El body de la solicitud debe seguir la siguiente estructura:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n    \"id\": \"77\",\n    \"active\": true,\n    \"name\": \"Restaurante Dummy\",\n    \"category\": \"ALIMENTOS_E_BEBIDAS\",\n    \"subCategory\": \"RESTAURANTES\",\n    \"address\": {\n        \"street\": \"Pra\u00e7a Tiradentes\",\n        \"number\": \"23\",\n        \"city\": \"Rio de Janeiro\",\n        \"state\": \"RJ\",\n        \"zipcode\": \"20060-070\",\n        \"point\": {\n            \"latitude\": -22.90741716416432,\n            \"longitude\": -43.182738139927416\n        }\n    },\n    \"phones\": [\n        \"(21) 91234-5678\"\n    ],\n    \"clientId\": \"maplink\",\n    \"tags\": [\n        \"Restaurante\",\n        \"Alimento\"\n    ],\n    \"additionalInfo\": {\n        \"Se abre el fin de semana\": \"S\u00ed\"\n    }\n}<\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"consulta\"><strong>C\u00f3mo consultar un establecimiento registrado<\/strong><\/h2>\n\n\n\n<p>Para consultar todos los establecimientos registrados, basta con realizar una solicitud <strong>GET <\/strong>al siguiente endpoint, donde el t\u00e9rmino <strong>{{placeId}<\/strong> } debe sustituirse por el ID del establecimiento que desee:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/api.maplink.global\/place\/v1\/places\/%7B%7BplaceId%7D%7D\">https:\/\/api.maplink.global\/place\/v1\/places\/{{placeId}<\/a> } &#8211; <strong>\n  <mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-green-cyan-color\">GET<\/mark>\n<\/strong><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"consulta-base\"><strong>C\u00f3mo consultar la base de datos de establecimientos<\/strong><\/h2>\n\n\n\n<p>Para consultar todos los establecimientos registrados, basta con realizar una solicitud <strong>GET <\/strong>al siguiente endpoint:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/api.maplink.global\/place\/v1\/places\">https:\/\/api.maplink.global\/place\/v1\/places<\/a> &#8211; <mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-green-cyan-color\"><strong>GET<\/strong> <\/mark> <\/li>\n<\/ul>\n\n\n\n<p>Puede filtrar los resultados de la consulta mediante par\u00e1metros en la URL. Est\u00e1n disponibles los siguientes filtros:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>city<\/code>  &#8211; Filtrar resultados por ciudad;<\/li>\n\n\n\n<li><code>district<\/code>  &#8211; Filtre los resultados por barrio o distrito;<\/li>\n\n\n\n<li><code>state<\/code>  &#8211; Filtrar resultados por estado;<\/li>\n\n\n\n<li><code>tag<\/code>  &#8211; Filtrar resultados por etiqueta;<\/li>\n\n\n\n<li><code>center<\/code>  &#8211; Coordenadas de referencia para la b\u00fasqueda de resultados. Formato: <code>center=-23.552088765,-46.6341653162<\/code>;<\/li>\n\n\n\n<li><code>radius<\/code>  &#8211; Especifica el radio de b\u00fasqueda, en metros, desde el punto central establecido en <code>center<\/code>.<\/li>\n<\/ul>\n\n\n\n<p>Ejemplo de uso:<br><a href=\"https:\/\/api.maplink.global\/place\/v1\/places?city=Caieiras&amp;state=SP&amp;tags=abc123,restaurante&amp;center=-23.364792,-46.783109&amp;radius=149000&amp;district=Centro\">https:\/\/api.maplink.global\/place\/v1\/places?city=Caieiras&amp;state=SP&amp;tags=abc123,restaurante&amp;center=-23.364792,-46.783109&amp;radius=149000&amp;district=Centro<\/a><\/p>\n\n\n\n<p>Tambi\u00e9n puede <strong>hojear los resultados <\/strong>con los siguientes par\u00e1metros:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>offset<\/code>  &#8211; \u00cdndice del primer valor;<\/li>\n\n\n\n<li><code>limit<\/code>  &#8211; N\u00famero de resultados por p\u00e1gina, con un l\u00edmite de 100.<\/li>\n<\/ul>\n\n\n\n<p>En el ejemplo siguiente, tenemos 20 establecimientos registrados y queremos paginar los resultados, de forma que cada p\u00e1gina contenga 10 establecimientos. Para consultar la primera p\u00e1gina tendr\u00edamos:<br><a href=\"https:\/\/api.maplink.global\/place\/v1\/places?offset=0&amp;limit=10\">https:\/\/api.maplink.global\/place\/v1\/places?offset=0&amp;limit=10<\/a><\/p>\n\n\n\n<p>Para la segunda p\u00e1gina tendr\u00edamos <a href=\"https:\/\/api.maplink.global\/place\/v1\/places?offset=9&amp;limit=10\">https:\/\/api.maplink.global\/place\/v1\/places?offset=9&amp;limit=10<\/a> y as\u00ed sucesivamente.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"categoria\"><strong>C\u00f3mo consultar las categor\u00edas y subcategor\u00edas disponibles<\/strong><\/h2>\n\n\n\n<p>Para ver una lista de todas las categor\u00edas disponibles para el registro, basta con hacer una solicitud <strong>GET <\/strong>al siguiente <em>endpoint<\/em>:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/api.maplink.global\/place\/v1\/places\/category\">https:\/\/api.maplink.global\/place\/v1\/places\/category<\/a> &#8211; <mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-green-cyan-color\"><strong>GET<\/strong> <\/mark> <\/li>\n<\/ul>\n\n\n\n<p>Para consultar las subcategor\u00edas, utilice el siguiente endpoint, tambi\u00e9n con el m\u00e9todo <strong>GET<\/strong>:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/api.maplink.global\/place\/v1\/places\/subcategory\">https:\/\/api.maplink.global\/place\/v1\/places\/subcategory<\/a> &#8211; <strong>\n  <mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-green-cyan-color\">GET<\/mark>\n<\/strong><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"cidades\"><strong>C\u00f3mo comprobar los estados, ciudades y barrios de los establecimientos registrados<\/strong><\/h2>\n\n\n\n<p>Puede consultar los estados, ciudades o barrios donde hay establecimientos registrados en la base de datos.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Consultar los Estados<\/strong><\/h3>\n\n\n\n<p>Para consultar los <strong>estados <\/strong>en los que hay establecimientos registrados, basta con hacer una petici\u00f3n <strong>GET <\/strong>al siguiente <em>endpoint<\/em>:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/api.maplink.global\/place\/v1\/places\/states\">https:\/\/api.maplink.global\/place\/v1\/places\/states<\/a> &#8211; <mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-green-cyan-color\"><strong>GET<\/strong> <\/mark> <\/li>\n<\/ul>\n\n\n\n<p>El retorno vendr\u00e1 en formato <em>json<\/em>, con un <em>array <\/em>que contiene las siglas de los estados donde hay establecimientos registrados, como se muestra en el siguiente ejemplo:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">[\n    \"RJ\",\n    \"SP\"\n]<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Consultar ciudades<\/strong><\/h3>\n\n\n\n<p>Para consultar las <strong>ciudades <\/strong>en las que hay establecimientos registrados, basta con hacer una petici\u00f3n <strong>GET <\/strong>al <em>endpoint <\/em>que figura a continuaci\u00f3n, donde el t\u00e9rmino <code>{{state}}<\/code> debe sustituirse por el estado deseado<em>:<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/api.maplink.global\/place\/v1\/places\/state\/%7B%7Bstate%7D%7D\/cities\">https:\/\/api.maplink.global\/place\/v1\/places\/state\/{{state}<\/a> }\/ciudades &#8211; <mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-green-cyan-color\"><strong>GET<\/strong> <\/mark> <\/li>\n<\/ul>\n\n\n\n<p>El resultado vendr\u00e1 en formato <em>json<\/em>, con una <em>matriz <\/em>que contiene las ciudades del estado solicitado en las que hay establecimientos registrados, como se muestra en el siguiente ejemplo:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">[\n    \"S\u00e3o Paulo\",\n    \"Ribeir\u00e3o Preto\",\n    \"Campinas\" \n]<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Consultar a los vecinos<\/strong><\/h3>\n\n\n\n<p>Por \u00faltimo, para consultar los <strong>barrios <\/strong>donde hay establecimientos registrados, basta con hacer una petici\u00f3n <strong>GET <\/strong>al <em>endpoint <\/em>que figura a continuaci\u00f3n, donde el t\u00e9rmino <code>{{state}}<\/code> debe sustituirse por el estado deseado<em> <\/em>y el t\u00e9rmino <code>{{city}}<\/code> por la ciudad:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/api.maplink.global\/place\/v1\/places\/state\/%7B%7Bstate%7D%7D\/city\/%7B%7Bcity%7D%7D\/districts\">https:\/\/api.maplink.global\/place\/v1\/places\/state\/{{state}<\/a> }\/ciudad\/{ <a href=\"https:\/\/api.maplink.global\/place\/v1\/places\/state\/%7B%7Bstate%7D%7D\/city\/%7B%7Bcity%7D%7D\/districts\">{city}}\/distritos &#8211;<\/a> <mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-green-cyan-color\"><strong>GET<\/strong> <\/mark> <\/li>\n<\/ul>\n\n\n\n<p>El retorno vendr\u00e1 en formato <em>json<\/em>, con un <em>array <\/em>que contendr\u00e1 los barrios de la ciudad y estado solicitados en los que hay establecimientos registrados, como se muestra en el siguiente ejemplo:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">[\n    \"S\u00e9 Bela Vista\",\n    \"Bom Retiro\",\n    \"Cambuci\",\n    \"Aricanduva\", \n]<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>La POIs API le permite alimentar y gestionar su propia base de datos de establecimientos, haciendo que las b\u00fasquedas sean personalizables seg\u00fan sus necesidades. Todos los datos creados estar\u00e1n vinculados al client_ID del usuario que realiz\u00f3 la adici\u00f3n\/edici\u00f3n y s\u00f3lo podr\u00e1n ser consultados por dicho usuario. C\u00f3mo registrar y editar un nuevo establecimiento La adici\u00f3n [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[154],"tags":[],"class_list":["post-2268","post","type-post","status-publish","format-standard","hentry","category-pois-es"],"acf":[],"_links":{"self":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/2268","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/comments?post=2268"}],"version-history":[{"count":14,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/2268\/revisions"}],"predecessor-version":[{"id":3032,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/2268\/revisions\/3032"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/media?parent=2268"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/categories?post=2268"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/tags?post=2268"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}