Difference between revisions of "Template:NeedInfo/doc"

From Wazeopedia
(Add template to return to editing manual)
(Area Place size: Simplify to clarify)
Line 41: Line 41:
 
=== Area Place size ===
 
=== Area Place size ===
  
Some locations that qualify for an Area Place may involve one or more structures as well as open space, roads, and parking. In such cases, particularly if these components form a unified complex or campus with an overall identity, the boundaries of the Area Place should encompass the entire property (i.e., "mapped to the fence line"). This ensures that clients render and label the Area Place with the correct significance when viewed with reduced zoom.
+
Some area places,much as the Pentagon building in Arlington, Virginia, have a single recognizable structure useful as a visual reference for Wazers. These can be drawn to approximate  the structure's footprint or outline,
  
Other qualifying Area Places whose property lines are substantially identical with a single destination structure may be drawn, if desired, to approximate the structure's outline or footprint.
+
Other area places, like University campuses and  large shopping malls include more than one component, such as one or more buildings, open areas, roads, and parking.  In this case, it is often most useful to Wazers to map "to the fence line").  This will show the area and its label in the mobile app even when zoomed out.  
 
+
The Gas Station and Parking Lot categories of Area Place suppress automated detection of Map Problems and should always be mapped at least to the extent of the drivable area (see [[Places/Parking lot]] and [[Places/Gas Station]] for more detail on these Area Places).
+
Gas Stations and Parking Lots should be mapped to the fence line (or at least to alldrivable area)and gas station or parking lot should be the first category in the category list. This suppresses  automated detection of Map Problems.  See [[Places/Parking lot]] and [[Places/Gas Station]] for more detail on these Area Places.
  
 
=== Area Places overlap ===
 
=== Area Places overlap ===

Revision as of 01:34, 30 December 2014

Template:ReturnToEditingManual

This new page is currently undergoing modifications. The information and guidance is currently considered accurate enough to be followed now. Content is being prepared by one or more users. Do not make any changes before you post a message in this forum.

Places is the Waze Point of Interest (POI) system. Places supports two types of POIs: Point and Area.

Point Places create app-searchable POIs with limited rendering on the user's client display. The Point Place may be used for many destinations subject to the table of Place categories and types, but becomes especially useful in situations where the other POI search engines accessed by Waze do not list a desired destination.

Area Places serve all the functions of Point Places while providing additional visual orientation cues on the user's client display. Because of their increased visibility and the resulting potential for map clutter, Area Places are easily overused. In principle, if a location is not distinctive and significant enough to orient drivers, it should not be marked with an Area Place. This principle guided the determination of Point vs. Area in the table of Place categories and types. Exceptions include gas stations, which receive special handling.

Some of the guidance for NeedInfo/doc may have specific localized adjustments for your local area. Be sure to familiarize yourself with these differences through the Local vs global guidance page.


Point Place

The Point type of Place is rendered with the following icons:
Wme place.png Standard Point marker
Wme place selected.png Selected Point marker
Wme place changed.png Changed Point marker
Wme place pending update.png Point Place with pending update

Point Location Details

  • The Point marker for a Place should be located on or nearest to the segment to which the driver should be navigated. The Point Marker is the stop point.


Area Place

The Area type of Place is rendered as a polygon. Just like a segment, you can adjust the shape by using the geometry handles. All Area Places in the editor show in pink when not selected and blue-green when selected:

Wme gas station area.pngWme gas station area selected.png

Area Location Details

  • The Area type has a target which is the navigation stop point.
  • The target stop point can be moved anywhere within the shape and also a short distance outside the actual Area shape
  • The stop point target should be placed on or nearest to the segment to which the driver should be navigated.

Area Place size

Some area places,much as the Pentagon building in Arlington, Virginia, have a single recognizable structure useful as a visual reference for Wazers. These can be drawn to approximate the structure's footprint or outline,

Other area places, like University campuses and large shopping malls include more than one component, such as one or more buildings, open areas, roads, and parking. In this case, it is often most useful to Wazers to map "to the fence line"). This will show the area and its label in the mobile app even when zoomed out.

