Google Maps Top Cards

info

This returns the top ten cards for a location based on the Google Maps business name or category name

HTTP REQUEST

GET /creditcard-spend-googlemaps-top-cards/{googleMapsBusinessName}/{googleMapsCategoryName}

RESPONSE

[
  {
    "cardKey": "amex-hiltonaspire",
    "cardName": "Hilton Honors American Express Aspire",
    "cardIssuer": "American Express",
    "spendType": "Hilton Honors",
    "earnMultiplier": 14.0,
    "earnMultiplierValue": 7.0,
    "spendBonusDesc": "14X points for eligible purchases at hotels and resorts in the Hilton portfolio",
    "limitBeginDate": "",
    "limitEndDate": "",
    "isSpendLimit": 0,
    "spendLimit": 0.0,
    "spendLimitResetPeriod": ""
  },
  {
    "cardKey": "amex-biz-hilton",
    "cardName": "Hilton Honors Business",
    "cardIssuer": "American Express",
    "spendType": "Hilton Honors",
    "earnMultiplier": 12.0,
    "earnMultiplierValue": 6.0,
    "spendBonusDesc": "12X points per dollar for purchases made directly with hotels and resorts in the Hilton portfolio",
    "limitBeginDate": "",
    "limitEndDate": "",
    "isSpendLimit": 0,
    "spendLimit": 0.0,
    "spendLimitResetPeriod": ""
  },
  {
    "cardKey": "amex-hiltonsurpass",
    "cardName": "Hilton Honors American Express Surpass®",
    "cardIssuer": "American Express",
    "spendType": "Hilton Honors",
    "earnMultiplier": 12.0,
    "earnMultiplierValue": 6.0,
    "spendBonusDesc": "12X points for eligible purchases at hotels and resorts in the Hilton portfolio",
    "limitBeginDate": "",
    "limitEndDate": "",
    "isSpendLimit": 0,
    "spendLimit": 0.0,
    "spendLimitResetPeriod": ""
  },
  {
    "cardKey": "chase-freedomflex",
    "cardName": "Chase Freedom Flex®",
    "cardIssuer": "Chase",
    "spendType": "Cash",
    "earnMultiplier": 5.0,
    "earnMultiplierValue": 5.0,
    "spendBonusDesc": "Earn 5% on Hotels",
    "limitBeginDate": "2024-04-01",
    "limitEndDate": "2024-06-30",
    "isSpendLimit": 1,
    "spendLimit": 1500.0,
    "spendLimitResetPeriod": "Quarter"
  },
  {
    "cardKey": "greenstatecu-world",
    "cardName": "GreenState Credit Union World Mastercard",
    "cardIssuer": "GreenState Credit Union",
    "spendType": "GreenState Rewards",
    "earnMultiplier": 5.0,
    "earnMultiplierValue": 5.0,
    "spendBonusDesc": "5x points on hotels",
    "limitBeginDate": "",
    "limitEndDate": "",
    "isSpendLimit": 0,
    "spendLimit": 0.0,
    "spendLimitResetPeriod": ""
  }
]

Response Attributes

NAME	TYPE	DESCRIPTION
cardKey	string	Rewards Credit Card API unique card key
cardName	string	Name of credit card
cardIssuer	string	Issuing bank
spendType	string	Redemption program (e.g. American AAdvantage)
earnMultiplier	number	Points/miles per dollar
earnMultiplierValue	number	Points/miles per dollar valuation
limitBeginDate	date	Date spend bonus begins
limitEndDate	date	Date spend bonus ends
isSpendLimit	bit	Is there a spend limit? (0=no, 1=yes)
spendLimit	number	Spent limit amount if applies
spendLimitResetPeriod	string	If spend limit when the limit is reset (eg. Year)

Notes

• Returns top ten cards based on earnMultiplierValue
• earnMultiplierValue is an approximate calculated based on the point valuation
  • A card earns 12 Hilton Honors per dollar. Hilton Honors are valued at .5 cents each - earnMultiplierValue would return a value of 6 (.5 * 12)

Path Parameters

NAME	TYPE	DESCRIPTION	REQUIRED
businessName	string	Google Maps business name	Yes
categoryName	string	Google Maps category/primaryType	Yes

Notes

• businessName and categoryName must be URL encoded
  • Reference here: https://www.w3schools.com/tags/ref_urlencode.ASP
  • For spaces use %20 (not +)
• Both parameters are required
• In the image below the parameter values
  • businessName: Town%20%26%20Country%20Market%20Shoreline
  • categoryName: Grocery%20store

Google Maps Business Page

Google Maps API

• Refer to the Place Details API endpoint and the Place ID identifier

• Example: https://places.googleapis.com/v1/places/ChIJw7F5Gd8QkFQRFFAvvucJr94?fields=id,displayName&key=API_KEY

• Use value in primaryTypeDisplayName / text

RESPONSE

[
  {
  "id": "ChIJw7F5Gd8QkFQRFFAvvucJr94",
  "displayName": {
    "text": "Town & Country Market Shoreline",
    "languageCode": "en"
  },
  "primaryTypeDisplayName": {
    "text": "Grocery Store",
    "languageCode": "en-US"
  }
  }
]

Data Source(s)

Bank websites, Google Maps