{"id":2784,"date":"2023-12-22T18:25:35","date_gmt":"2023-12-22T18:25:35","guid":{"rendered":"https:\/\/developers.maplink.global\/multi-geocode-api\/"},"modified":"2025-08-01T13:57:27","modified_gmt":"2025-08-01T13:57:27","slug":"multi-geocode-api","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/en\/multi-geocode-api\/","title":{"rendered":"Multi Geocode API"},"content":{"rendered":"\n<p>The purpose of this last endpoint is to <strong>return geographical coordinates from multiple addresses, either complete or partial<\/strong>. <\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"#parametros\">List of parameters<\/a><\/li>\n\n\n\n<li><a href=\"#exemplo1\">Example 1 &#8211; Searching for coordinates of two or more addresses in the same request<\/a><\/li>\n\n\n\n<li><a href=\"#response\">Response<\/a><\/li>\n<\/ul>\n\n\n\n<p>To make the request to Multi Geocode you need to send the request using the <strong>POST <\/strong>method to the following endpoint:  <\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/api.maplink.global\/geocode\/v2\/multi-geocode\">https:\/\/api.maplink.global\/geocode\/v2\/multi-geocode<\/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<h2 class=\"wp-block-heading\" id=\"parametros\"><strong>List of parameters<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Mandatory parameters<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>id<\/code>  &#8211; Text with the identifier of the searched address.<\/li>\n<\/ul>\n\n\n\n<p>It is compulsory to enter at least one of the parameters below. It is not necessary to inform everyone. However, the more information you provide, the more accurate the result will be.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>road<\/code>  &#8211; Name of the street or part of it;<\/li>\n\n\n\n<li><code>number<\/code>  &#8211; Street number. DO NOT enter the complement data.<\/li>\n\n\n\n<li><code>city<\/code>  &#8211; Name of city;<\/li>\n\n\n\n<li><code>state<\/code>  &#8211; State;<\/li>\n\n\n\n<li><code>country<\/code>  &#8211; Country;<\/li>\n\n\n\n<li><code>district<\/code>  &#8211; Name of the neighborhood;<\/li>\n\n\n\n<li><code>zipcode<\/code> &#8211; Zip code;<\/li>\n\n\n\n<li><code>label<\/code>&nbsp;\u2013 Complete address. It is recommended to type the text in the order&nbsp;<strong>\u201cStreet name, number, zip code, district, city, state\u201d<\/strong>.<\/li>\n<\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Note: <\/strong>Currently returning only to directions located in Brazil.<\/p>\n<\/blockquote>\n\n\n\n<p><\/p>\n\n\n\n<p><\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><\/p>\n<cite><strong>Note<\/strong>: There is a limit of 200 points for submission in a single request.<\/cite><\/blockquote>\n\n\n\n<p><\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Optional parameters<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>mainLocation<\/code>&nbsp;\u2013 Object with two parameters to limit the address search area:\n<ul class=\"wp-block-list\">\n<li><code>center<\/code>&nbsp;\u2013 Object with the reference coordinates for the search results. The coordinates can be entered in the following formats:\n<ul class=\"wp-block-list\">\n<li>Object with the&nbsp;<code>lat<\/code>&nbsp;and&nbsp;<code>lon<\/code>&nbsp;properties that represent latitude and longitude respectively. Example:&nbsp;<code>{\"lat\":-23.0852,&nbsp;\"lon\": -46.98020}<\/code><\/li>\n\n\n\n<li>Array with latitude and longitude. Example:&nbsp;<code>[-23.0852,&nbsp; -46.98020]<\/code><\/li>\n\n\n\n<li>Coordinates encoded as geohash. Example:<strong>&nbsp;<\/strong><code>\"6tr6df675\"<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>radius<\/code>&nbsp;\u2013 Search radius, in meters, from the central point defined in&nbsp;center. If not entered, the default value is 500,000 meters (500 km).<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"exemplo1\"><strong>Example 1 &#8211; Searching for coordinates of two or more addresses in the same request<\/strong><\/h2>\n\n\n\n<p>In this example, we&#8217;re going to look for two different addresses in the same request. To do this, we need to identify each address with the parameter <code>id<\/code>.  <\/p>\n\n\n\n<p>The first will be <code>\"Address1\"<\/code> and the second <code>\"Address2\"<\/code>. The full request can be seen below:<\/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    {\n        \"id\": \"Address1\",\n        \"road\": \"Leopoldo Hess\",\n        \"number\": 75,\n        \"district\": \"S\u00e3o Jo\u00e3o\",\n        \"zipcode\": \"88304-260\",\n        \"city\": \"Itajai\",\n        \"state\": \"SC\"\n    },\n    {\n        \"id\": \"Address2\",\n        \"road\": \"Alameda Campinas\",\n        \"number\": 579,\n        \"zipcode\": \"01419-001\",\n        \"city\": \"S\u00e3o Paulo\",\n        \"state\": \"SP\"\n    }\n]<\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"response\">Response<\/h2>\n\n\n\n<p>The description of each field present in the response can be found in the following link:&nbsp;<a href=\"https:\/\/developers.maplink.global\/en\/response-structure-geocode-api\/\">Response structure \u2013 Geocode API<\/a>.<\/p>\n\n\n\n<p>The full response can be found below:<\/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    \"results\": [\n        {\n            \"id\": \"Address1\",\n            \"address\": {\n                \"road\": \"RUA LEOPOLDO HESS\",\n                \"number\": \"75\",\n                \"district\": \"S\u00c3O JO\u00c3O\",\n                \"zipCode\": \"88304260\",\n                \"city\": \"ITAJA\u00cd\",\n                \"state\": {\n                    \"name\": \"SANTA CATARINA\",\n                    \"code\": \"SC\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -26.903004,\n                    \"lon\": -48.680296\n                },\n                \"numberAsInteger\": 75\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"RUA LEOPOLDO HESS, 88304260, S\u00c3O JO\u00c3O, ITAJA\u00cd, SC\",\n            \"score\": 96.79654045442564,\n            \"precision\": \"NUMBER_EXACT\"\n        },\n        {\n            \"id\": \"Address2\",\n            \"address\": {\n                \"road\": \"ALAMEDA CAMPINAS\",\n                \"district\": \"JARDIM PAULISTA\",\n                \"zipCode\": \"01404001\",\n                \"city\": \"S\u00c3O PAULO\",\n                \"state\": {\n                    \"name\": \"S\u00c3O PAULO\",\n                    \"code\": \"SP\"\n                },\n                \"mainLocation\": {\n                    \"lat\": -23.56880844109,\n                    \"lon\": -46.65604091167\n                }\n            },\n            \"type\": \"ROAD\",\n            \"label\": \"ALAMEDA CAMPINAS, 01404001, JARDIM PAULISTA, S\u00c3O PAULO, SP\",\n            \"score\": 96.91391938959099,\n            \"precision\": \"ROAD_CENTROID\"\n        }\n    ],\n    \"found\": 2\n}<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>The purpose of this last endpoint is to return geographical coordinates from multiple addresses, either complete or partial. To make the request to Multi Geocode you need to send the request using the POST method to the following endpoint: List of parameters Mandatory parameters It is compulsory to enter at least one of the parameters [&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":[168],"tags":[],"class_list":["post-2784","post","type-post","status-publish","format-standard","hentry","category-geocode-en"],"acf":[],"_links":{"self":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts\/2784","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/comments?post=2784"}],"version-history":[{"count":10,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts\/2784\/revisions"}],"predecessor-version":[{"id":3481,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/posts\/2784\/revisions\/3481"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/media?parent=2784"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/categories?post=2784"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/en\/wp-json\/wp\/v2\/tags?post=2784"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}