Gas Stations and Parking Lots should be mapped to the fence line (or at least to alldrivable area)and gas station or parking lot should be the first category in the category list. This suppresses automated detection of Map Problems. See Places/Parking lot and Places/Gas Station for more detail on these Area Places.

Area Places overlap

In some cases an extensive Area Place may contain within it locations that would themselves qualify as Area Places; for example, different medical buildings within a hospital campus or separate malls within a large shopping complex. As of this writing, however, the Waze client renders only the names of subset Area Places and does not show visible boundaries for them. Users therefore cannot visually distinguish Area Places subset within other Area Places.  The subset Area-Place text labels appear, but they "float" amidst an undifferentiated colored background.

Future versions of the Waze client may render overlapping Area Places more usefully. In anticipation of this, qualifying Area Places may be drawn subset within others.  It may be a better approach for the time being to use Point Places for the components of a larger Area Place, unless it is essential that the subset Place names be visible in the current version of the Waze client. If overlapping Area Places do render more usefully in the future, qualifying Point Places may be converted to Area Places at that time.


Client rendering of Places

Most area Places will render in the Waze app and Live map as a shaded area. Extremely small area Places will not appear at all, even at maximum zoom.

Point Places are not rendered in the Live map, or Client Devices, but are searchable within the app. By default, a Waze Place search result should supersede others, even in the autofill list.


Setting the stop point for a Place

Point placement

Point Place marker placed at the front door of a business.
The Point Place is to be placed on or nearest to the segment to which the driver should be navigated. The Waze routing server will navigate the Wazer onto the segment which is physically closest to where the point is placed. The Point Marker is the stop point. Typically, if the Place is inside a building, the marker should be located at or near the location's front door. Think: where would a car stop to drop someone off for this location.

Moving a Point Place

To move a point Place, first click on the Place icon, which will turn into Wme venue selected.png. Now you can click and drag the Place to the correct location.

Point placement examples

Some Examples

  • A building with one Point Place:
    • If there is only one door, place it at that door.
    • If there are multiple doors on the same façade, (like a supermarket,) place it at the point equidistant from and collinear with the two front doors.
    • If there are multiple doors on different façades, (like some mall anchor stores,) if there's no "obvious" front door, place it either at the door facing the largest parking lot, or at the door facing the street on which the street address for that location is.
  • A single building with multiple Point Places within:
    • At a strip mall, the "front door" language can still be followed.
    • At a larger mall, put the markers as close as possible to the actual location of the store. This way the user can get an idea where to go, and the routing server can pick the parking lot road actually nearest to that store.
      The caveat is you should use this rule only as long as that doesn't put the point closest to a segment from which the site cannot be accessed. For example if the store is in the back of building, and that would put the point closer to a road segment running behind the building which is not part of the parking lot, then use the front door rule. Otherwise people will be routed to the road behind the building with no way to access the store.
    • Office buildings are a bit tougher, for the caveat just mentioned above. For such an office downtown, people should be led to the front door of the building, since that's the point through which all these offices are actually accessed, and where the car would stop.

Area placement

The Wme place stop point.png icon is the adjustable stop point for Area Places.

Here is an example of an Area (a large park in this case) which has an entry road on the east side. The second image is zoomed in on the target to show how this type of Area should have its navigation stop point set.
Wme park place large.png
Wme park place zoom target.png

Area stop point distance limit

When you drag an area Place stop point, the stop point is limited to within the black border. You will not be allowed to move the stop point outside of the boundary.
Stop point place target border.png

If you move an Area and the stop point then falls outside of the boundary, you will get an error on save. Move the stop point and then save.

Moving an Area Place

An area Place can be moved without altering its shape by selecting the Place first by clicking on it. Then, click and drag the move handle icon Wme place drag handle.png.

Place details

Every Place, whether Point or Area, should have as much detail completed as possible. This includes a name, proper categorization, and full street address, city and state. If any Place does not have a City or Street, check the None checkbox.

General tab

The General tab for a Place is where you complete all of the basic information: categories, name, description, gas brand, residential/public, hours of operation, country, state, city, street and house number.

Places considered fundamental to the functioning of the Waze app, such as Gas Stations, should be locked at least to Level 2 to prevent loss of data due to automatic acceptance of submissions from Trusted Users. Other complex, intricate, or crucial Places such as Police Stations, Fire Departments, Airports, Parks, et cetera should also be considered for locking to prevent loss of data.

