Skip to main content

2022 Q2: Maps 2.0: New search page revamp to surface non-Station places and enhance discovery

Nhut Huynh Steve

Today

Today, users can discover nationwide Petronas stations, search for a specific station by name or address, and filter these stations by a set of facilities options.

New Feature

In 1.95 app version, users can now discover non-Station places on the app. These are places which offer Setel Pay as a payment method, which means users can use Setel’s QR pay to pay for services or products purchased from these places.

Overflow: https://overflow.io/s/2P7IKULA?node=ea3bd7ec&connectors=off

Phase one overflow (down-scoped): https://overflow.io/s/2P7IKULA?node=d255c7c0

New map and list view

For the first release, list view will not be included.

Discover non-station places

Search and filter on the map

View place details

Users can click on each Place card to view the details of the place. For non-Station Places, the card will NOT be clickable.

This is applicable only for Stations for the first phase release. Future versions will enhance to enable this for other place types.

Status on Place cards

For our first release, status for non-Station places will be hidden. Status for Stations will be as described in App: Status for Place card.

CTA to direct users to the selected flow

Users can perform actions specific to the place type on this screen. For example, if the selected place type is EV chargers and users are detected to be within the geofence radius, the START CHARGING button will be activated (instead of GO TO EV CHARGER) and users can enter the EV charging flow.

The button copy and the actions can all be configured on Admin Portal.

How to configure place type and places on Admin portal

Related Page: Admin: Settings for Place Type

Here are the process for creating places and place types.

TLDR:

  • Product manager will create place types and make any necessary changes

  • Admin and Ops will create places and make any necessary changes

Place Type

Here is a guide for more information on configuring place types on Admin portal. Once again, note that this is the responsibility of the product manager but feel free to refer through as well.

If you want to hide a place type on the app, simply off the Show place type toggle. This will hide the place type and all the places under the category on the app even after you have already created the place type. You can turn it back on to display it again.

If you want enable users to carry out certain actions from the map search screen, for example, starting a charging flow, you need to fill in the In geofence field under Cta button copy. Then, fill in the deeplink field with the deeplink URL of the destination page. (see App: Deeplink Library)

In geofence means users are detected to locate within our defined geofence radius around the selected place. This works the same as Stations today. When users' location is within 200m of a Station, the PURCHASE FUEL button will be enabled and they can start a fuel purchase session. The same logic applies for non-Station places.

If you want to change the copy of the CTA button, simply write these in the In geofence and Not in geofence fields.

For example, if you input the following on Admin Portal,

for place type = EV charger cards, the following will be displayed.

Let’s take another example. Consider the scenario where we want to show workshop places, but even when users are located within the geofence, there is no action for them to perform. (Perhaps in the future we will offer in-workshop appointment, but for we are just showing workshop for discovery) In this case, you need to only fill in the Not in geofence field.

And the following will be displayed.

Places

You can prepare the list of places to be bulk-created via this template https://docs.google.com/spreadsheets/d/1UGwx0G7wOZuByTozNjYYrC9zieL0v68vY7x_cJb8SjI/edit?usp=sharing.

Note: Place types that are linked with other services such as:

  • Fuel

  • EV

  • Food

  • Send Parcel

These place types are linked with other services and would require a place ID for the places to be linked with other services.

However, in such cases where certain places under the following place types (shown above) are to be added without a place ID, acknowledging that those places are not linked with other services, can be added with a simple toggle on merchant sync info = on/off. Before creating a place, we will need to identify if the places to be added are linked with any services.

Steps

Notes

Screenshot
1

Create a new place

At Admin Portal, navigate to Maps, then click on Places > Create

 
2

Fill in the fields

Sync merchant info refers to places that are not supported by any stations or services. You will need to identify if the chosen place to be added is linked to a service/station.

Place ID field is only available for the Place Type below, more explanation in lower section:

  • Fuel

  • Food

  • EV Chargers

The following fields will be auto-validated upon typing to make sure the value is existed:

  • Place ID (when sync merchant info is ON)

  • Merchant ID (when sync merchant info is OFF)

For Geofence radius, it should be set at 200 unless it is affecting user experience such as user is at the location but the phone GPS is detected outside of geofence.

Services field is built for future enhancement, for now please use Example in order to proceed.

Click Save after completed

 

Once done, click save and the place will be successfully created and added onto the list of existing places. Do be mindful and double check with the status of each specific place created whether they are active,inactive,maintainence

 Status

Description
1

Inactive

  • Does not show in the map
2

Active

  • Show on the map
3

Maintenance

  • Show on the map but with a maintenance state

 

For the Place Types that need to sync with other services, Place ID field will be available. Before setting up the Places for these Place Types, please make sure the record is created in respective services. You may refer table below on how to setup in the respective services and retrieve the Place ID:

Type

Setup

EV Chargers

Please refer to 2022 Q3: EV charging station and session management on charging station setup. Use Station ID as the Place ID.

Food

Food locations are synced with Store services.

Placed ID = Store ID

For the places not linked with other services, this part explains regarding places that are not linked with other services or supported by any PETRONAS stations. They can still be added under place types (Fuel, EV, Food) that are linked with other services by allowing place ID to be optional.

