Google Maps Spend

info

This returns the spend rate for a card based on the Google Maps business name or category name

HTTP REQUEST

GET /creditcard-spend-googlemaps/{cardKey}/{googleMapsBusinessName}/{googleMapsCategoryName}

RESPONSE

[
  {
    "cardKey": "amex-hilton",
    "cardName": "Hilton Honors",
    "cardIssuer": "American Express",
    "earnRate": 5.0,
    "isBonusRate": 1,
    "baseSpendAmount": 3.0,
    "baseSpendEarnType": "Hilton Honors",
    "baseSpendEarnCurrency": "points",
    "googleMapsBusinessName": "Town & Country Market Shoreline",
    "googleMapsCategoryName": "Grocery store"
  }
]

Response Attributes

NAME	TYPE	DESCRIPTION
cardKey	string	Rewards Credit Card API unique card key
cardName	string	Name of credit card
cardIssuer	string	Issuing bank
earnRate	number	Points earned per dollar spend
isBonusRate	bit	Is the rate higher than the base rate? (0=no, 1=yes)
baseSpendAmount	number	Base points earned per dollar spend
baseSpendEarnType	string	Redemption program (e.g. American AAdvantage)
baseSpendEarnCurrency	string	Spend earning currenty type (rewards, miles, cashback, crypto, points)
googleMapsBusinessName	string	Google Maps business name
googleMapsCategoryName	string	Google Maps category/primaryType

Notes

• earnRate is approximate and can very from bank to bank as well as how the business is cateogorized

Path Parameters

NAME	TYPE	DESCRIPTION	REQUIRED
cardKey	string	unique Rewards CC key ID	Yes
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 +)
• All three parameters are required
• In the image below the parameter values
  • cardKey: amex-hilton
  • 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