POI (Point of Interest) entity matching associates your lodging properties (submitted in your Point of Interest feed or converted from your Hotel List Feed) with Google's canonical database of places on Google Maps and the Google Knowledge Graph.
Matching ensures that your hotel inventory, real-time rates, room availability, and booking links appear accurately in the Hotel Aggregator Unit on Google Search.
What is POI entity matching?
When you submit property information, including hotel name, physical street address, geographic coordinates, phone number, and landing page URL, Google's matching engine evaluates these signals against Google's global place database.
A match establishes a link between your internal partner property identifier
(poi_id) and a canonical Google Place entity (represented by a Google Place
ID).
Why matching is critical for hotel aggregators
- Pricing: Only properties with a confirmed match will be able to link to prices provided in your Hotel Center price feed.
- Accuracy of user experience: Accurate matching ensures that a traveler searching for a specific hotel receives your exact rates and room options for that physical property, rather than an unrelated hotel.
- Map placement and geo-clustering: Exact coordinates and place matching guarantee that your properties appear at the correct map pins and neighborhood filters in search results.
Automatic matching and manual overrides
- Continuous evaluation: Matching runs automatically during each feed ingestion.
- Override persistence: When you manually match or correct a property in Actions Center, your manual override persists across recurring daily feed uploads as long as the underlying property attributes in your feed remain unchanged.
Common match failures and how to fix them
Lodging inventory presents unique matching considerations due to chain brand duplication, multi-building resort campuses, and complex street numbering. The following table describes common match failure modes and remediation steps:
| Match issue | Cause and impact | Recommended partner action |
|---|---|---|
| Inaccurate or offset coordinates | Coordinates point to a city center, are inverted (lat versus long), or truncated. | Verify that coordinates reflect the exact physical entrance in WGS84 decimal format. See the GeoCoordinates Definition. |
| Ambiguous chain names | Multi-property chains (for example, "Courtyard by Marriott") lacking city, airport, or neighborhood distinctions in the name field. | Include distinct location identifiers in the hotel name (for example, "Courtyard by Marriott London Heathrow Airport" rather than "Courtyard by Marriott"). |
| Co-located non-lodging businesses | Property address matches an on-site restaurant, day spa, casino, or retail store rather than the hotel itself. | Ensure all data provided is precisely for the hotel/lodging POI, rather than adjacent or co-located commercial establishments. |
| Missing address components or P.O. Boxes | Address is missing street number, postal code, or lists a management office. | Provide the complete physical street address where guests check in. See the PostalAddress Definition. |
| New or rebranded properties | Newly constructed hotel or recently rebranded property not yet indexed on Google Maps. | Check whether the property exists on Google Maps. If missing, contact the business owner to create or update the listing through Google Business Profile or suggest a place on Google Maps. |
| Corporate call center numbers | Central 1-800 or reservation call center numbers shared across hundreds of chain properties. | Provide the local direct phone number specific to the property front desk. |
| Multiple properties matched to the same place | Two or more poi_id records resolve to the same Google Maps place listing (DUPLICATE_MATCHED_ENTITY), blocking all colliding records from serving. |
Remove duplicate hotel entries from your feed so only one poi_id exists per property, or use the Match Fix Tool on the incorrectly matched poi_id to map it to its independent Google Maps listing. |
Monitor match status in Actions Center
You can monitor the match status of all properties using the Inventory Viewer in Actions Center.
Navigate to the Inventory Viewer
To view your property match statuses, complete the following steps:
- Sign in to Actions Center.
- Open the Inventory Viewer.
- Filter your inventory by:
- POI ID (
poi_id) or Matching Status (Yes, No)
- POI ID (
Match status definitions
- Yes (Green badge): The property is matched to a verified Google Maps place listing. When no other blocking errors are present, the property is eligible to serve in the Hotel Aggregator Unit.
- No (Red badge): The property is unmatched (
UNMATCHED_ENTITY). Google was unable to identify a high-confidence match based on feed data. Review and resolve the match using the Match Fix Tool.
Use the Match Fix Tool
The Match Fix Tool in Actions Center allows partners to inspect automated matches, choose from alternative candidate matches scored by Google, suggest a Google Maps listing URL, or unmatch incorrect places.
To access the Match Fix Tool:
- In the Inventory View, locate the property row you want to inspect or modify.
- In the Match Info column, click Edit match (or click the Matching Status badge).
- The Matcher Panel opens on the right side of the screen.
Match resolution workflow
To resolve an unmatched or misaligned property, follow this workflow:
- Identify the Property: Locate the unmatched or incorrectly matched property row in the Inventory Viewer.
- Launch Matcher Panel: Click Edit match in the Match Info column.
- Select a Resolution Path:
- Option 1 (Recommended Candidate): Select one of the Google-scored place candidates if the correct hotel is listed.
- Option 2 (Google Maps URL): Provide the full URL of the active Google Maps place listing if the property was not surfaced in the recommendations.
- Update Match Options (Optional): If you don't see the correct match in the recommended candidates, and you don't have the Google Maps URL, you can request additional potential candidates using the Manage match options section. Deselecting suggestions indicates they do not represent your property, prompting the tool to compute alternative matches.
- Save Proposal: After selecting a resolution, click Save to apply your decision.
- Persistence: Google stores the override against the property's attribute hash, persisting the decision across future feed uploads.
Suggest a match using a Google Maps URL
If the correct hotel listing does not appear in the candidate list, but the place exists on Google Maps:
- Open a new browser tab and navigate to Google Maps.
- Search for the exact hotel listing by name and physical address.
- Select the listing so its place sheet (displaying photos, rating, address, and place details) is active.
- Copy the full URL from the browser address bar.
- In the Actions Center match panel, select I will provide the URL for my business listing.
- Paste the URL into the input field.
- Click Save Proposal.
Important:
- Supported URLs:
- Full Google Maps URL starting with
https://www.google.com/maps/place/... - Maps URLs containing a canonical place CID
https://maps.google.com/?cid=...
- Full Google Maps URL starting with
- Unsupported URLs:
- Shortened URLs:
https://goo.gl/maps/... - Google Search result URLs:
https://www.google.com/search?q=...
- Shortened URLs:
Best practices for long-term match quality
To maintain high match quality and avoid data regressions:
- Synchronize data at the source: While the Actions Center Match Fix Tool allows manual overrides, always update your upstream source feed (VssPoi feed or Hotel List Feed) with the exact matching name, address, and coordinates. This practice prevents accidental regressions in future feed uploads.
- Pinpoint entrance coordinates: Verify that latitude and longitude coordinates reflect the guest check-in entrance rather than a generalized neighborhood or city centroid.
- Perform weekly match audits: Review the Inventory View weekly after feed ingestion runs to identify and resolve newly introduced unmatched properties.
- Escalate unresolved issues: If a hotel exists on Google Maps but cannot
be matched through the tool, open a support case through
Hotel Center Support
with your
poi_id, property name, full address, and the target Google Maps URL.