With a simple toggle of sync merchant info > ON > places under that place type will be automatically linked, provided that there is a place ID to be filled in to link the merchant info.

For example, to add 100 merchants under Food place type that are not linked with Deliver2Me or SetelPay that are to be displayed under the Food tab in the Setel App, this is possible by adding those places under food place type by toggling sync merchant info > OFF.

You can proceed to add the follow 100 merchants under food without a place ID.

Rules to Consider:

  • Sync Merchant Info only applies to linked services such as EV, Send Parcel and Food.

  • Once admin user has toggled sync merchant info = ON admin user will not be able to toggle it OFF for the second attempt.

Bulk Upload - Places

If you have a long list of places to create, doing it one-by-one is a tedious process. This function allows you to bulk create places just by uploading a CSV file. Setel Admin: Bulk create places

Upload a CSV file with the following columns

User can upload a CSV file containing the following columns for each place in the list.

Rules to be aware of:

  • The columns strictly need to be in the order as below, with (1) being the most left column.

  • Sync Merchant Info is identified by Place ID field

    • If sync merchant info = off > not linked with any services, Place ID field can be ignored

    • If sync merchant info = on > linked with services, Place ID field will be required

Template for CSV:

https://docs.google.com/spreadsheets/d/1UGwx0G7wOZuByTozNjYYrC9zieL0v68vY7x_cJb8SjI/edit#gid=0

Columns

Rules

place_id

If sync merchant info is ON, admin will need to fill in a place_id to identify linked services for bulk upload.

merchant_id

OPTIONAL

If sync merchant info is OFF, admin can fill in the merchant_id

name

display_name

type

address_line_1

address_line_2

latitude

longitude

geofence_latitude

geofence_longitude

place_id

OPTIONAL

*If marked as OPTIONAL, can be left blank.

See: Places for the description of each field.

Preview on the map

After uploading the file, there should be a map section where all the places are plotted on based on their latitude and longitude field.

This is for user to verify the correctness of each location.

Upon submitting

After users submit, the system shall process and create all the places in the csv file. Users shall be redirected back to Setel Admin: View Places listing.

Release plan

All the features listed here (https://overflow.io/s/2P7IKULA?node=ea3bd7ec&connectors=off ) will not be in the scope of the first release, which is scheduled for 1.96. The remaining features will be gradually released in future versions. To keep track of the scope changes, do refer here https://setelnow.atlassian.net/wiki/pages/resumedraft.action?draftId=1915229894.

A variable will be used to control the release of the new view.

Schedule for release will be as such:

Condition for release:

Upon readiness for EV charging flow as its progressive rollout will be coupled with our map, since map is the only entry point to the flow for now.

Upon app release on Play and App store,

Date

Percentage %

Status
1

(internal users only)

DONE

2

5

3

15

4

30

5

50

6

100

Release by place type

Place type

Notes

1

Fuel (station)

  • 1.96

2

EV charge

  • 1.96

3

Food & Beverages

  • Only for deliver2Me restaurants only

  • 1.98

  • need enhancements for deeplink

4

Parcels

  • eta 1.98

5

Workshop

  • Future

  • without deeplink

  • with deeplink will be in the future, when we have the use case built for workshop (such as service appointment booking)

6

Car care

  • Future
7

Gas

  • Future

Release checklist

Statuses

IN PROGRESS

DONE

Item

Notes

Expected deadline

PIC

Status (empty means to-do)

1

Prepare CSV list of workshop and restaurants to be added

Ops

DONE
2

Deploy changes to make merchant_id optional

VE-1488 - Getting issue details... STATUS

VE-1489 - Getting issue details... STATUS

Steven Cao Nguyen Truong Giang Thanh

DONE
3

Request tech-ops to configure permission for Admin portal Maps pages

ACCESS-4263 - Getting issue details... STATUS

Tiong Woon Ong (Unlicensed)

DONE
4

Set up monitoring for api-places

Steven Cao Nguyen Truong Giang Thanh

DONE
5

Verify load test successful

To ensure infrastructure is able to handle the expected load.

VE-1509 - Getting issue details... STATUS

Steven Cao Nguyen Truong Giang Thanh

DONE
6

Create workshop and restaurants place type and places using the bulk-create endpoint

Tiong to sample test CSV and then pass it to engineers.

  1. Create on staging

  2. Verify correctness on staging app

  3. Create on production

Steven Cao Nguyen Truong Giang Thanh

IN PROGRESS
7

Create collection point place type and places

Tiong Woon Ong (Unlicensed)

DONE
8

Create EV charger place type and places

Tiong Woon Ong (Unlicensed)

DONE
9

When EV charging flow is ready, turn on flag based on schedule above. (see above for flag)

Chan Kun Eng to notify.

Assumption is to have internal testing first before kickstarting public rollout.

Tiong Woon Ong (Unlicensed)

DONE

10

Create guide for places creation and handover to OPS team

  1. Work with ira.erina to create the user guide docs.

  2. Handover the task to OPS to perform insertion for places creation

ira.erina Akemalhaqeem Ariffin (Unlicensed)

IN PROGRESS

Reference

Knowledge sharing session - https://drive.google.com/file/d/1gUWg2aqQN03565fyyhpqJck35Jn_S5IB/view?usp=sharing Connect to preview

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk