Die Nutzung Ihres Schlüssels überwachen, bevor Sie an ein Limit stoßen
Wenn Sie Ihre Kontingent-Header laufend beobachten, wissen Sie, wann ein Limit näher rückt, lange bevor eine Anfrage tatsächlich abgelehnt wird.
Adressen mit Wohnungs- oder Einheitsnummern geokodieren
Eine Wohnungsnummer als Zusatz zu einer Straßenadresse ist bei vielen echten Adressen ganz normal. Es lohnt sich zu verstehen, wie eine Geokodierungsabfrage damit umgeht, statt sie vor dem Senden der Anfrage zu entfernen, was eine verbreitete, aber unnötige Gewohnheit ist.
Die vollständige Adresse senden
Nehmen Sie die Wohnungs- oder Einheitsnummer als Teil der Freitextabfrage auf, genau wie jeden anderen Teil der Adresse.
GET /v1/forward?q=Apt 4B, 350 Fifth Avenue, New York&limit=1{
"status": "ok",
"query": "Apt 4B, 350 Fifth Avenue, New York",
"results": [
{
"formatted": "350 Fifth Avenue, New York, NY",
"lat": 40.7484,
"lon": -73.9857,
"type": "address",
"precision": "house",
"confidence": 0.95,
"place_id": "es234",
"components": {"house_number": "350", "street": "Fifth Avenue", "city": "New York", "region": "NY", "country": "US"}
}
]
}Warum die Einheitsnummer nicht in den Koordinaten erscheint
Koordinaten aus einer Geokodierungsabfrage bezeichnen ein Gebäude und keine bestimmte Einheit darin, da einzelne Wohnungen keinen eigenen, separat kartierten Standort haben, wie es bei einem Gebäude der Fall ist. Vom Wohnungs- oder Einheitsteil einer Adresse wird nicht erwartet, dass er die Werte lat und lon verändert, und auch sein Fehlen im Objekt components ist zu erwarten und kein Zeichen dafür, dass die Eingabe ignoriert oder falsch verarbeitet wurde.
Ein zweites Beispiel: eine Büronummer in einem Geschäftsgebäude
Dasselbe Muster gilt für eine Geschäftsadresse mit Büro- oder Etagennummer.
GET /v1/forward?q=Suite 200, 1 Example Plaza, Chicago&limit=1Ein großes Bürogebäude mit Dutzenden separater Unternehmen wird trotzdem zu einem einzigen Satz Gebäudekoordinaten geokodiert, unabhängig davon, welches Büro in der Abfrage genannt wird, genau wie ein Wohnhaus. Alles, was einen Mieter in diesem Gebäude von einem anderen unterscheidet, gehört in Ihre eigenen Datensätze, nicht in die Koordinaten.
Ein häufiger Fehler, den Sie vermeiden sollten
Versuchen Sie nicht, den fehlenden Einheitsbestandteil zu umgehen, indem Sie ihn nachträglich selbst an die Postleitzahl oder ein anderes Bestandteilfeld anhängen, etwa indem Sie eine Postleitzahl als „20500 Apt 4B“ schreiben. Damit verfälschen Sie ein Feld, von dem andere Systeme, einschließlich Ihrer eigenen Validierung und aller nachgelagerten Adressabfragen, erwarten, dass es nur eine echte Postleitzahl enthält. Halten Sie die Einheitsnummer in einem eigenen Feld, vollständig getrennt von allen geokodierten Bestandteilen.
Die Einheitsnummer separat speichern
Statt die Einheitsnummer jedes Mal in die zu geokodierende Adresszeichenkette einzubauen, speichern Sie sie als eigenes Feld in Ihrem eigenen Datenmodell neben der geokodierten Gebäudeadresse. So bleibt die Geokodierungsanfrage auf das konzentriert, was das Ergebnis tatsächlich beeinflusst, nämlich den Standort des Gebäudes, während die Einheitsinformation für Versandetiketten oder interne Datensätze erhalten bleibt.
Wann es für die Zustellung zählt
Ein Kurier- oder Postdienst braucht die Einheitsnummer für die eigentliche Zustellung, auch wenn sie bei den Koordinaten keine Rolle gespielt hat. Führen Sie beide Teile, die geokodierten Gebäudekoordinaten und die separat gespeicherte Einheitsnummer, im endgültigen Zustelldatensatz zusammen, damit dabei nichts verloren geht.
Ein Sonderfall, den Sie kennen sollten
Unter einer einzigen Gebäudeadresse können sehr viele separate Bewohner oder Mieter wohnen, die alle dieselben Koordinaten und dasselbe Ergebnis der Postleitzahl-Abfrage teilen. Wenn Sie die Postleitzahl eines Kunden mit einer geokodierten Adresse abgleichen, wie im Leitfaden zum Abgleich von Postleitzahlen beschrieben, denken Sie daran, dass diese Viele-zu-eins-Beziehung zwischen Einheiten und Gebäude zu erwarten ist und für sich kein Zeichen für ein Datenproblem darstellt.
Die Kosten bleiben unberührt
Ob eine Adresse eine Wohnungs- oder Einheitsnummer enthält oder nicht, die Abfrage kostet immer eine Anfrage, genau wie jeder andere Geokodierungsaufruf.
Eine Einheitsnummer in der Abfrage schadet nicht, und sie zu entfernen ist für eine genaue Geokodierung nicht nötig, auch wenn es Ihre Daten sauberer hält, sie danach in einem eigenen gespeicherten Feld abzulegen. Die vollständige Liste der Bestandteile finden Sie in der Dokumentation zur Geokodierung.