BEWARE: Do not use the Description field for notes to other editors. This field is visible in the Waze app, and should only contain details pertinent to the Place itself.

Here is an example of a Gas Station Area with its details completed:
Place Details

More Info tab

In the More Info tab is additional helpful information for the Place. Here you will add phone number, website, and additional services:
Place More Info

Services

Services help users decide if they should drive to a particular place. Here are descriptions of available services. Waze uses the same set of services for every place type. The service checkbox only has two states, 'yes' or 'no answered', thus there is no way to determine if a place either does not have a service or an editor hasn't added one yet.

Valet service The place has valet parking whereby drivers can valet their car, leaving it with an attendant who will park it for them. These services could be free or fee-based.

Drive-through The place has a drive-through window, which serves food or other items via window that allows the driver not to leave their vehicle. Restaurants, banks, and pharmacies often have drive-through windows.

Wi-Fi The place has free Wi-Fi available for customers. Wi-Fi can be completely open, or accessible with a password that the place operator supplies the user.

Restrooms The place has public restrooms where customers can use a toilet.

Accepts credit cards The place accepts any type of credit card for payment of goods or services. At this time Waze does not differentiate between credit card types.

Reservations The place accepts reservations, i.e. a reserved time for dining in the place.

Outdoor seating The place allows diners to eat outside, weather permitting. Outdoor seating may be on the curb, sidewalk, or in a fenced in area on the premises.

Air conditioning The place has air conditioning, to cool and dehydrate the air when the ambient temperature considered to be warm or hot. This may be possible to infer by looking for air conditioning condensers or chillers on roofs or near buildings on aerial photography within the Waze Map Editor.

Parking for customers The place has parking for customers where they can leave their car, which could be free or for a fee, where the customer parks their own car and walks to the place.

Deliveries At this time this service is unclear. It could mean that the place either accepts deliveries, e.g. from UPS or FedEx, or makes deliveries of food or products to the customer, within a certain range.

Photos tab

Any photos which drivers have added to a Place will appear in the Photos tab. In WME, we can only review and delete photos. Photos can only be uploaded from the Waze app. Click on a picture to view a larger version.
Place Photos


Deleting a Place photo

Take great care to make a well thought-out decision to delete a photo. Once a photo is deleted, it cannot be recovered. Delete only if the photo really is unclear, not helpful and/or inappropriate.

Wme place photo hover.png

Any improper or inappropriate photos should be removed. Hover the mouse over a picture in the Place Photos tab, and click the X which appears at the top right of the photo.


Place Updates (Moderation)

Wme placemarker new.pngWme placemarker new photo.pngWme placemarker updated details.png The Places updates layer will display Places with update request(s) pending. When an untrusted driver submits a new Place or an update to an existing Place, these go into a type of moderation status. The Place Update Request (PUR) marker shown to the left display to let you know, similar to an Update Request, the location of a pending Place update.


Area with update marker
  • The Place update request markers will only appear if you have the "Place updates" layer enabled.
  • Point Places with pending updates will display with the Wme place pending update.png icon even when the "Place updates" layer is disabled.
  • With the Place updates layer enabled, an Area Place will display with an update request marker at its center.


New Place
When you click on the Place update request marker, you will be presented with a panel which details the updates the Wazer has submitted. The exact content of the panel will differ depending on the type and amount of information input by the end user using the Waze app.


  • When you click on any Place which has a pending update, the following message will appear in the left tabs area of the editor screen. Clicking on it will display the update details just the same as clicking on the Place update marker.


Wme places update pending notice.png


Very long full Place update

Accept or reject?

The job of the Waze editor is to accept or reject Place updates sent by users from the Waze app. The general guideline to use to determine whether to Accept the update is,


"Is the majority of information provided in the update correct?"


A Place update, if the user completes ALL the information, can be extremely long (expand thumbnail to the right).

Even if some of the data is incorrect, or the photo included in the update improper and unhelpful to drivers, the editor can still remove the photo or update/delete the incorrect information after accepting the update. It is better, faster, and more honest to accept the good information from the driver, and fix the problems, rather than rejecting the entire update and filling in the info yourself.

Determining Acceptable Photos

Defining exactly what is an acceptable photo is difficult because the huge variation in destinations. In general terms, the pictures of Places should be such that a driver could use the picture to help determine exactly which destination is the correct one. The system will try to show the arriving user the most relevant photo from their direction of arrival, time of day, etc.

Take great care to make a well thought-out decision to delete a photo. Once a photo is deleted, it cannot be recovered. Delete only if the photo really is unclear, not helpful and/or inappropriate.

The following are meant as guidelines both for the editor and for users taking pictures. Photos should:

  • Show the exterior of the Place
  • Be clear (not blurry, through rain-covered/dirty windows, not from moving vehicles/trains, etc)
  • Be well lit
  • Help differentiate the Place location from nearby Places

Photos could include images of, but not necessarily limited to:

  • Door of store
  • Front of Place with signage
  • An image of the front/side of Place (angled) to exemplify the correct building
  • Streetside signage of the Place
  • Daylight images
  • Night or evening images, as long as the image is clear and helps the driver identify the Place

Photos should not show:

  • People's faces - any photo with a fully identifiable face should be removed, or not approved
  • Car license plates - any photo with a fully identifiable license plate should be removed, or not approved
  • Anything which allows a viewer to tie a person to a specific location
  • Any pornographic content, nudity, sexual content or simulation, etc.

Examples of Good and Bad Place Photos

Good Bad
Good place photo 1.jpg Bad place photo 1.jpg
Good place photo 2.jpg Bad place photo 2.jpg
Good place photo 3.jpg Bad place photo 3.jpg
Good place photo 4.jpg Bad place photo 4.jpg
Good place photo 5.jpg Bad place photo 5.jpg


Duplicate Places

When a user submits an update for a Place, but does not, or cannot, choose an existing Place in the app, it will show in the Waze Map Editor as a New Place. It could also happen that two users report a new Place at the same moment which results in two New Places.

At this time, there is no "merge updates" or "merge Places" functionality in the editor. You may have to manually copy new/updated information from the Place update to the existing Place. You cannot copy/move photos.

When you find a Place update which would duplicate an existing Place, or two New Place updates which are for the same place, if

  • The Place update contains more than just a photo, and
  • The Place update provides useful, updated information

Please follow these steps:

  1. Accept the update
  2. Save
  3. Copy updated valuable information from the newly created Place to the previously-existing Place
  4. Delete the Place just added from the Acceptance in step 1.

If the criteria cannot be met, then Reject the Place update.


Place update FAQs

Who can moderate places?

Users with Level 2 and higher can moderate within their editing areas.

What requires moderation?

  • For new places: every new place which is created by a level 1 editor which is untrusted requires an approval by a level 2+ editor.
  • For place updates: every update which is done for a place which is locked above the user’s level will require a moderation by a sufficiently ranked user.
  • Flagged (Reported Problem): all flags (for potentially problematic images or places) need to be moderated by a level 2+ editor.

What is a trusted user?

Once some contributions by the same user have been reviewed positively by a moderator, we consider that user trusted. He can now add new places directly without any moderation. Updates to existing places are still pending a review if these places are locked.

What kind of places should we approve?

Almost anything which represents a real place should probably be approved. If a Waze user would ever make benefit from knowing that this place exists, it’s worth it. Exceptions are places which include private user information, inappropriate content, or otherwise irrelevant.

If at least some of the details of a place are correct, you are encouraged to approve it and then edit it accordingly.

What kind of photos should we approve?

Any photo which helps the user understand what this place is like is great. Outside pictures are even better, and we have a system that will try to show the arriving user the most relevant photo from his direction of arrival, time of day, etc. Inappropriate pictures or pictures which are not related to the place should be rejected.

Please remember - rejecting both places and photos will prevent the reporting user from getting points and might even get him blocked.

Can I partially reject an update?

Currently not. If a suggestion is only partially correct, it is recommended to approve it, save, and then edit the place to correct the wrong information.

Can I move a photo from one Place to another?

No. This function is not available in the editor

Can I move or merge any data from a duplicate Place update to an existing Place?

No. You will have to manually copy over updated information.

Can a user become blocked from adding new places?

Every user (trusted or not) can become blacklisted and banned from adding places once they have tried adding a certain amount of places or updates which have been rejected. We also track places that have been flagged and removed - if we see a pattern where a certain user created many of these, he might be blacklisted.

Who gets the points for the new places created after an approval?

Users do not get points for pending places and updates - only when a moderator approved the suggestion the user gets the points for his contribution. The moderation action itself (either a rejection or an approval) grants the moderating user with an edit point.

Do we get points for creating places from the client?

We grant the exact same number of points for the same edit whether it’s done from the client or the web editor.

Advertisers

Some places can belong to one of Waze’s advertising partners. These places will be locked for community editing for the duration of the campaign, but editors can still suggest edits - the Waze ad operations team will review and consider all suggestions to these locked places.

What is the Residential setting? Private and public places

Our main goal in this project is to improve the data our users can get about public places. Since adding places is fun and can be even somewhat addictive, we figured our users might want to add private places (their home, for instance) as well. We want to provide an outlet for that, so that we can avoid having private places wrongly listed as public.

Private places will not be searchable, and we will not expose the identity of whoever created them or attached pictures to them. We will be using the pictures and exact locations to improve our house numbers database and show photos to people driving explicitly to that address.

The different attributes of a place

Most place attributes are quite self explanatory. However, here are some points to consider:

Categories

We chose about 120 categories based on what Waze users currently search for. We aimed to have them as wide as possible, and we understand there might be a lot of places without an exact suitable category. For these places, please use the categories that could contain the category they’re in.

Private / public

Public places can be turned into private places, but private places cannot be turned into public places. Use this to convert places mistakenly labeled as public into private. Private places only contain photos and an exact address, without all the other properties of a place.

Area-Point combinations

There are some situations where it will be appropriate to mix both Area and Point Places. For example, shopping centers and shopping malls where the mall itself could be considered a navigation destination, but there are also individual stores which are also valid for being marked.

A simple shopping center, when mapped in this manner, would look like this:

Wme places mall area with points.png


Combination naming

When naming Point Places which are contained within an Area Place in this way, it may be desirable to include the Area's name in the separate Point Place names. If this is desirable, name the Point Places with the specific name first, followed by a hyphen, followed by the Area name, as such:

Point Specific Name - Area General Name

For example, "Yulman Stadium - Tulane University" or "Apple Store - Lakeside Shopping Center". There are two exceptions: airport Point Places, and emergency rooms.


Multiple categories

  • A Place can be assigned to multiple categories
  • The Primary Category for a Place must be the first one you enter
  • The Primary Category is displayed in a darker shade of blue than the others
  • The Primary Category is used to determine whether to use a Point or Area for the Place


When to use Area or Point

Here is the global guidance on selecting Area or Point for Places in the Waze Map Editor.

The Primary Category for a Place is used to determine whether to use a Point or Area.

Parent Category Type Comments
Car Services Car Wash Point
Car Services Charging Station Point
Car Services Garage / Automotive Shop Point
Car Services Gas Station Area Many gas stations also have convenience stores and ATMs. Remember to use "Gas Station" as the primary category and the add any others which are relevant. Please see the Places/Gas Station article.
Car Services Parking Lot Both There are very few parking lots which should be mapped at all. Please see the Places/Parking lot article.
Transportation Airport Area Special-handling
Transportation Bridge Area
Transportation Bus Station Point
Transportation Ferry Pier Point
Transportation Junction / Interchange Area
Transportation Seaport / Marina / Harbor Area Size-dependent.
Transportation Subway Station Point
Transportation Taxi Station Point
Transportation Train Station Point
Transportation Tunnel Area
Professional and public Cemetery Area
Professional and public City Hall Point
Professional and public College / University Area
Professional and public Conventions / Event Center Area Size-dependent
Professional and public Courthouse Point
Professional and public Embassy / Consulate Area
Professional and public Factory / Industrial Both Size-dependent
Professional and public Fire Department Area
Professional and public Government Point
Professional and public Hospital / Medical Care Area ONLY Hospitals, Emergency Rooms, and places offering Urgent Medical Care should use this category. ERs encompassed in a hospital Place Area should be Points.

Clinics, and Medical offices which do not offer urgent medical care for Walk-Ins should use the Office, (and any other appropriate) category instead.

