Documentation AFA.codes: Difference between revisions

Line 1:

~~[[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:

* '''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]

* '''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/

* '''Endpoints''' for Cameroon documented with Swagger, http://dev.api.banoc.coeurduweb.com/docs/

__TOC__

Line 17:

Line 18:

*{{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|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|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.

**[[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|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.

* 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 ==

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.

@@ 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:
-* '''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]
 * '''Repositories''' at https://git.afa.codes &nbsp; (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/
+* '''Endpoints''' for Cameroon documented with Swagger, http://dev.api.banoc.coeurduweb.com/docs/
 __TOC__
@@ Line 17: / Line 18: @@
 *{{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|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|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.
-**[[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|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.
 * 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 ==
-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.