Documentation AFA.codes - Revision history

Admin: Migração e tradução automática da Wikifull (Título original: Documentação AFA.codes).

2025-09-14T17:51:54Z

Migração e tradução automática da Wikifull (Título original: Documentação AFA.codes).

Admin: Migração e tradução automática da Wikifull (Título original: Documentação AFA.codes).

2025-09-14T17:43:56Z

Migração e tradução automática da Wikifull (Título original: Documentação AFA.codes).

New page

{{idiomas}}
[[File:OSMcodes-logo-new.png|320px|thumb|Logo ''AFA.codes'' (formerly ''OSM.codes''), a service implementing the DNGS standard.]]

'''AFA Codes''' (formerly OSMcodes) is a [[Projects|project]] by the [[Instituto AddressForAll]] aimed at implementing and enhancing the geocoding system of the [[Discrete National Grid Systems/pt|Discrete National Grid Systems - '''DNGS''']] standard. AFA Codes strive for maximum quality: highly compact, user-friendly, multi-purpose, and computationally efficient.

Main features:
* '''Homepage - locality selection''' at [http://afa.codes http://afa.codes]
* '''Interface''' (example in BR-SP-Campinas) at [http://afa.codes/BR-SP-Campinas http://afa.codes/BR-SP-Campinas]
* '''Repositories''' at https://git.afa.codes   (see also [https://api.github.com/orgs/osm-codes/repos API list], [https://github.com/osm-codes/gridMap-draftPages/issues Issues] and [https://github.com/osm-codes/gridMap-draftPages/releases Version])
* '''Separation''' of topics: DNGS standard (public) ''vs'' AFA implementation of the standard (potentially private).
* '''Endpoints''' for Cameroon documented and with Swagger, http://dev.api.banoc.coeurduweb.com/docs/
__TOC__

==Sections==

Main documentation sections in this wiki:

*{{ns-xref|afac|Software structure and license}}: for contracts and description
*{{ns-xref|afac|API}}: Official AFA Codes API Guide.
*{{ns-xref|afac|Methodology}}: explains to laypeople what we do
*{{ns-xref|afac|About}}: describes the project, its products, and services.
*{{ns-xref|afac|Conventions}}: establishes conventions and methodologies of this project.
*{{ns-xref|afac|Use cases}}: describes and classifies the various applications and ways to use the solution.
*{{ns-xref|afac|FAQ}}: Frequently Asked Questions.
*{{ns-xref|afac|Gits}}: git repositories containing source codes.
*{{ns-xref|afac|Tests}}: testing script and execution for the <code>AFA.codes</code> query pages.
*{{ns-xref|afac|Viz}}: data visualization module and command interface.
**[[afac:Viz/Navegação|afac:Viz/'''Navigation''']]: reference manual on map and geocode navigation interface.
*{{ns-xref|afac|Guides}}: quick, usage, and installation guides.
*{{ns-xref|afac|Attributions}}: credits, licenses, and other attribution information.
*{{ns-xref|afac|Versions}}: versions of the software used in production.
*Countries with <code>AFA.codes</code> implemented, regardless of the domain:
**{{ns-xref|afac|DE}} - Germany
**{{ns-xref|afac|BR}} - Brazil;
**{{ns-xref|afac|CO}} - Colombia.
**{{ns-xref|afac|CM}} - Cameroon.
**{{ns-xref|afac|SV}} - El Salvador.
**{{ns-xref|afac|EC}} - Ecuador.
**{{ns-xref|afac|IN}} - India.
**{{ns-xref|afac|UY}} - Uruguay.
** ... - Pending creation of automation for the methodology, https://gis.stackexchange.com/a/489059/7505

*Other functions implemented in the domain:
**See [[afac:About#Other site functions]].

== Key Points ==

* AFA Codes is a geocoding system where each rectangle of the national territory, from 1 km² to 1 m², receives the shortest possible alphanumeric code, generated from geographic coordinates.
* It can geolocate by code any fixed element in the territory, such as cities, neighborhoods, villages, farms, plots, houses, vehicle spaces, trees, poles, urban furniture, etc.
* The system respects the sovereignty of each country. It is tailor-made, considering the territorial structure of states and municipalities.
* Once adopted in a country, 100% of its territory is covered with geocodes generated by the system.
* The system is reversible: the geographic coordinate is converted to a short code, and this code can also be reverted to the geographic coordinate that originated it.
* The code can be used as a registration number, as the same code does not repeat within the same municipality.
* Locations lacking addresses and postal codes, such as sites, settlements, and dwellings in rural areas, subnormal agglomerations, forests, and wilderness, receive a geocode that can both locate and identify the object. Even the most remote and inaccessible place is geocodable.
* AFA Codes is developed by the AddressForAll Geo-Social Technologies Institute as an innovative open technology solution. It does not bind institutions and users to the technology developer.

== Origin of the Name ==
The acronym AFA comes from the initials of the name of the '''A'''ddress'''F'''or'''A'''ll Institute, and a dot is adopted between this acronym and the word "codes" as a communication strategy to make both the name and the website address known.

It replaces the old name OSMcodes to avoid conflict with OpenStreetMap. Initially, the previous name came from the fact that the project was based on the [[OpenStreetMap]] map and intended to promote it.

==See also==

*[[Generalized Geohash]]

[[Category:Projects|OSMcodes]]
[[Category:OSMcodes|*Documentation_OSMcodes]]
[[Category:Public]]
[[Category:Public01]]

← Older revision		Revision as of 14:51, 14 September 2025
Line 1:		Line 1:
	{{~~idiomas~~}}		{{Idiomas}}
	~~[[File:OSMcodes-logo-new.png\|320px\|thumb\|Logo ''AFA.codes'' (formerly ''OSM.codes''), a service implementing the DNGS standard.]]~~

	'''AFA Codes''' (formerly OSMcodes) is a [[Projects\|project]] by the [[Instituto AddressForAll]] aimed at implementing and ~~enhancing~~ the geocoding system of the [[Discrete National Grid Systems/pt\|Discrete National Grid Systems - '''DNGS''']] standard. AFA Codes strive for maximum quality: highly compact, user-friendly, multi-purpose, and computationally efficient.		[[File:OSMcodes-logo-new.png\|320px\|thumb\|Logo ''AFA.codes'' (formerly ''OSM.codes''), service implementing the DNGS standard.]]

			'''AFA Codes''' (formerly OSMcodes) is a [[Projects\|project]] of the [[Instituto AddressForAll]] aimed at implementing and improving the geocoding system of the [[Discrete National Grid Systems/pt\|Discrete National Grid Systems - '''DNGS''']] standard. AFA Codes strive for maximum quality: highly compact, user-friendly, multi-purpose, and computationally efficient.

	Main features:		Main features:
	* '''Homepage - ~~locality~~ selection''' at [http://afa.codes http://afa.codes]		* '''Homepage - location selection''' at [http://afa.codes http://afa.codes]
	* '''Interface''' (example in BR-SP-Campinas) at [http://afa.codes/BR-SP-Campinas http://afa.codes/BR-SP-Campinas]		* '''Interface''' (example in BR-SP-Campinas) at [http://afa.codes/BR-SP-Campinas http://afa.codes/BR-SP-Campinas]
	* '''Repositories''' at https://git.afa.codes   (see also [https://api.github.com/orgs/osm-codes/repos API list], [https://github.com/osm-codes/gridMap-draftPages/issues Issues] and [https://github.com/osm-codes/gridMap-draftPages/releases Version])		* '''Repositories''' at https://git.afa.codes   (see also [https://api.github.com/orgs/osm-codes/repos API list], [https://github.com/osm-codes/gridMap-draftPages/issues Issues] and [https://github.com/osm-codes/gridMap-draftPages/releases Version])
	* '''Separation''' of topics: DNGS standard (public) ''vs'' AFA implementation of the standard (potentially private).		* '''Separation''' of topics: DNGS standard (public) ''vs'' AFA implementation of the standard (potentially private).
	* '''Endpoints''' for Cameroon documented ~~and~~ with Swagger, http://dev.api.banoc.coeurduweb.com/docs/		* '''Endpoints''' for Cameroon documented with Swagger, http://dev.api.banoc.coeurduweb.com/docs/
	__TOC__		__TOC__

Line 17:		Line 18:

	*{{ns-xref\|afac\|Software structure and license}}: for contracts and description		*{{ns-xref\|afac\|Software structure and license}}: for contracts and description
	*{{ns-xref\|afac\|API}}: Official AFA Codes API ~~Guide~~.		*{{ns-xref\|afac\|API}}: Official guide to the AFA Codes API.
	*{{ns-xref\|afac\|Methodology}}: explains to laypeople what we do		*{{ns-xref\|afac\|Methodology}}: explains to laypeople what we do
	*{{ns-xref\|afac\|About}}: describes the project, its products, and services.		*{{ns-xref\|afac\|About}}: describes the project, its products, and services.
	*{{ns-xref\|afac\|Conventions}}: establishes conventions and methodologies of this project.		*{{ns-xref\|afac\|Conventions}}: establishes conventions and methodologies for this project.
	*{{ns-xref\|afac\|Use cases}}: describes and classifies ~~the~~ various applications and ways to use the solution.		*{{ns-xref\|afac\|Use cases}}: describes and classifies various applications and ways to use the solution.
	*{{ns-xref\|afac\|FAQ}}: Frequently Asked Questions.		*{{ns-xref\|afac\|FAQ}}: Frequently Asked Questions.
	*{{ns-xref\|afac\|Gits}}: git repositories containing source ~~codes~~.		*{{ns-xref\|afac\|Gits}}: git repositories containing source code.
	*{{ns-xref\|afac\|Tests}}: ~~testing~~ script and execution for ~~the~~ <code>AFA.codes</code> query pages.		*{{ns-xref\|afac\|Tests}}: test script and execution for <code>AFA.codes</code> query pages.
	*{{ns-xref\|afac\|Viz}}: data visualization module and command interface.		*{{ns-xref\|afac\|Viz}}: data visualization module and command interface.
	**[[afac:Viz/Navegação\|afac:Viz/'''Navigation''']]: reference manual on map and geocode navigation interface.		**[[afac:Viz/Navegação\|afac:Viz/'''Navigation''']]: reference manual on the map and geocode navigation interface.
	*{{ns-xref\|afac\|Guides}}: quick, usage, and installation guides.		*{{ns-xref\|afac\|Guides}}: quick, usage, and installation guides.
	*{{ns-xref\|afac\|Attributions}}: credits, licenses, and other attribution information.		*{{ns-xref\|afac\|Attributions}}: credits, licenses, and other attribution information.
Line 50:		Line 51:
	* The system respects the sovereignty of each country. It is tailor-made, considering the territorial structure of states and municipalities.		* The system respects the sovereignty of each country. It is tailor-made, considering the territorial structure of states and municipalities.
	* Once adopted in a country, 100% of its territory is covered with geocodes generated by the system.		* Once adopted in a country, 100% of its territory is covered with geocodes generated by the system.
	* The system is reversible: the geographic coordinate is converted to a short code, and this code can also be ~~reverted~~ to the geographic coordinate that originated it.		* The system is reversible: the geographic coordinate is converted to a short code, and this code can also be reversed to the geographic coordinate that originated it.
	* The code can be used as a registration number, as the same code does not repeat ~~within~~ the same municipality.		* The code can be used as a registration number, as the same code does not repeat in the same municipality.
	* Locations lacking addresses and postal codes, such as sites, settlements, and dwellings in rural areas, ~~subnormal agglomerations~~, forests, and ~~wilderness~~, receive a geocode that can both locate and identify the object. Even the most remote and inaccessible place is geocodable.		* Locations lacking addresses and postal codes, such as sites, settlements, and dwellings in rural areas, informal settlements, forests, and hinterlands, receive a geocode that can both locate and identify the object. Even the most remote and inaccessible place is geocodable.
	* AFA Codes is developed by the AddressForAll Geo-Social Technologies ~~Institute~~ as an innovative open technology solution. It does not bind institutions and users to the technology developer.		* AFA Codes is developed by the AddressForAll Institute of Geo-Social Technologies as an innovative open technology solution. It does not bind institutions and users to the technology developer.

	== Origin of the Name ==		== Origin of the Name ==
	The acronym AFA comes from the initials of the name of the '''A'''ddress'''F'''or'''A'''ll Institute, and a dot is ~~adopted~~ between this acronym and the word "codes" as a communication strategy to make both the name and the website address known.		The acronym AFA comes from the initials of the name of the '''A'''ddress'''F'''or'''A'''ll Institute, and a dot is used between this acronym and the word "codes" as a communication strategy to make both the name and the website address known.

	It replaces the old name OSMcodes to avoid conflict with OpenStreetMap. Initially, the previous name came from the fact that the project was based on the [[OpenStreetMap]] map and intended to promote it.		It replaces the old name OSMcodes to avoid conflict with OpenStreetMap. Initially, the previous name came from the fact that the project was based on the [[OpenStreetMap]] map and intended to promote it.