{"id":2282,"date":"2023-12-22T20:40:27","date_gmt":"2023-12-22T20:40:27","guid":{"rendered":"https:\/\/developers.maplink.global\/ejemplo-1-endpoint-independiente-2\/"},"modified":"2024-02-22T21:12:49","modified_gmt":"2024-02-22T21:12:49","slug":"ejemplo-1-endpoint-independiente-2","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/es\/ejemplo-1-endpoint-independiente-2\/","title":{"rendered":"Ejemplo 1 – Endpoint independiente"},"content":{"rendered":"\n

En este ejemplo, queremos consultar los restaurantes y gimnasios de la Avenida Afonso Pena, en la ciudad de Campo Grande – MS. Para ello, definimos el par\u00e1metro categories<\/code> con las categor\u00edas \"ALIMENTOS_E_BEBIDAS\"<\/code> y \"ACADEMIAS\"<\/code>.<\/p>\n\n

En bufferRouteInMeters<\/code> definimos el radio de b\u00fasqueda a lo largo de la ruta y en bufferStoppingPointsInMeters<\/code> definimos el radio de b\u00fasqueda en los puntos de parada. En nuestro caso, los puntos de parada ser\u00e1n los puntos de origen y destino de cada tramo de la ruta. Ambos se definir\u00e1n como 500 metros.<\/p>\n\n

El par\u00e1metro onlyMyPlaces<\/code> indica si s\u00f3lo queremos consultar los establecimientos de nuestra base de datos propietaria o si tambi\u00e9n queremos consultar la base de datos nativa del servicio. Como en este ejemplo todos los establecimientos han sido dados de alta previamente, utilizaremos el valor true<\/code>.<\/p>\n\n

El par\u00e1metro legs<\/code> es una array de objetos donde cada objeto representa una secci\u00f3n de la ruta. En cada tramo, <\/em>debemos definir el par\u00e1metro points<\/code>, que contiene las coordenadas que componen la ruta. En este caso, s\u00f3lo tenemos un leg<\/code> <\/em>que corresponde a toda la ruta.<\/p>\n\n

La solicitud completa puede verse a continuaci\u00f3n:<\/p>\n\n

{\n    \"categories\": [\n        \"ALIMENTOS_E_BEBIDAS\",\n        \"ACADEMIAS\"\n    ],\n    \"bufferRouteInMeters\": 500,\n    \"bufferStoppingPointsInMeters\": 500,\n    \"onlyMyPlaces\": true,\n    \"legs\": [\n        {\n            \"points\": [\n                {\n                    \"latitude\": -20.46317952376137,\n                    \"longitude\": -54.612278411463116\n                },\n                {\n                    \"latitude\": -20.463744,\n                    \"longitude\": -54.615746\n                },\n                {\n                    \"latitude\": -20.464,\n                    \"longitude\": -54.615697\n                },\n                {\n                    \"latitude\": -20.462782,\n                    \"longitude\": -54.608564\n                }\n            ]\n        }\n    ]\n}<\/pre>\n\n
En la respuesta se devolver\u00e1 la siguiente informaci\u00f3n:<\/p>\n\n
    \n
  • total<\/code>  – N\u00famero entero que contiene el n\u00famero de establecimientos encontrados en la b\u00fasqueda;<\/li>\n\n\n\n
  • places<\/code> – Array de objetos, donde cada objeto representa un establecimiento. Se devolver\u00e1 la siguiente informaci\u00f3n:\n
      \n
    • id<\/code>  – Identificador \u00fanico del establecimiento;<\/li>\n\n\n\n
    • name<\/code>  – Nombre del establecimiento;<\/li>\n\n\n\n
    • category<\/code>  – Categor\u00eda a la que pertenece el establecimiento;<\/li>\n\n\n\n
    • subcategory<\/code>  – Subcategor\u00eda a la que pertenece el establecimiento;<\/li>\n\n\n\n
    • address<\/code>  – Objeto con datos de direcci\u00f3n:\n
        \n
      • street<\/code> – String para introducir la direcci\u00f3n;<\/li>\n\n\n\n
      • number<\/code> – String para el n\u00famero de establecimiento;<\/li>\n\n\n\n
      • district<\/code> – (Opcional) String para el barrio;<\/li>\n\n\n\n
      • city<\/code> – String para la ciudad;<\/li>\n\n\n\n
      • state<\/code> – String para el estado;<\/li>\n\n\n\n
      • zipcode<\/code> – String para el c\u00f3digo postal;<\/li>\n\n\n\n
      • point<\/code>  – Array con las coordenadas del establecimiento:\n
          \n
        • latitude<\/code>  – Coordenada de latitud en grados decimales;<\/li>\n\n\n\n
        • longitude<\/code>  – Coordenada de longitud en grados decimales;<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n
        • active<\/code>  – Valor booleano que indica si el establecimiento est\u00e1 activo o no;<\/li>\n\n\n\n
        • tags<\/code>  – Etiquetas del establecimiento, en su caso;<\/li>\n\n\n\n
        • phones<\/code>  – N\u00fameros de tel\u00e9fono de contacto del establecimiento, si est\u00e1n disponibles.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n
          A continuaci\u00f3n encontrar\u00e1 la respuesta completa:<\/p>\n\n
          {\n    \"total\": 2,\n    \"legs\": [\n        {\n            \"total\": 2,\n            \"places\": [\n                {\n                    \"id\": \"624c3ea5eab1c41162ba996c\",\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                    \"active\": true\n                },\n                {\n                    \"id\": \"62431d8583ce9c2ac592db3b\",\n                    \"name\": \"Academia Y\",\n                    \"category\": \"ACADEMIAS\",\n                    \"subCategory\": \"ACADEMIAS\",\n                    \"address\": {\n                        \"street\": \"Avenida Brasil\",\n                        \"number\": \"326\",\n                        \"city\": \"Campo Grande\",\n                        \"state\": \"MS\",\n                        \"zipcode\": \"89848650\",\n                        \"point\": {\n                            \"latitude\": -20.463744,\n                            \"longitude\": -54.615746\n                        }\n                    },\n                    \"active\": true\n                }\n            ]\n        }\n    ]\n}<\/pre>\n","protected":false},"excerpt":{"rendered":"
          En este ejemplo, queremos consultar los restaurantes y gimnasios de la Avenida Afonso Pena, en la ciudad de Campo Grande – MS. Para ello, definimos el par\u00e1metro categories con las categor\u00edas \u00abALIMENTOS_E_BEBIDAS\u00bb y \u00abACADEMIAS\u00bb. En bufferRouteInMeters definimos el radio de b\u00fasqueda a lo largo de la ruta y en bufferStoppingPointsInMeters definimos el radio de b\u00fasqueda […]<\/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-2282","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\/2282","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=2282"}],"version-history":[{"count":3,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/2282\/revisions"}],"predecessor-version":[{"id":2285,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/2282\/revisions\/2285"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/media?parent=2282"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/categories?post=2282"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/tags?post=2282"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}