Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

AdminLevel documentation #852

Open
jbelien opened this issue Jun 5, 2018 · 10 comments
Open

AdminLevel documentation #852

jbelien opened this issue Jun 5, 2018 · 10 comments
Assignees
Labels

Comments

@jbelien
Copy link
Member

@jbelien jbelien commented Jun 5, 2018

I may have missed it but I didn't find any documentation about AdminLevel.

If I understand correctly it goes from 1 to 5 ; but what's level 1 and what's level 5 ?
Is it a standard ? Where can I find documentation about this ?

Thanks a lot :)

@Nyholm
Copy link
Member

@Nyholm Nyholm commented Jun 5, 2018

That is an excellent question. I'm sorry but the answer is "it depends".

Even with the same provider, you can never be sure that level 3 is the same thing. For one lookup level 3 may be state for an other lookup it may be city.

But yes, it should be documented better.

@jbelien
Copy link
Member Author

@jbelien jbelien commented Jun 5, 2018

Shit, that's what I was afraid about :P
But good to know that I can do "whatever I want to" with it ! :D

I suppose 1 is the "bigger" (like country) and 5 is the smaller (like "neighborhood") or is it the other way around ?

@Nyholm
Copy link
Member

@Nyholm Nyholm commented Jun 5, 2018

I think it is the other way around.
1- neigbourhood
2-
3-
4-
5- County

And of course. Sometimes you may only have 1-3.

@jbelien
Copy link
Member Author

@jbelien jbelien commented Jun 5, 2018

Okay, I'll have a look to some other providers and do "something similar" with mine ! 👍

Thanks !

@Nyholm
Copy link
Member

@Nyholm Nyholm commented Jun 5, 2018

Great.
If you don't mind, could you add a row or two about this in the documentation?

@jbelien
Copy link
Member Author

@jbelien jbelien commented Jun 5, 2018

I do not mind !
I'll submit a PR in the next few days ! Do not hesitate to ping me if I forget 😂

@jbelien
Copy link
Member Author

@jbelien jbelien commented Jun 8, 2018

I found Google Maps API documentation about this : https://developers.google.com/maps/documentation/geocoding/intro#Types.

administrative_area_level_1
indicates a first-order civil entity below the country level. Within the United States, these administrative levels are states. Not all nations exhibit these administrative levels. In most cases, administrative_area_level_1 short names will closely match ISO 3166-2 subdivisions and other widely circulated lists; however this is not guaranteed as our geocoding results are based on a variety of signals and location data.

administrative_area_level_2
indicates a second-order civil entity below the country level. Within the United States, these administrative levels are counties. Not all nations exhibit these administrative levels.

administrative_area_level_3
indicates a third-order civil entity below the country level. This type indicates a minor civil division. Not all nations exhibit these administrative levels.

administrative_area_level_4
indicates a fourth-order civil entity below the country level. This type indicates a minor civil division. Not all nations exhibit these administrative levels.

administrative_area_level_5
indicates a fifth-order civil entity below the country level. This type indicates a minor civil division. Not all nations exhibit these administrative levels.

I guess we can base our documentation on this !

@Nyholm
Copy link
Member

@Nyholm Nyholm commented Jun 26, 2018

Sure. That seams reasonable.

This issue is related to #856

@jbelien jbelien self-assigned this Sep 14, 2018
@atymic
Copy link
Member

@atymic atymic commented Jul 1, 2019

ping @jbelien, seems you forgot 😜

Happy to have a go if you want instead.

@jbelien
Copy link
Member Author

@jbelien jbelien commented Jul 1, 2019

Haha, thanks for the reminder!
It indeed slipped of my mind.
I'll take care of it ASAP :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
3 participants
You can’t perform that action at this time.