Professional and public Information Point Point
Professional and public Kindergarten Point
Professional and public Library Point
Professional and public Military Area
Professional and public Offices Both Size-dependent
Professional and public Organization or Association Point
Professional and public Police Station Area
Professional and public Prison / Correctional Facility Area
Professional and public Post Office Point
Professional and public Religious Center Point
Professional and public School Area
Shopping and services Arts & Crafts Point
Shopping and services ATM Point
Shopping and services Bank / Financial Point
Shopping and services Bookstore Point
Shopping and services Car Dealership Point Size-dependent
Shopping and services Car Rental Point
Shopping and services Convenience Store Point
Shopping and services Currency Exchange Point
Shopping and services Department Store Point
Shopping and services Electronics Point
Shopping and services Fashion and Clothing Point
Shopping and services Flowers Point
Shopping and services Furniture / Home Store Point
Shopping and services Gifts Point
Shopping and services Gym / Fitness Point
Shopping and services Hardware Store Point
Shopping and services Jewelry Point
Shopping and services Laundry / Dry Cleaning Point
Shopping and services Market Point
Shopping and services Music Store Point
Shopping and services Personal Care Point
Shopping and services Pet Store / Veterinarian Point
Shopping and services Pharmacy Point
Shopping and services Photography Point
Shopping and services Shopping Center Area
Shopping and services Sporting Goods Point
Shopping and services Supermarket / Grocery Point Standalone could be an Area, but a Point if it is part of larger shopping mall/center.
Shopping and services Swimming Pool Point
Shopping and services Toy Store Point
Shopping and services Travel Agency Point
Food and drink Bakery Point
Food and drink Bar Point
Food and drink Coffee shop Point
Food and drink Dessert Point
Food and drink Fast Food Point
Food and drink Food Court Point
Food and drink Ice Cream Point
Food and drink Restaurant Point
Culture & entertainment Art Gallery Point
Culture & entertainment Casino Area Large hotel-casinos perhaps could be Area Places.
Culture & entertainment Club Point
Culture & entertainment Game Club Point
Culture & entertainment Movie Theater Point
Culture & entertainment Museum Point
Culture & entertainment Music Venue Point
Culture & entertainment Performing Arts Venue Point
Culture & entertainment Racing Track Area
Culture & entertainment Stadium / Arena Area
Culture & entertainment Theme Park Area
Culture & entertainment Theater Point
Culture & entertainment Tourist Attraction / Historic Site Point Size-dependent
Culture & entertainment Zoo / Aquarium Area Size-dependent
Other Construction Site Area Not necessary to be mapped.
Lodging Bed & Breakfast Point
Lodging Camping / Trailer Park Area Size-dependent
Lodging Cottage / Cabin Point
Lodging Hostel Point
Lodging Hotel Point
Outdoors Beach Area
Outdoors Golf Course Area
Outdoors Park Area
Outdoors Playground Point
Outdoors Plaza Point
Outdoors Promenade Point Unsure about mapping these at all
Outdoors Scenic Lookout / Viewpoint Point
Outdoors Ski Area Area
Outdoors Sports Court Point
Natural features Farm NONE
Natural features Forest / Grove Area Only map official state/national forests, not every stand of trees.
Natural features Island Area
Natural features River / Stream Area Use only if water itself is visually obvious to drivers on nearby roads. Do not remap features already present in the built-in Waze water layer unless that layer is incomplete or inaccurate. Map only the typical extent of visible water, not adjacent open space, greenbelt, culvert, meadows, or flood plain. If the river/stream is too narrow to map conveniently with an Area Place, it should not be mapped at all.
Natural features Sea / Lake / Pond Area Use only if water itself is visually obvious to drivers on nearby roads. Do not remap features already present in the built-in Waze water layer unless that layer is incomplete or inaccurate. Map only the typical extent of visible water, not adjacent beaches or land. If the feature is too small to map conveniently with an Area Place, it should not be mapped at all.

Parking Lot

The Parking Lot Place marks a well-defined area constructed for off-street public parking, including parking structures and garages as well as at-grade lots. There are many elements that must be considered before deciding to map a parking lot. The details are covered in Places/Parking lot.