Closed fionazhou-jsb closed 4 days ago
fionazhou-jsb
commented
1 month ago @mbertucci created this ticket as a result of the discussion around certificate. I added some context why we need to do this switch. It still aligns with our thinking. Please review, if it's good we can move it to refinement.
jdyck-fw
commented
1 month ago API key can be requested here; https://api.gov.bc.ca/devportal/api-directory/273
BC Address Geocoder - Province of British Columbia (gov.bc.ca)
BC Address Geocoder - Province of British Columbia The BC Address Geocoder is a REST web service API. It is used to find physical locations and provide their latitude and longitude coordinates.
ols-geocoder/geocoder-developer-guide.md at gh-pages · bcgov/ols-geocoder (github.com)
ols-geocoder/geocoder-developer-guide.md at gh-pages · bcgov/ols-geocoder Physical Address Geocoder. Contribute to bcgov/ols-geocoder development by creating an account on GitHub.
mbertucci
commented
1 month ago Information about BC Geocoder:
[11:26 a.m.] Bertucci, Mikaela CITZ:EX Hey Brian. I hope you're well.
I am the PO for the Short Term Rental Product being built by Registries for Housing. We want to switch our address look up from Canada Post to Geocoder. I'm wondering how often Geocoder is updated? And where does it get it's addreses from?
We are contemplating not allowing a user to override geocoder and just wondering if there are any risks to do this.
From Brian Kelsey
[11:38 a.m.] Kelsey, Brian CITZ:EX Hi Mikaela,
I short, we are currently upgrading the data integration process and have consequently been refreshing the data every two months. However, when the data integration automation work is complete we hope to update the data monthly. Within the BC Address Geocoder response you can see the current date of vintage next to ‘basedatadate’. Our current production environment is using data from May 2024. Our data administrator has processed the data from July 2024 and will be uploading it shortly. In terms of our data sources I have included a link below to a diagram. I can also email you a recent PowerPoint presentation that includes a few slides explaining the data sources. In general, we acquire coordinates for individual addresses from the Integrated Cadastral Information Society (AddressBC dataset). The ICI Society aggregates address data provided by address authorities such as municipalities and regional districts. In addition to this we also acquire address coordinates from BC Assessment. https://user-images.githubusercontent.com/34925250/217385786-a76d163c-6abb-4a88-9148-12028ec06b59.png Regarding switching from the Canada post address look up to the BC address geocoder the main difference would also be a change from a mailing address to a physical address. For STR locations, a physical address will provide you with the coordinate of where the unit is actually located based on the official locality boundaries, as opposed to a larger aggregated mailing area. I will find that PowerPoint and send you a copy with an indication of what slides would be of interest.
[11:40 a.m.] Kelsey, Brian CITZ:EX ok, I found a PDF version of the PPT and will send you an email highlighting slides specific to data sources and mailing vs. physical addresses.
mbertucci
commented
1 month ago Mikaela,
I have attached a copy of a previous presentation on the BC Address Geocoder which goes into more technical detail than the usual overview.
Relevant slides:
5 – Geocoding and standardizing 7 – Mailing address (Canada Post) vs. Physical address (BC Address Geocoder) 28 & 29 – Data sources 30 – Address coordinate sources - priority level 31 & 32 – Lists the municipalities from the AddressBC dataset we are allowed to use (Addendum signatures). Gaps are then filled using other sources including BC Assessment’s data. 48 – Shows where ‘basedatadate’ is found in the Geocoder response 74 – 76 – Illustrates how many First Nations reserves don’t have address coordinates. Consequently, the Geocoder must find locations through interpolation of address ranges in the road network (where available). The ICI Society is working on engagement to get more First Nations addresses (and promoting grant programs), although resourcing and capacity in First Nations offices can be limited.
Please let us know if you have any questions,
Brian Kelsey (he/him) | Technical Analyst, Location Services
Data Systems and Services | BC Data Service Division | Ministry of Citizens’ Services
e: brian.kelsey@gov.bc.ca
For support, please visit the Data Systems and Services request system
mbertucci
commented
1 month ago [Uploading... BC_Address_Geocoder_Overview.pdf]
mbertucci
commented
1 month ago If we need to change the design please let us know asap
mbertucci
commented
1 month ago If we need to change the design please let us know asap
mbertucci
commented
1 month ago please comment if we need to make and UI changes
kris-daxiom
commented
4 weeks ago @mbertucci @fionazhou-jsb After taking a look at the details returned by the geocoder, there is no postal code or city which may be ok because it refers to the physical location as opposed to a mailing location.Also there is a requirment @fionazhou-jsb mentioned the municpality details may be needed.
The main challenge is getting this address validated against the services card address which will be a mailing address. I am not sure of a way to compare these two addresses and determine whether its a pass or a fail.
Regarding the UX design, it depends on what you want to do. If the users has to enter the details like postal code, city etc. on their own, we can keep the current design.
kris-daxiom
commented
3 weeks ago @mbertucci Is there anythingelse I need to look into as part of this spike?
mbertucci
commented
3 weeks ago Hey @kris-daxiom
I don't think so. I need to put some thought into this. As before we were going to swap out Canada Post with Geocoder for the Rental Location.
The address on identification is the physical location of where the person lives. Not the mailing address which could be a PO Box.
The address on identification in British Columbia is the physical address and does have a postal code associated to it. The address is not the mailing address.
_"In British Columbia, the address displayed on a Driver's License or a BC Services Card is typically the physical address where the individual resides, not just their mailing address. This address is used to confirm the person's place of residence and is important for various legal and administrative purposes.
If you need the address on these identification cards to be different from your physical address (for example, if you want your mail to be sent to a different location), you would need to arrange for that separately, as the primary address on these IDs is meant to reflect where you physically live._
The postal code on identification cards such as a Driver's License or BC Services Card corresponds to the physical address where the individual resides. Even though it's labeled as a "postal" code, it still pertains to the specific geographic area of the physical address, helping to accurately pinpoint the location within the postal delivery system.
_The inclusion of a postal code serves several purposes:
Location Verification: It helps confirm the exact location of the address, which is crucial for things like voting districts, driving records, and other location-specific regulations or services.
Emergency Services: In case of emergencies, authorities can quickly identify your exact location based on your postal code.
Mail Delivery: While the address on the ID is your physical address, the postal code ensures that any correspondence or services linked to that address are correctly routed.
In summary, the postal code helps accurately identify the area of your physical address within the postal system, even though the ID itself reflects where you live, not just where you receive mail._"
mbertucci
commented
3 weeks ago update validation sheet if we change
mbertucci
commented
3 weeks ago Meeting set for August 23rd to discuss Geocoder
📖 User Story
As a host after I fill out the required text fields on "Contact Information" page click on the "Property Details" stepper or next I want to to be redirected to the "STRR Form" where I see the "Property Details" page and the "Property Details" Stepper is highlighted Then I can add rental address information about my rental unit such leveraging BC Geocoder So that it can show the city where jurisdiction is located in
Context
Currently the rental unit address field integrates with Canada Post Address Completion. The challenge of using this feature is it may not provide the accurate jurisdiction of the community/city. For example, North Vancouver can be district or city. BC Geocoder will provide a more accurate information about the city where the jurisdiction is located in.
🎨 UX/UI Link: https://www.figma.com/design/R9GF5wvwq2TrnbnsbhPfvV/STR-Host-Application-Tickets?node-id=2035-6023&t=joJselWcvJ0FJRmB-4
📏 Business Rules
🎭 Story Scenarios
Scenario: enter rental unit address
Roadmap and Story Map links
🌐 Accessibility Scenarios
### Keyboard Users Scenario: Comprehensive Keyboard Navigation Given I am a keyboard user on the website When I use the Tab key to navigate through the website Then all interactive elements should be accessible and highlighted And I should be able to activate these elements using the Enter or Space key Scenario: Full Content Accessibility via Keyboard Given I am a keyboard user navigating the website When I traverse through different pages and sections Then all content should be fully accessible using the keyboard alone And there should be no traps that prevent me from navigating away using the keyboard ### Screen Reader Users Scenario: Accessible Image Descriptions Given I am using a screen reader on the website When I encounter images Then each image should have descriptive alt text that conveys the same message as the image Scenario: Structured Navigation for Screen Readers Given I am navigating the website using a screen reader When I move through different page elements Then the content should be structured with proper headings And the reading order should be logical and sequential Scenario: Descriptive Form Fields Given I am filling out a form using a screen reader When I navigate through the form fields Then each field should be clearly labeled with descriptive text And instructions should be directly associated with their respective inputs ### Low Vision Users Scenario: Effective High Contrast Mode Given I am a user with low vision on the website When I enable high contrast mode Then all content should display with high color contrast suitable for low vision And the layout should remain coherent and unchanged Scenario: Text Resizing Accommodation Given I am a user with low vision on the website When I increase the text size Then the text should resize without loss of information or functionality And the page layout should adapt accordingly without disrupting the user experience Scenario: Personalized Styling Preferences Given I am a user with low vision adjusting settings on the website When I customize my styling preferences, including colors, fonts, and spacing Then these adjustments should be applied consistently across all pages And the changes should persist during my entire session or until altered by me🌍 Global Scenarios
## Data Validation # Mikaela to confirm: Do we need to do these for MVP - data validation required for inputing data in the right format - as defined by business rules. ### Internet Connection #### Standard Internet Connection Given I am accessing the website from a standard internet connection When I navigate to any page on the site Then the page should load completely within 2 seconds, ensuring a fast and efficient user experience. #### Low-Speed Internet Given a user accesses "Application Details View" with a low-speed internet connection defined as under [specific speed] Mbps When the user attempts to load and interact with the dashboard page Then the "Application Details View" should prioritize critical content and functionality, loading essential elements first to ensure usability. #### Mobile Responsiveness Given I am accessing "Application Details View" on a mobile device When I click on the "any" link Then "_____ " should display correctly and be easily editable on my device, ensuring a responsive design.